Share via


ChartSerializer.Save 方法

定義

儲存具有非預設值的圖表屬性。 所有圖表屬性都能序列化,包括資料。

多載

Save(XmlWriter)

將具有非預設值的圖表資料和屬性儲存至衍生自 XmlWriter 類別的指定物件。

Save(Stream)

將具有非預設值的圖表資料和屬性儲存至衍生自 Stream 類別的物件。

Save(TextWriter)

將具有非預設值的圖表資料和屬性儲存至衍生自 TextWriter 類別的指定物件。

Save(String)

將具有非預設值的圖表資料和屬性儲存至指定的檔案。

Save(XmlWriter)

將具有非預設值的圖表資料和屬性儲存至衍生自 XmlWriter 類別的指定物件。

public:
 void Save(System::Xml::XmlWriter ^ writer);
public void Save (System.Xml.XmlWriter writer);
member this.Save : System.Xml.XmlWriter -> unit
Public Sub Save (writer As XmlWriter)

參數

writer
XmlWriter

衍生自 XmlWriter 且用來儲存 Chart 屬性的物件。

備註

根據預設,呼叫此方法時,所有包含資料點的非預設值圖表屬性都會序列化。 若要控制哪些圖表特性已序列化,請使用 ContentSerializableContentNonSerializableContent 屬性。

當您使用此定義時,格式必須是 XML;您可以使用 屬性來變更 Format 格式。

當您使用 XML 格式文字檔時,為了簡單起見,請 Save 改用 方法。

適用於

Save(Stream)

將具有非預設值的圖表資料和屬性儲存至衍生自 Stream 類別的物件。

public:
 void Save(System::IO::Stream ^ stream);
public void Save (System.IO.Stream stream);
member this.Save : System.IO.Stream -> unit
Public Sub Save (stream As Stream)

參數

stream
Stream

衍生自 Stream 類別且用來儲存圖表屬性的物件,例如 MemoryStream

備註

根據預設,呼叫此方法時,所有包含資料點的非預設值圖表屬性都會序列化。 若要控制要序列化的圖表特性,請使用 ContentSerializableContentNonSerializableContent 屬性。

如果使用這個方法將外觀屬性儲存為範本,請確定 IsTemplateMode 物件的 屬性 ChartSerializer 會先設定 true 為 ,然後再呼叫這個方法。

圖表序列化為範本的方式與非範本序列化不同;範本序列化著重于外觀屬性。

當範本序列化時, LoadTemplate 方法可以用來載入範本,以提供圖表的外觀屬性。

範本可用來模擬自訂調色盤。

適用於

Save(TextWriter)

將具有非預設值的圖表資料和屬性儲存至衍生自 TextWriter 類別的指定物件。

public:
 void Save(System::IO::TextWriter ^ writer);
public void Save (System.IO.TextWriter writer);
member this.Save : System.IO.TextWriter -> unit
Public Sub Save (writer As TextWriter)

參數

writer
TextWriter

衍生自 TextWriter 類別且用來儲存圖表屬性的物件,例如 StringWriter

備註

根據預設,呼叫此方法時,所有包含資料點的非預設值圖表屬性都會序列化。 若要控制哪些圖表特性已序列化,請使用 ContentSerializableContentNonSerializableContent 屬性。

當您使用此定義時,格式必須是 XML;可以使用 屬性來設定 Format 格式。

ViewStateData如果控制項的 Chart 屬性是用來保存狀態,這個方法可用來將序列化資料儲存至衍生自 TextWriter 的物件,然後用來將資料寫入 ViewStateData 屬性。

適用於

Save(String)

將具有非預設值的圖表資料和屬性儲存至指定的檔案。

public:
 void Save(System::String ^ fileName);
public void Save (string fileName);
member this.Save : string -> unit
Public Sub Save (fileName As String)

參數

fileName
String

用於儲存序列化資料之檔案的相對或絕對路徑。 請注意,如果指定相對路徑,此路徑將相對於目前的目錄。

備註

根據預設,所有包含資料點的非預設值圖表屬性,都會在呼叫此方法時序列化。 若要控制要序列化的圖表特性, Content 請使用 和 SerializableContentNonSerializableContent 屬性。

根據預設,資料會以 XML 格式儲存。 若要以二進位格式儲存資料,請使用 Format 屬性。

請注意,必須針對儲存檔案的目錄啟用寫入權限。 根據預設,這是應用程式的 Bin 資料夾。

如果使用這個方法將 Appearance 屬性儲存為範本,請先確定屬性 IsTemplateMode 已設定 true 為 ,然後再呼叫這個方法。

以範本方式序列化圖表的方式與非範本序列化不同,主要是因為範本序列化著重于外觀屬性。

當範本序列化時, LoadTemplate 方法可以用來載入範本,以提供圖表的外觀屬性。

範本可用來模擬自訂調色盤。

適用於