ChartSerializer Classe

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.DataVisualization.Charting

Assembly:: System.Web.DataVisualization.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Abilita la serializzazione del controllo Chart.

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Ereditarietà: Object
ChartSerializer

Commenti

Questa classe viene esposta come Serializer proprietà della classe radice Chart .

La serializzazione salva lo stato del grafico e offre anche la possibilità di caricare i dati serializzati nel grafico. È possibile rendere persistenti tutte le proprietà del grafico, inclusi i dati del grafico. Inoltre, tutte le proprietà del grafico contrassegnate per la serializzazione possono essere reimpostate.

Questa classe può essere usata facoltativamente quando si gestisce lo stato di visualizzazione definito dall'utente. Uno dei metodi Load può essere usato per caricare lo stato di visualizzazione e uno dei Save metodi può essere usato durante l'impostazione dello stato di visualizzazione.

I formati XML o binari possono essere utilizzati per archiviare i dati serializzati. XML viene usato per impostazione predefinita, ma è possibile modificare il formato con la Format proprietà .

Le proprietà del grafico vengono salvate e caricate rispettivamente usando i Save metodi e Load . Si noti che verranno salvate solo le proprietà con valori non predefiniti. I dati possono essere salvati e/o caricati usando un file, un flusso, TextWriter, TextReadere XmlReader XmlWriter oggetti . Quando si salvano e/o caricano dati usando un oggetto derivato dalle TextReaderclassi , TextWriter XmlReader o XmlWriter , il formato dei dati deve essere XML.

Nell'elenco seguente vengono descritte tre tecniche, da base a avanzate, usate per definire dati serializzabili. Si noti che è anche possibile definire dati non serializzabili. Questa tecnica è descritta nel paragrafo successivo.

Serializzare l'oggetto Chart utilizzando i Save metodi e Load , senza specificare proprietà serializzabili. Tutte le proprietà del grafico con valori non predefiniti, inclusi i dati del grafico, verranno serializzate.
Serializzare le proprietà del Content grafico specificate dalla proprietà . La Content proprietà raggruppa le proprietà del grafico da serializzare in categorie quali Dati, Aspetto e così via. Si noti che i nomi degli ChartArea oggetti e Series vengono serializzati automaticamente. I dati serializzati vengono quindi applicati alle aree e alle serie del grafico esistenti al caricamento.

Importante

La Content proprietà viene implementata internamente dal Chart controllo come SerializableContent proprietà

Serializzazione delle proprietà del SerializableContent grafico specificate dalla proprietà . Si tratta di un elenco delimitato da virgole di tutte le proprietà del grafico serializzabili. Dopo che questa proprietà è impostata su un valore esplicito, è responsabilità dello sviluppatore specificare tutte le proprietà da salvare. In altre parole, a differenza della Content proprietà , i nomi delle aree grafico e delle serie non verranno salvati automaticamente in modo permanente. Le Content proprietà e SerializableContent possono essere utilizzate anche in combinazione. Tuttavia, assicurarsi che SerializableContent sia concatenato con se stesso durante l'impostazione. In caso contrario, le proprietà del Content grafico specificate dalla proprietà verranno sottoposte a override.

Per impedire la serializzazione di determinate proprietà, utilizzare la NonSerializableContent proprietà . Quando una proprietà viene impostata come serializzabile e non serializzabile, che è comune quando vengono utilizzati caratteri jolly, la SerializableContent proprietà ha la precedenza. Tuttavia, la precedenza dipende anche dal numero di caratteri jolly utilizzati quando è stata specificata una proprietà.

Per impostazione predefinita, le proprietà serializzabili vengono reimpostate sulle impostazioni predefinite prima del caricamento. Questo comportamento può essere modificato usando la IsResetWhenLoading proprietà . Il Reset metodo può essere usato anche per reimpostare in modo esplicito le proprietà del grafico sui valori predefiniti.

Proprietà

Content	Ottiene o imposta il tipo di contenuto del grafico da serializzare.
Format	Ottiene o imposta il formato utilizzato durante la serializzazione del grafico.
IsResetWhenLoading	Ottiene o imposta un flag che indica se le proprietà dell'oggetto vengono reimpostate sui valori predefiniti prima del caricamento.
IsTemplateMode	Ottiene o imposta un flag che indica se il serializzatore del grafico è in modalità di creazione modelli.
IsUnknownAttributeIgnored	Ottiene o imposta un flag che indica se le proprietà e gli elementi XML sconosciuti verranno ignorati senza generare un'eccezione.
NonSerializableContent	Ottiene o imposta le proprietà del grafico che non verranno serializzate.
SerializableContent	Ottiene o imposta le proprietà del grafico che possono essere serializzate.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetContentString(SerializationContents, Boolean)	Restituisce una classe serializzabile o non serializzabile e/o i nomi delle proprietà, a seconda del valore del flag specifico.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Load(Stream)	Carica i dati serializzati nel controllo da un oggetto derivato dalla classe Stream.
Load(String)	Carica i dati serializzati salvati su disco nel controllo Chart.
Load(TextReader)	Carica i dati serializzati nel controllo da un oggetto lettore che deriva dalla classe TextReader.
Load(XmlReader)	Carica i dati serializzati nel controllo da un oggetto derivato dalla classe XmlReader.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
Reset()	Reimposta tutte le proprietà del grafico contrassegnate per la serializzazione.
Save(Stream)	Salva i dati e le proprietà del grafico con valori non predefiniti in un oggetto che deriva dalla classe Stream.
Save(String)	Salva i dati e le proprietà del grafico con valori non predefiniti nel file specificato.
Save(TextWriter)	Salva i dati e le proprietà del grafico con valori non predefiniti nell'oggetto specificato derivato dalla classe TextWriter.
Save(XmlWriter)	Salva i dati e le proprietà del grafico con valori non predefiniti nell'oggetto specificato derivato dalla classe XmlWriter.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Si applica a

Condividi tramite