ChartSerializer.Save Methode

Definition

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Speichert Diagrammeigenschaften, die keine Standardwerte aufweisen. Alle Diagrammeigenschaften können serialisiert werden; dies schließt Daten ein.

Überlädt

Name	Beschreibung
Save(XmlWriter)	Speichert Diagrammdaten und Eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der XmlWriter Klasse abgeleitet wird.
Save(Stream)	Speichert Diagrammdaten und Eigenschaften mit nicht standardmäßigen Werten in einem Objekt, das von der Stream Klasse abgeleitet wird.
Save(TextWriter)	Speichert Diagrammdaten und Eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der TextWriter Klasse abgeleitet wird.
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 wird.

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 Objekt, das von dem zum Speichern Chart von XmlWriter Eigenschaften abgeleitet wurde.

Hinweise

Standardmäßig werden alle Diagrammeigenschaften mit nicht standardmäßigen Werten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie die ContentEigenschaften SerializableContent und NonSerializableContent Eigenschaften, 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 XML-Format-Textdateien arbeiten, verwenden Sie stattdessen die Methode aus Gründen der Save Einfachheit.

Save(Stream)

Speichert Diagrammdaten und Eigenschaften mit nicht standardmäßigen Werten in einem Objekt, das von der Stream Klasse abgeleitet wird.

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 MemoryStream. B. zum Speichern von Diagrammeigenschaften.

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 die ContentEigenschaften SerializableContent und NonSerializableContent Eigenschaften.

Wenn diese Methode zum Speichern von Darstellungseigenschaften als Vorlage verwendet wird, stellen Sie sicher, dass die IsTemplateMode Eigenschaft des ChartSerializer Objekts zuerst festgelegt true ist, bevor Sie diese Methode aufrufen.

Die Serialisierung eines Diagramms als Vorlage unterscheidet sich von der Serialisierung ohne Vorlage; Die Serialisierung von Vorlagen 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 wird.

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 TextWriter der Klasse abgeleitetes Objekt, StringWriterz. B. zum Speichern von Diagrammeigenschaften.

Hinweise

Standardmäßig werden alle Diagrammeigenschaften mit nicht standardmäßigen Werten, die Datenpunkte enthalten, serialisiert, wenn diese Methode aufgerufen wird. Verwenden Sie die ContentEigenschaften SerializableContent und NonSerializableContent Eigenschaften, 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 objekt zu speichern, das von TextWritereinem abgeleiteten Objekt abgeleitet wird, das dann zum Schreiben der Daten in die ViewStateData Eigenschaft verwendet wird.

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 Datei, die zum Speichern der serialisierten Daten verwendet wird. Beachten Sie, dass der Pfad relativ zum aktuellen Verzeichnis ist, wenn ein relativer Pfad angegeben 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 von Diagrammmerkmalen, die serialisiert werden sollen, die ContentEigenschaften SerializableContent und NonSerializableContent eigenschaften.

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

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 zum Speichern von Darstellungseigenschaften als Vorlage verwendet wird, stellen Sie sicher, dass die IsTemplateMode Eigenschaft zuerst festgelegt true ist, bevor Sie diese Methode aufrufen.

Die Serialisierung eines Diagramms als Vorlage unterscheidet sich von der Serialisierung ohne Vorlage, hauptsächlich weil sich die Serialisierung von Vorlagen 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.