Condividi tramite


ChartSerializer Classe

Definizione

Abilita la serializzazione del controllo Chart.

public ref class ChartSerializer
public class ChartSerializer
type ChartSerializer = class
Public Class ChartSerializer
Ereditarietà
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 XmlReaderXmlWriter oggetti . Quando si salvano e/o caricano dati usando un oggetto derivato dalle TextReaderclassi , TextWriterXmlReader 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