ChartSerializer.SerializableContent 屬性

定義

命名空間:

System.Windows.Forms.DataVisualization.Charting

組件:

System.Windows.Forms.DataVisualization.dll

取得或設定可序列化的圖表屬性。

public:
 property System::String ^ SerializableContent { System::String ^ get(); void set(System::String ^ value); };

public string SerializableContent { get; set; }

member this.SerializableContent : string with get, set

Public Property SerializableContent As String

屬性值

String

一個逗號分隔 string 的表達式，代表要序列化的圖表屬性。 語法為「Class.Property[，Class.Property]」。

備註

預設情況下，當 Save 呼叫 and Load 方法時，所有圖表屬性都會被序列化。 你可以利用這個 NonSerializableContent 屬性來限制圖表特徵要序列化，還有 SerializableContent 和 Content 屬性。

屬性決定 SerializableContent 哪些圖表特徵將被序列化。 萬用字元可用於字串表達式，方式與屬性 NonSerializableContent 相同。 例如，要序列化所有圖表 BackColor 屬性，請將此屬性設為「*」。BackColor」。

如果ChartArea指定了 和/或Series子屬性，則所有 和 Series 物件的ChartArea名稱也必須指定，才能讓持久化的資料套用到現有ChartArea的 和 Series 物件上;也就是說，你必須指定「Series.Name」和「ChartArea.Name」表達式。 請參考下方範例程式碼，了解此程序的範例。 同樣地，若使用多個圖表區域， ChartArea 也必須保存所有繪圖 Series 區域的性質。

有時，屬性可以同時設定為序列化與非序列化，這在使用萬用字元時很常見。 NonSerializableContent與表達SerializableContent式相比，該表達式的優先權較低。 然而，請注意，使用萬用字元的字串表達式權重較低。 例如，若屬性SerializableContent設定為「*。BackColor」，且NonSerializableContent屬性設為 BackColor，除了物件外ChartArea，所有 BackColor 屬性都會被序列化。

如果你設定了 Content 屬性，屬性 SerializableContent 也會在內部設定。 如果該 Content 屬性已經設定好，但需要序列化另一個屬性，請在指定該額外屬性時將該 SerializableContent 屬性串接起來。 請參考下方範例程式碼，了解此程序的範例。

此特性影響所有儲存、載入與重置操作。