ChartSerializer.Save メソッド

定義

名前空間:

System.Windows.Forms.DataVisualization.Charting

アセンブリ:

System.Windows.Forms.DataVisualization.dll

既定値以外のグラフ プロパティを保存します。 すべてのグラフ プロパティをシリアル化できます。これにはデータが含まれます。

オーバーロード

名前	説明
Save(XmlWriter)	既定値以外の値を持つグラフ データとプロパティを、 XmlWriter クラスから派生した特定のオブジェクトに保存します。
Save(Stream)	既定値以外の値を持つグラフ データとプロパティを、 Stream クラスから派生したオブジェクトに保存します。
Save(TextWriter)	既定値以外の値を持つグラフ データとプロパティを、 TextWriter クラスから派生した特定のオブジェクトに保存します。
Save(String)	既定値以外のグラフ データとプロパティを指定されたファイルに保存します。

Save(XmlWriter)

既定値以外の値を持つグラフ データとプロパティを、 XmlWriter クラスから派生した特定のオブジェクトに保存します。

public:
 void Save(System::Xml::XmlWriter ^ writer);

public void Save(System.Xml.XmlWriter writer);

member this.Save : System.Xml.XmlWriter -> unit

Public Sub Save (writer As XmlWriter)

パラメーター

writer

XmlWriter

XmlWriterから派生したオブジェクトChartプロパティを保存するために使用されます。

注釈

既定では、データ ポイントを含む既定値以外の値を持つすべてのグラフ プロパティは、このメソッドの呼び出し時にシリアル化されます。 シリアル化するグラフ特性を制御するには、 Content、 SerializableContent 、および NonSerializableContent プロパティを使用します。

この定義を使用する場合、形式は XML である必要があります。形式は、 Format プロパティを使用して変更できます。

XML 形式のテキスト ファイルを使用する場合は、わかりやすくするために、代わりに Save メソッドを使用します。

Save(Stream)

既定値以外の値を持つグラフ データとプロパティを、 Stream クラスから派生したオブジェクトに保存します。

public:
 void Save(System::IO::Stream ^ stream);

public void Save(System.IO.Stream stream);

member this.Save : System.IO.Stream -> unit

Public Sub Save (stream As Stream)

パラメーター

stream

Stream

グラフのプロパティを保存するために使用される Stream クラスから派生したオブジェクト ( MemoryStream など)。

注釈

既定では、データ ポイントを含む既定値以外の値を持つすべてのグラフ プロパティは、このメソッドの呼び出し時にシリアル化されます。 シリアル化するグラフの特性を制御するには、 Content、 SerializableContent 、および NonSerializableContent プロパティを使用します。

このメソッドを使用して外観プロパティをテンプレートとして保存する場合は、このメソッドを呼び出す前に、ChartSerializer オブジェクトの IsTemplateMode プロパティが最初にtrueに設定されていることを確認します。

テンプレートとしてのグラフのシリアル化は、テンプレート以外のシリアル化とは異なります。テンプレートのシリアル化は、外観プロパティに重点を置いています。

テンプレートをシリアル化すると、 LoadTemplate メソッドを使用してテンプレートを読み込み、グラフの Appearance プロパティを指定できます。

テンプレートを使用して、カスタム パレットをシミュレートできます。

Save(TextWriter)

既定値以外の値を持つグラフ データとプロパティを、 TextWriter クラスから派生した特定のオブジェクトに保存します。

public:
 void Save(System::IO::TextWriter ^ writer);

public void Save(System.IO.TextWriter writer);

member this.Save : System.IO.TextWriter -> unit

Public Sub Save (writer As TextWriter)

パラメーター

writer

TextWriter

グラフのプロパティの保存に使用TextWriterStringWriterなどのクラスから派生したオブジェクト。

注釈

既定では、データ ポイントを含む既定値以外の値を持つすべてのグラフ プロパティは、このメソッドの呼び出し時にシリアル化されます。 シリアル化するグラフ特性を制御するには、 Content、 SerializableContent 、および NonSerializableContent プロパティを使用します。

この定義を使用する場合、形式は XML である必要があります。形式は、 Format プロパティで設定できます。

Save(String)

既定値以外のグラフ データとプロパティを指定されたファイルに保存します。

public:
 void Save(System::String ^ fileName);

public void Save(string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

パラメーター

fileName

String

シリアル化されたデータの格納に使用されるファイルの相対パスまたは絶対パス。 相対パスが指定されている場合、パスは現在のディレクトリからの相対パスになります。

注釈

既定では、データ ポイントを含む既定値以外の値を持つすべてのグラフ プロパティは、このメソッドの呼び出し時にシリアル化されます。 シリアル化するグラフの特性を制御するには、 Content、 SerializableContent 、および NonSerializableContent プロパティを使用します。

既定では、データは XML 形式で保存されます。 データをバイナリ形式で保存するには、 Format プロパティを使用します。

ファイルが格納されているディレクトリに対して書き込みアクセス許可を有効にする必要があることに注意してください。 既定では、これはアプリケーションの Bin フォルダーです。

このメソッドを使用して Appearance プロパティをテンプレートとして保存する場合は、このメソッドを呼び出す前に、 IsTemplateMode プロパティが最初に true に設定されていることを確認してください。

テンプレートとしてのグラフのシリアル化は、テンプレート以外のシリアル化とは異なります。これは、主にテンプレートのシリアル化が外観プロパティに集中するためです。

テンプレートをシリアル化すると、 LoadTemplate メソッドを使用してテンプレートを読み込み、グラフの Appearance プロパティを指定できます。

テンプレートを使用して、カスタム パレットをシミュレートできます。