ChartSerializer Třída

Definice

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Dědičnost

Object

ChartSerializer

Poznámky

Tato třída je vystavena Serializer jako vlastnost kořenové Chart třídy.

Serializace ukládá stav grafu a také poskytuje možnost načíst serializovaná data do grafu. Všechny vlastnosti grafu je možné zachovat, včetně dat grafu. Kromě toho lze resetovat všechny vlastnosti grafu označené pro serializaci.

Tuto třídu lze volitelně použít při správě uživatelem definovaného stavu zobrazení. Jednu z jeho Load metod lze použít k načtení stavu zobrazení a jednu z Save metod lze použít při nastavení stavu zobrazení.

Binární formáty XML nebo lze použít k uložení serializovaných dat. Xml se používá ve výchozím nastavení, ale můžete změnit formát pomocí Format vlastnosti .

Vlastnosti grafu se ukládají a načítají pomocí Save metod a Load v uvedeném pořadí. Všimněte si, že se uloží pouze vlastnosti s nevýchozími hodnotami. Data je možné ukládat nebo načítat pomocí souborů, datových proudů, TextWriter, XmlWriterTextReadera XmlReader objektů. Při ukládání nebo načítání dat pomocí objektu odvozeného z TextReadertříd , TextWriterXmlReader nebo XmlWriter musí být formát dat XML.

Následující seznam popisuje tři techniky, od základních po pokročilé, které se používají k definování serializovatelných dat. Všimněte si, že je také možné definovat neserializovatelná data. Tato technika je popsaná v následujícím odstavci.

• Serializujte Chart pomocí Save metod a Load bez zadání serializovatelných vlastností. Všechny vlastnosti grafu s nevýchozími hodnotami, které zahrnují data grafu, budou serializovány.

• Serializujte vlastnosti grafu určené Content vlastností . Vlastnost Content seskupuje vlastnosti grafu, které mají být serializovány do kategorií, jako jsou Data, Vzhled a tak dále. Všimněte si, že názvy ChartArea objektů a Series jsou automaticky serializovány; serializovaná data se pak po načtení použijí na existující oblasti grafu a řady.

• Serializace vlastností grafu určených SerializableContent vlastností. Toto je čárkami oddělený seznam všech vlastností grafu, které jsou serializovatelné. Poté, co je tato vlastnost nastavena na explicitní hodnotu, je zodpovědností vývojáře zadat všechny vlastnosti, které mají být uloženy. Jinými slovy, na rozdíl od Content vlastnosti nebudou názvy oblastí a řad grafu automaticky zachovány. Vlastnosti Content a SerializableContent lze také použít ve spojení. Při nastavování se ale ujistěte, že SerializableContent je zřetězený se sebou, jinak se vlastnosti grafu určené vlastností přepíší Content .

Chcete-li zakázat serializaci určitých vlastností, použijte NonSerializableContent vlastnost . Pokud je jedna vlastnost nastavena jako serializovatelná a neserializovatelná, což je běžné při použití zástupných znaků, SerializableContent má vlastnost přednost. Priorita ale také závisí na tom, kolik zástupných znaků bylo při zadání vlastnosti použito.

Ve výchozím nastavení se serializovatelné vlastnosti před načtením obnoví na výchozí hodnoty. Toto chování lze změnit pomocí IsResetWhenLoading vlastnosti . Metodu Reset lze také použít k explicitní resetování vlastností grafu na jejich výchozí hodnoty.

Vlastnosti

Metody

Platí pro