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

注釈

このクラスは、ルート Chart クラスの Serializer プロパティとして公開されます。

シリアル化により、グラフの状態が保存され、シリアル化されたデータをグラフに読み込むオプションも提供されます。 グラフのデータを含め、すべてのグラフ プロパティを保持できます。 また、シリアル化用にマークされたすべてのグラフ プロパティをリセットできます。

このクラスは、必要に応じて、ユーザー定義ビューステートを管理するときに使用できます。 その Load メソッドの 1 つを使用してビューステートを読み込み、ビューステートを Save 設定するときにいずれかのメソッドを使用できます。

XML 形式またはバイナリ形式を使用して、シリアル化されたデータを格納できます。 XML は既定で使用されますが、 プロパティを使用して形式を Format 変更できます。

グラフのプロパティはそれぞれ および メソッドをSaveLoad使用して保存および読み込まれます。 既定値以外のプロパティのみが保存されることに注意してください。 データは、ファイル、ストリームTextWriterTextReaderXmlWriter、および XmlReader オブジェクトを使用して保存または読み込むことができます。 、、または XmlWriter クラスから派生したオブジェクトを使用してデータを XmlReaderTextReaderTextWriter保存または読み込む場合、データの形式は XML である必要があります。

次の一覧では、シリアル化可能なデータを定義するために使用される基本的なものから高度なものまで、3 つの手法について説明します。 シリアル化不可能なデータを定義することもできます。 この手法については、次の段落で説明します。

• Chartシリアル化可能なプロパティをSave指定せずに、 メソッドと Load メソッドを使用して をシリアル化します。 既定以外の値 (グラフ データを含む) を持つすべてのグラフ プロパティがシリアル化されます。

• プロパティで指定されたグラフ プロパティを Content シリアル化します。 プロパティは Content 、シリアル化するグラフ プロパティを、データ、外観などのカテゴリにグループ化します。 オブジェクトと Series オブジェクトのChartArea名前は自動的にシリアル化されます。シリアル化されたデータは、読み込まれるときに既存のグラフ領域と系列に適用されます。

重要

プロパティは Content 、 プロパティとしてコントロールによって Chart 内部的に SerializableContent 実装されます。

• プロパティで指定されたグラフ プロパティの SerializableContent シリアル化。 これは、シリアル化可能なすべてのグラフ プロパティのコンマ区切りの一覧です。 このプロパティを明示的な値に設定した後は、開発者が保存するすべてのプロパティを指定する必要があります。 つまり、 プロパティとは異なり Content 、グラフ領域と系列の名前は自動的に保持されません。 Contentプロパティと SerializableContent プロパティを組み合わせて使用することもできます。 ただし、 が SerializableContent 設定されている場合は、 がそれ自体と連結されていることを確認してください。それ以外の場合は、 プロパティで Content 指定されたグラフ プロパティがオーバーライドされます。

特定のプロパティのシリアル化を禁止するには、 プロパティを使用します NonSerializableContent 。 1 つのプロパティがシリアル化可能および非シリアル化可能として設定されている場合(ワイルドカードを使用する場合に一般的です)、 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)