ChartSerializer.Save 方法

定義

命名空間:

System.Windows.Forms.DataVisualization.Charting

組件:

System.Windows.Forms.DataVisualization.dll

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

多載

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 使用 SerializableContent 和 NonSerializableContent 屬性。

當您使用此定義時，格式必須是 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 使用 SerializableContent 和 NonSerializableContent 屬性。

如果使用此方法將外觀屬性儲存為範本，請確定 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 使用 SerializableContent 和 NonSerializableContent 屬性。

當您使用此定義時，格式必須是 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 ，請使用、 SerializableContent 和 NonSerializableContent 屬性。

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

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

如果使用此方法將外觀屬性儲存為範本，請確定在 IsTemplateMode true 呼叫這個方法之前，先將屬性設定為。

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

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

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