ChartSerializer.Save Methode

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Speichert Diagrammeigenschaften, deren Werte vom Standard abweichen. Alle Diagrammeigenschaften, u. a. Daten, können serialisiert werden.

Überlädt

Save(XmlWriter)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der XmlWriter-Klasse abgeleitet wurde.
Save(Stream)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten in einem von der Stream-Klasse abgeleiteten Objekt.
Save(TextWriter)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der TextWriter-Klasse abgeleitet wurde.
Save(String)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten in der angegebenen Datei.

Save(XmlWriter)

Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der XmlWriter-Klasse abgeleitet wurde.

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)

Parameter

writer

XmlWriter

Ein von XmlWriter abgeleitetes Objekt zum Speichern von Chart-Eigenschaften.

Hinweise

Standardmäßig werden alle Diagrammeigenschaften mit nicht standardmäßigen Werten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie die Eigenschaften , und , um zu steuern, welche Diagrammmerkmale Content SerializableContent serialisiert NonSerializableContent werden.

Wenn Sie diese Definition verwenden, muss das Format XML sein. das Format kann mit der -Eigenschaft geändert Format werden.

Wenn Sie mit Textdateien im XML-Format arbeiten, verwenden Sie der Einfachheit halber stattdessen Save die -Methode.

Save(Stream)

Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten in einem von der Stream-Klasse abgeleiteten Objekt.

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)

Parameter

stream

Stream

Ein von der Stream-Klasse abgeleitetes Objekt, z. B. MemoryStream, das zum Speichern von Diagrammeigenschaften verwendet wird.

Hinweise

Standardmäßig werden alle Diagrammeigenschaften mit nicht standardmäßigen Werten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie zum Steuern der zu serialisierenden Diagrammmerkmale Content die Eigenschaften , und SerializableContent NonSerializableContent .

Wenn diese Methode verwendet wird, um Darstellungseigenschaften als Vorlage zu speichern, stellen Sie sicher, dass die -Eigenschaft des -Objekts zuerst auf festgelegt ist, IsTemplateMode bevor Sie diese Methode ChartSerializer true aufrufen.

Die Serialisierung eines Diagramms als Vorlage erfolgt anders als die Nicht-Vorlagenserialisierung. Die Vorlagenserialisierung konzentriert sich auf Darstellungseigenschaften.

Wenn eine Vorlage serialisiert wird, kann die -Methode zum Laden der Vorlage verwendet werden, um die LoadTemplate Darstellungseigenschaften für ein Diagramm zur Verfügung zu stellen.

Vorlagen können verwendet werden, um benutzerdefinierte Paletten zu simulieren.

Save(TextWriter)

Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der TextWriter-Klasse abgeleitet wurde.

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)

Parameter

writer

TextWriter

Ein von der TextWriter-Klasse abgeleitetes Objekt, z. B. StringWriter, das zum Speichern von Diagrammeigenschaften verwendet wird.

Hinweise

Standardmäßig werden alle Diagrammeigenschaften mit nicht standardmäßigen Werten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie die Eigenschaften , und , um zu steuern, welche Diagrammmerkmale Content SerializableContent serialisiert NonSerializableContent werden.

Wenn Sie diese Definition verwenden, muss das Format XML sein. das Format kann mit der -Eigenschaft festgelegt Format werden.

Save(String)

Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten in der angegebenen Datei.

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

public void Save (string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Parameter

fileName

String

Der relative oder absolute Pfad der zum Speichern der serialisierten Daten verwendeten Datei. Beachten Sie, dass bei Verwendung eines relativen Pfads dieser relativ zum aktuellen Verzeichnis ist.

Hinweise

Standardmäßig werden alle Diagrammeigenschaften mit nicht standardmäßigen Werten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie zum Steuern der zu serialisierenden Diagrammmerkmale Content die Eigenschaften , und SerializableContent NonSerializableContent .

Standardmäßig werden Daten in einem XML-Format gespeichert. Um die Daten in einem Binärformat zu speichern, verwenden Sie die Format -Eigenschaft.

Beachten Sie, dass Schreibberechtigungen für das Verzeichnis aktiviert werden müssen, in dem die Datei gespeichert ist. Standardmäßig ist dies der Ordner Bin der Anwendung.

Wenn diese Methode verwendet wird, um Darstellungseigenschaften als Vorlage zu speichern, stellen Sie sicher, dass die Eigenschaft zuerst auf festgelegt ist, IsTemplateMode bevor Sie diese Methode true aufrufen.

Die Serialisierung eines Diagramms als Vorlage erfolgt anders als die Nicht-Vorlagenserialisierung, in erster Linie, weil sich die Vorlagenserialisierung auf Darstellungseigenschaften konzentriert.

Wenn eine Vorlage serialisiert wird, kann die -Methode zum Laden der Vorlage verwendet werden, um die LoadTemplate Darstellungseigenschaften für ein Diagramm zur Verfügung zu stellen.

Vorlagen können verwendet werden, um benutzerdefinierte Paletten zu simulieren.