ChartSerializer クラス

定義

名前空間:

System.Web.UI.DataVisualization.Charting

アセンブリ:

System.Web.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 変更できます。

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

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

• シリアル化可能なプロパティをChartSave指定せずに、 メソッドと 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)