ChartSerializer Classe

Definizione

Spazio dei nomi:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

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 fornisce anche l'opzione per caricare i dati serializzati nel grafico. Tutte le proprietà del grafico possono essere mantenute, inclusi i dati del grafico. Inoltre, tutte le proprietà del grafico contrassegnate per la serializzazione possono essere reimpostate.

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

I formati XML o binari possono essere usati 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, TextWriterTextReaderXmlWriter , e XmlReader 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'uso dei ChartSave metodi e Load , senza specificare alcuna proprietà serializzabile. Tutte le proprietà del grafico con valori non predefiniti, che includono i dati del grafico, verranno serializzati.

• Serializzare le proprietà del Content grafico specificate dalla proprietà . La Content proprietà raggruppa le proprietà del grafico da serializzare in categorie come Dati, Aspetto e così via. Si noti che i nomi di e Series oggetti vengono serializzati automaticamente. I dati serializzati vengono quindi applicati alle aree del ChartArea grafico e alle serie esistenti durante il caricamento.

Importante

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

• Serializzazione delle proprietà del grafico specificate dalla SerializableContent 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 del grafico e della serie non verranno mantenuti automaticamente. Le Content proprietà e SerializableContent possono essere usate anche in combinazione. Tuttavia, assicurarsi che SerializableContent sia concatenato con se stesso quando viene impostato, in caso contrario, le proprietà del Content grafico specificate dalla proprietà verranno sostituite.

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

Per impostazione predefinita, le proprietà serializzabili vengono reimpostate nelle 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 ai 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)