ChartSerializer Klasse

Definition

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Aktiviert die Serialisierung des Chart-Steuerelements.

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Vererbung

Object

ChartSerializer

Hinweise

Diese Klasse wird als Serializer Eigenschaft der Stammklasse Chart verfügbar gemacht.

Die Serialisierung speichert den Zustand des Diagramms und bietet auch die Möglichkeit, die serialisierten Daten in das Diagramm zu laden. Alle Diagrammeigenschaften können beibehalten werden, einschließlich der Daten des Diagramms. Darüber hinaus können alle für die Serialisierung markierten Diagrammeigenschaften zurückgesetzt werden.

Diese Klasse kann optional zum Verwalten des benutzerdefinierten Ansichtszustands verwendet werden. Eine der Load Methoden kann verwendet werden, um den Ansichtszustand zu laden, und eine der Save Methoden kann beim Festlegen des Ansichtszustands verwendet werden.

Die XML- oder Binärformate können verwendet werden, um serialisierte Daten zu speichern. XML wird standardmäßig verwendet, aber Sie können das Format mit der Format -Eigenschaft ändern.

Diagrammeigenschaften werden gespeichert und geladen, mit der Save und Load Methoden bzw. Beachten Sie, dass nur Eigenschaften mit Nicht-Standardwerten gespeichert werden. Daten können mithilfe von Datei-, Stream-, TextWriter, TextReaderXmlWriter und -Objekten gespeichert undXmlReader/oder geladen werden. Beim Speichern und/oder Laden von Daten mithilfe eines Objekts, das von der TextReader- TextWriteroder - XmlReader oder XmlWriter -Klasse abgeleitet wird, muss das Format der Daten XML sein.

In der folgenden Liste werden drei Techniken beschrieben, von basic bis advanced, die zum Definieren serialisierbarer Daten verwendet werden. Beachten Sie, dass es auch möglich ist, nicht serialisierbare Daten zu definieren. Dieses Verfahren wird im nächsten Absatz beschrieben.

• Serialisieren Sie den Chart mit den Save Methoden und Load , ohne serialisierbare Eigenschaften anzugeben. Alle Diagrammeigenschaften mit Nicht-Standardwerten, die Diagrammdaten enthalten, werden serialisiert.

• Serialisieren Sie die von der Content -Eigenschaft angegebenen Diagrammeigenschaften. Die Content Eigenschaft gruppiert die Diagrammeigenschaften, die serialisiert werden sollen, in Kategorien wie Daten, Darstellung usw. Beachten Sie, dass die Namen von ChartArea -Objekten und Series -Objekten automatisch serialisiert werden. Die serialisierten Daten werden dann beim Laden auf vorhandene Diagrammbereiche und -reihen angewendet.

Wichtig

Die Content -Eigenschaft wird intern vom Chart -Steuerelement als SerializableContent -Eigenschaft implementiert.

• Serialisierung von Diagrammeigenschaften, die durch die SerializableContent -Eigenschaft angegeben werden. Dies ist eine durch Trennzeichen getrennte Auflistung aller Diagrammeigenschaften, die serialisierbar sind. Nachdem diese Eigenschaft auf einen expliziten Wert festgelegt wurde, liegt es in der Verantwortung des Entwicklers, alle zu speichernden Eigenschaften anzugeben. Anders als bei der Content -Eigenschaft werden die Namen von Diagrammbereichen und -reihen nicht automatisch beibehalten. Die Content Eigenschaften und SerializableContent können auch in Verbindung verwendet werden. Stellen Sie jedoch sicher, dass SerializableContent beim Festlegen mit sich selbst verkettet wird, andernfalls werden die von der Content -Eigenschaft angegebenen Diagrammeigenschaften überschrieben.

Verwenden Sie die NonSerializableContent -Eigenschaft, um zu verhindern, dass bestimmte Eigenschaften serialisiert werden. Wenn eine Eigenschaft als serialisierbar und nicht serialisierbar festgelegt ist, was bei Verwendung von Feldhaltern üblich ist, hat die SerializableContent Eigenschaft Vorrang. Die Rangfolge hängt jedoch auch davon ab, wie viele Wildcards verwendet wurden, als eine Eigenschaft angegeben wurde.

Standardmäßig werden serialisierbare Eigenschaften auf ihre Standardwerte zurückgesetzt, bevor sie geladen werden. Dieses Verhalten kann mithilfe der IsResetWhenLoading -Eigenschaft geändert werden. Die Reset -Methode kann auch verwendet werden, um Diagrammeigenschaften explizit auf ihre Standardwerte zurückzusetzen.

Eigenschaften

Content	Ruft den Typ des zu serialisierenden Diagramminhalts ab oder legt diesen fest.
Format	Ruft das beim Serialisieren des Diagramms verwendete Format ab oder legt dieses fest.
IsResetWhenLoading	Ruft ein Flag ab, das angibt, ob Objekteigenschaften vor dem Laden auf Standardwerte zurückgesetzt werden, oder legt dieses fest.
IsTemplateMode	Ruft ein Flag ab, das angibt, ob das Diagrammserialisierungsprogramm im Modus für die Vorlagenerstellung ausgeführt wird, oder legt dieses fest.
IsUnknownAttributeIgnored	Ruft ein Flag ab, das angibt, ob unbekannte XML-Eigenschaften und -Elemente ignoriert werden, ohne eine Ausnahme auszulösen, oder legt dieses fest.
NonSerializableContent	Ruft die Diagrammeigenschaften ab, die nicht serialisiert werden, oder legt diese fest.
SerializableContent	Ruft die Diagrammeigenschaften ab, die serialisiert werden können, oder legt diese fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetContentString(SerializationContents, Boolean)	Gibt je nach dem spezifischen Flagwert serialisierbare oder nicht serialisierbare Klassen- und/oder Eigenschaftennamen zurück.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
Load(Stream)	Lädt serialisierte Daten aus einem Objekt, das von der Stream-Klasse abgeleitet wurde, in das Steuerelement.
Load(String)	Lädt auf dem Datenträger gespeicherte serialisierte Daten in das Chart-Steuerelement.
Load(TextReader)	Lädt serialisierte Daten aus einem Readerobjekt, das von der TextReader-Klasse abgeleitet wurde, in das Steuerelement.
Load(XmlReader)	Lädt serialisierte Daten aus einem Objekt, das von der XmlReader-Klasse abgeleitet wurde, in das Steuerelement.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Reset()	Setzt alle für die Serialisierung markierten Diagrammeigenschaften zurück.
Save(Stream)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten in einem von der Stream-Klasse abgeleiteten Objekt.
Save(String)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten in der angegebenen Datei.
Save(TextWriter)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der TextWriter-Klasse abgeleitet wurde.
Save(XmlWriter)	Speichert Diagrammdaten und -eigenschaften mit nicht standardmäßigen Werten im angegebenen Objekt, das von der XmlWriter-Klasse abgeleitet wurde.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)