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使用すると、シリアル化するグラフの特性を および プロパティとContent共にSerializableContent制限できます。

プロパティは SerializableContent 、シリアル化するグラフの特性を決定します。 ワイルドカードは、 プロパティと同じ方法 NonSerializableContent で文字列式で使用できます。 たとえば、すべてのグラフ BackColor プロパティをシリアル化するには、このプロパティを "* に設定します。BackColor"

子プロパティや Series 子プロパティを指定する場合ChartAreaは、永続化されたデータを既存ChartAreaの オブジェクトと オブジェクトに適用できるようにするには、すべての ChartArea オブジェクトと SeriesSeries オブジェクトの名前も指定する必要があります。つまり、"Series.Name" 式と "ChartArea.Name" 式を指定する必要があります。 この手順の例については、以下のサンプル コードを参照してください。 同様に、複数のグラフ領域を使用している場合は、 ChartArea プロット Series されたすべての プロパティも保存する必要があります。

場合によっては、プロパティをシリアル化とシリアル化の両方に設定できます。これは、ワイルドカードを使用する場合に一般的です。 NonSerializableContent式と比較SerializableContentすると、式の優先度が低くなります。 ただし、ワイルドカードを使用する文字列式には、より少ない重みが与えられます。 たとえば、 プロパティが SerializableContent "*" に設定されている場合です。BackColor" と プロパティNonSerializableContentが にBackColor設定されている場合、オブジェクトをChartArea除くすべての BackColor プロパティがシリアル化されます。

プロパティを設定すると Content 、 プロパティが SerializableContent 内部的に設定されます。 プロパティが既に Content 設定されていても、別のプロパティをシリアル化する必要がある場合は、その追加のプロパティを SerializableContent 指定するときに、必ずプロパティを連結してください。 この手順の例については、以下のサンプル コードを参照してください。

このプロパティは、すべての保存、読み込み、リセット操作に影響します。