ChartSerializer 類別

定義

命名空間:

System.Windows.Forms.DataVisualization.Charting

組件:

System.Windows.Forms.DataVisualization.dll

讓 Chart 控制項能夠序列化。

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

繼承

Object

ChartSerializer

備註

這個類別會公開為 Serializer 根 Chart 類別的 屬性。

序列化會儲存圖表的狀態，並提供將序列化資料載入圖表的選項。 所有圖表屬性都可以保存，包括圖表的資料。 此外，可以重設標示為序列化的所有圖表屬性。

管理使用者定義檢視狀態時，可以選擇性地使用此類別。 其中 Load 一種方法可用來載入檢視狀態，而其中一個 Save 方法可以在設定檢視狀態時使用。

XML 或二進位格式可用來儲存序列化的資料。 XML 預設會使用，但您可以使用 屬性來變更格式 Format 。

圖表屬性會分別使用 Save 和 Load 方法來儲存和載入。 請注意，只會儲存具有非預設值的屬性。 資料可以使用檔案、資料流程、 TextWriter 、 TextReaderXmlWriter 和 XmlReader 物件來儲存和/或載入。 使用衍生自 TextReader 、 TextWriterXmlReader 或 類別的物件儲存和/或 XmlWriter 載入資料時，資料的格式必須是 XML。

下列清單描述三種技術，從基本到進階，用來定義可序列化的資料。 請注意，您也可以定義不可序列化的資料。 下一個段落會說明這項技術。

• 使用 Save 和 Load 方法序列化 Chart ，而不指定任何可序列化的屬性。 包含圖表資料的非預設值的所有圖表屬性都會序列化。

• 序列化 屬性所 Content 指定的圖表屬性。 屬性會將 Content 要序列化的圖表屬性分組成資料、外觀等類別。 請注意，和 Series 物件的名稱 ChartArea 會自動序列化;然後，序列化的資料會在載入時套用至現有的圖表區域和數列。

重要

屬性 Content 是由 控制項在內部實 Chart 作，做為 SerializableContent 屬性

• 屬性所 SerializableContent 指定的圖表屬性序列化。 這是可序列化之所有圖表屬性的逗號分隔清單。 將此屬性設定為明確值之後，開發人員必須負責指定要儲存的所有屬性。 換句話說，不同于 Content 屬性，不會自動儲存圖表區域和數列的名稱。 Content和 SerializableContent 屬性也可以搭配使用。 不過，請確定 SerializableContent 在設定時與本身串連，否則會覆寫 屬性所 Content 指定的圖表屬性。

若要禁止序列化特定屬性，請使用 NonSerializableContent 屬性。 當一個屬性設定為可序列化且不可序列化時，使用萬用字元時很常見時， SerializableContent 屬性具有優先順序。 不過，優先順序也取決於指定屬性時使用多少萬用字元。

根據預設，可序列化屬性會在載入之前重設為預設值。 您可以使用 屬性來變更 IsResetWhenLoading 此行為。 方法 Reset 也可以用來明確地將圖表屬性重設為預設值。

屬性

Content	取得或設定要序列化之圖表內容的類型。
Format	取得或設定序列化圖表時使用的格式。
IsResetWhenLoading	取得或設定旗標，這個旗標表示物件屬性是否會在載入之前重設為預設值。
IsTemplateMode	取得或設定旗標，這個旗標表示圖表序列化程式是否在範本建立模式中運作。
IsUnknownAttributeIgnored	取得或設定旗標，這個旗標表示是否會忽略未知的 XML 屬性和項目，而不擲回例外狀況。
NonSerializableContent	取得或設定不會序列化的圖表屬性。
SerializableContent	取得或設定可以序列化的圖表屬性。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetContentString(SerializationContents, Boolean)	根據特定的旗標值，傳回可序列化或不可序列化的類別和 (或) 屬性名稱。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
Load(Stream)	從衍生自 Stream 類別的物件，將序列化資料載入控制項中。
Load(String)	將已儲存至磁碟的序列化資料載入 Chart 控制項中。
Load(TextReader)	從衍生自 TextReader 類別的讀取器物件，將序列化資料載入控制項中。
Load(XmlReader)	從衍生自 XmlReader 類別的物件，將序列化資料載入控制項中。
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Reset()	重設所有標記為即將序列化的圖表屬性。
Save(Stream)	將具有非預設值的圖表資料和屬性儲存至衍生自 Stream 類別的物件。
Save(String)	將具有非預設值的圖表資料和屬性儲存至指定的檔案。
Save(TextWriter)	將具有非預設值的圖表資料和屬性儲存至衍生自 TextWriter 類別的指定物件。
Save(XmlWriter)	將具有非預設值的圖表資料和屬性儲存至衍生自 XmlWriter 類別的指定物件。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)