ChartSerializer.Save 方法

定義

命名空間:

System.Windows.Forms.DataVisualization.Charting

組件:

System.Windows.Forms.DataVisualization.dll

儲存非預設值的圖表屬性。 所有圖表屬性都可以序列化;這也包括數據。

多載

名稱	Description
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 屬性。

備註

預設情況下，所有包含資料點的圖表屬性（包含資料點）在呼叫時都會被序列化。 要控制哪些圖表特徵被序列化，請使用 Content、和 SerializableContentNonSerializableContent 屬性。

使用此定義時，格式必須為 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，用於儲存圖表屬性。

備註

預設情況下，所有包含資料點的圖表屬性（包含資料點）在呼叫時都會被序列化。 要控制圖表特徵要序列化，請使用 Content、和 SerializableContentNonSerializableContent 屬性。

如果用這個方法來儲存外觀屬性作為範本，請先將 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用來儲存圖表屬性。

備註

預設情況下，所有包含資料點的圖表屬性（包含資料點）在呼叫時都會被序列化。 要控制哪些圖表特徵被序列化，請使用 Content、和 SerializableContentNonSerializableContent 屬性。

使用此定義時，格式必須為 XML;格式可以用屬性 Format 設定。

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 方法載入範本，提供圖表的外觀屬性。

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