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]"。

備註

呼叫 和 Load 方法時 Save ，預設會序列化所有圖表屬性。 您可以使用 NonSerializableContent 屬性來限制要序列化的圖表特性，以及 SerializableContent 和 Content 屬性。

屬性 SerializableContent 會決定要序列化的圖表特性。 萬用字元可以與 屬性相同的方式 NonSerializableContent ，用於字串運算式中。 例如，若要序列化所有圖表 BackColor 屬性，請將此屬性設定為 「*。BackColor」。

如果 ChartArea 指定 和/或 Series 子屬性，則必須同時指定所有 ChartArea 和 Series 物件的名稱，才能將保存的資料套用至現有的 ChartArea 和 Series 物件;也就是說，您必須指定 「Series.Name」 和 「ChartArea.Name」 運算式。 如需此程式的範例，請參閱下面的範例程式碼。 同樣地，如果使用多個圖表區域， ChartArea 也必須儲存所有繪製 Series 的 屬性。

有時候，屬性可以設定為序列化且未序列化，這在使用萬用字元時很常見。 相較于 SerializableContent 運算式，運算式 NonSerializableContent 的優先順序較低。 不過，請注意，使用萬用字元的字串運算式會提供較少的加權。 例如，如果 SerializableContent 屬性設定為 「*。BackColor「 和 NonSerializableContent 屬性設定為 BackColor ，除了 物件以外的所有 B ackColor 屬性 ChartArea 都會序列化。

如果您設定 Content 屬性， SerializableContent 屬性將會在內部設定。 Content如果屬性已經設定，但需要序列化另一個屬性，請務必在指定該額外屬性時串連 SerializableContent 屬性。 如需此程式的範例，請參閱下面的範例程式碼。

此屬性會影響所有儲存、載入和重設作業。