ChartSerializer.Save 方法

定義

命名空間:

System.Web.UI.DataVisualization.Charting

組件:

System.Web.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 和 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 、 SerializableContent 和 NonSerializableContent 屬性。

當您使用此定義時，格式必須是 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 方法可以用來載入範本，以提供圖表的外觀屬性。

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