ChartSerializer Třída

Definice

Obor názvů:

System.Web.UI.DataVisualization.Charting

Sestavení:

System.Web.DataVisualization.dll

Umožňuje serializaci Chart ovládacího prvku.

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.

Důležité

Vlastnost Content je implementována interně ovládacím Chart prvku jako SerializableContent vlastnost

• 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

Content	Získá nebo nastaví typ obsahu grafu, který má být serializován.
Format	Získá nebo nastaví formát použitý při serializaci grafu.
IsResetWhenLoading	Získá nebo nastaví příznak, který označuje, zda jsou vlastnosti objektu obnoveny výchozí hodnoty před načtením.
IsTemplateMode	Získá nebo nastaví příznak, který označuje, zda chart serializátor pracovat v režimu vytváření šablony.
IsUnknownAttributeIgnored	Získá nebo nastaví příznak, který označuje, zda neznámé xml vlastnosti a elementy budou ignorovány bez vyvolání výjimky.
NonSerializableContent	Získá nebo nastaví vlastnosti grafu, které nebudou serializovány.
SerializableContent	Získá nebo nastaví vlastnosti grafu, které lze serializovat.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetContentString(SerializationContents, Boolean)	Vrátí serializovatelné nebo neserializovatelné názvy tříd nebo vlastností v závislosti na konkrétní hodnotě příznaku.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
Load(Stream)	Načte serializovaná data do ovládacího prvku z objektu odvozeného Stream z třídy .
Load(String)	Načte serializovaná data uložená na disk do Chart ovládacího prvku.
Load(TextReader)	Načte serializovaná data do ovládacího prvku z objektu čtečky, který je odvozen z TextReader třídy .
Load(XmlReader)	Načte serializovaná data do ovládacího prvku z objektu odvozeného XmlReader z třídy .
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
Reset()	Obnoví všechny vlastnosti grafu označené pro serializaci.
Save(Stream)	Uloží data grafu a vlastnosti s nevýchozími hodnotami do objektu, který je odvozen z Stream třídy .
Save(String)	Uloží data a vlastnosti grafu s nevýchozími hodnotami do daného souboru.
Save(TextWriter)	Uloží data grafu a vlastnosti s nevýchozími hodnotami do daného objektu TextWriter , který je odvozen od třídy .
Save(XmlWriter)	Uloží data grafu a vlastnosti s nevýchozími hodnotami do daného objektu XmlWriter , který je odvozen od třídy .
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)