ChartSerializer.Save Methode

Definition

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.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-Standardwerten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie die ContentEigenschaften und SerializableContentNonSerializableContent , um zu steuern, welche Diagrammmerkmale serialisiert werden.

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

Wenn Sie mit Textdateien im XML-Format arbeiten, verwenden Sie der Einfachheit halber stattdessen die Save -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-Standardwerten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie zum Steuern von Diagrammmerkmalen, die serialisiert werden sollen, die ContentEigenschaften und SerializableContentNonSerializableContent .

Wenn diese Methode verwendet wird, um Darstellungseigenschaften als Vorlage zu speichern, stellen Sie sicher, dass die IsTemplateMode Eigenschaft des ChartSerializer Objekts zuerst auf festgelegt ist, true bevor Sie diese Methode 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 LoadTemplate -Methode zum Laden der Vorlage verwendet werden, um die Darstellungseigenschaften für ein Diagramm bereitzustellen.

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-Standardwerten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie die ContentEigenschaften und SerializableContentNonSerializableContent , um zu steuern, welche Diagrammmerkmale serialisiert werden.

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

Wenn die ViewStateData -Eigenschaft des Steuerelements zum Beibehalten des Chart Zustands verwendet wird, kann diese Methode verwendet werden, um die serialisierten Daten in einem von TextWriterabgeleiteten Objekt zu speichern, das dann verwendet wird, um die Daten in die ViewStateData -Eigenschaft zu schreiben.

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-Standardwerten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie zum Steuern von Diagrammmerkmalen, die serialisiert werden sollen, die ContentEigenschaften und SerializableContentNonSerializableContent .

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

Beachten Sie, dass Schreibberechtigungen für das Verzeichnis aktiviert sein 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 IsTemplateMode Eigenschaft zuerst auf festgelegt ist, true bevor Sie diese Methode aufrufen.

Die Serialisierung eines Diagramms als Vorlage verläuft anders als die Nicht-Vorlagenserialisierung, vor allem, weil sich die Vorlagenserialisierung auf Darstellungseigenschaften konzentriert.

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

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