ChartSerializer.SerializableContent Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Ottiene o imposta le proprietà del grafico che possono essere serializzate.

public:
 property System::String ^ SerializableContent { System::String ^ get(); void set(System::String ^ value); };

public string SerializableContent { get; set; }

member this.SerializableContent : string with get, set

Public Property SerializableContent As String

Valore della proprietà

String

Espressione delimitata da string virgole che rappresenta le proprietà del grafico da serializzare. La sintassi è "Class.Property[,Class.Property]".

Commenti

Per impostazione predefinita, tutte le proprietà del grafico verranno serializzate quando vengono chiamati i Save metodi e Load . È possibile utilizzare la proprietà per limitare le NonSerializableContent caratteristiche del grafico da serializzare, insieme alle SerializableContent proprietà e Content .

La SerializableContent proprietà determina quali caratteristiche del grafico verranno serializzate. I caratteri jolly possono essere usati nell'espressione stringa, allo stesso modo della NonSerializableContent proprietà . Ad esempio, per serializzare tutte le proprietà del grafico BackColor , impostare questa proprietà su "*. BackColor".

Se ChartArea vengono specificate proprietà figlio e/o Series , è necessario specificare anche i nomi di tutti gli ChartArea oggetti e Series per consentire l'applicazione dei dati persistenti agli oggetti e Series esistentiChartArea, ovvero è necessario specificare le espressioni "Series.Name" e "ChartArea.Name". Per un esempio di questa procedura, vedere il codice di esempio seguente. Analogamente, se vengono utilizzate più aree del grafico, è necessario salvare anche la ChartArea proprietà di tutti i tracciati Series .

In alcuni casi, una proprietà può essere impostata per essere serializzata e non serializzata, che è comune quando vengono utilizzati caratteri jolly. L'espressione NonSerializableContent ha una priorità inferiore rispetto all'espressione SerializableContent . Si noti tuttavia che viene assegnato un peso minore alle espressioni stringa che usano caratteri jolly. Ad esempio, se la SerializableContent proprietà è impostata su "*. BackColor" e la NonSerializableContent proprietà è impostata su BackColor, tutte le proprietà BackColor ad eccezione degli ChartArea oggetti verranno serializzate.

Se si imposta la Content proprietà , la SerializableContent proprietà verrà impostata internamente. Se la Content proprietà è già impostata ma è necessario serializzare un'altra proprietà, assicurarsi di concatenare la SerializableContent proprietà quando si specifica tale proprietà aggiuntiva. Per un esempio di questa procedura, vedere il codice di esempio seguente.

Questa proprietà influisce su tutte le operazioni di salvataggio, caricamento e reimpostazione.