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 obnovit všechny vlastnosti grafu označené pro serializaci.

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

K ukládání serializovaných dat lze použít xml nebo binární formáty. XML se používá ve výchozím nastavení, ale můžete změnit formát s Format vlastností.

Vlastnosti grafu se ukládají a načítají pomocí Save metod a Load metod. Všimněte si, že budou uloženy pouze vlastnosti s ne-výchozími hodnotami. Data je možné uložit nebo načíst pomocí souboru, datového proudu, TextWriter, TextReaderXmlWriter a XmlReader objektů. Při ukládání a/nebo načítání dat pomocí objektu odvozeného z TextReader, TextWriterXmlReader nebo XmlWriter tříd, formát dat musí být XML.

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

• Serializovat Chart pomocí Save a Load metody, aniž by bylo nutné zadat serializovatelné vlastnosti. Všechny vlastnosti grafu s hodnotami, které nejsou výchozí, včetně dat grafu, budou serializovány.

• Serializovat vlastnosti grafu určené vlastností Content . Vlastnost Content seskupí vlastnosti grafu, které mají být serializovány do kategorií, jako jsou Data, Vzhled atd. Všimněte si, že názvy ChartArea a Series objekty jsou automaticky serializovány; serializovaná data se 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í vlastnosti. Toto je čárkami oddělený seznam všech vlastností grafu, které jsou serializovatelné. Jakmile je tato vlastnost nastavena na explicitní hodnotu, je zodpovědností vývojáře určit všechny vlastnosti, které se mají uložit. Jinými slovy, na rozdíl od vlastnosti nebudou Content názvy oblastí grafu a řad automaticky zachovány. Vlastnosti Content lze SerializableContent použít také ve spojení. Ujistěte se však, že SerializableContent je při nastavování zřetězena se sebou, jinak vlastnosti grafu určené Content vlastností budou přepsány.

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

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

Vlastnosti

Name	Description
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ý indikuje, zda vlastnosti objektu se resetují na výchozí hodnoty před načtením.
IsTemplateMode	Získá nebo nastaví příznak, který označuje, zda serializátor grafu pracuje v režimu vytváření šablony.
IsUnknownAttributeIgnored	Získá nebo nastaví příznak, který označuje, zda neznámé vlastnosti XML 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

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetContentString(SerializationContents, Boolean)	Vrátí serializovatelnou nebo ne serializovatelnou třídu nebo názvy vlastností v závislosti na konkrétní hodnotě příznaku.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type 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 čtenáře, který je odvozen od 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 Object. (Zděděno od Object)
Reset()	Obnoví všechny vlastnosti grafu označené pro serializaci.
Save(Stream)	Uloží data a vlastnosti grafu s ne-výchozími hodnotami do objektu Stream , který je odvozen od třídy.
Save(String)	Uloží data a vlastnosti grafu s ne-výchozími hodnotami do daného souboru.
Save(TextWriter)	Uloží data a vlastnosti grafu s hodnotami, které nejsou výchozí, do daného objektu TextWriter odvozeného z třídy.
Save(XmlWriter)	Uloží data a vlastnosti grafu s hodnotami, které nejsou výchozí, do daného objektu XmlWriter odvozeného z třídy.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)