ChartSerializer.SerializableContent Propriété

Définition

Espace de noms:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Obtient ou définit les propriétés de graphique qui peuvent être sérialisées.

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

Valeur de propriété

String

Expression string séparée par des virgules qui représente les propriétés de graphique à sérialiser. La syntaxe est "Class.Property[,Class.Property]".

Remarques

Par défaut, toutes les propriétés de graphique sont sérialisées lorsque les Save méthodes et Load sont appelées. Vous pouvez utiliser la NonSerializableContent propriété pour limiter les caractéristiques de graphique à sérialiser, ainsi que les SerializableContent propriétés et Content .

La SerializableContent propriété détermine les caractéristiques du graphique qui seront sérialisées. Les caractères génériques peuvent être utilisés dans l’expression de chaîne, de la même manière que la NonSerializableContent propriété . Par exemple, pour sérialiser toutes les propriétés de graphique BackColor , définissez cette propriété sur « * ». BackColor ».

Si ChartArea des propriétés et/ou Series enfants sont spécifiées, les noms de tous les ChartArea objets et Series doivent également être spécifiés pour permettre aux données persistantes d’être appliquées aux ChartArea objets existants et ; Series autrement dit, vous devez spécifier les expressions « Series.Name » et « ChartArea.Name ». Consultez l’exemple de code ci-dessous pour obtenir un exemple de cette procédure. De même, si plusieurs zones de graphique sont utilisées, la ChartArea propriété de tous les tracés Series doit également être enregistrée.

Parfois, une propriété peut être définie pour être sérialisée et non sérialisée, ce qui est courant lorsque des caractères génériques sont utilisés. L’expression NonSerializableContent a une priorité inférieure par rapport à l’expression SerializableContent . Toutefois, notez que moins de poids est accordé aux expressions de chaîne qui utilisent des caractères génériques. Par exemple, si la SerializableContent propriété est définie sur « *. BackColor » et la NonSerializableContent propriété est définie sur , toutes les propriétés BackColor à BackColorl’exception des ChartArea objets seront sérialisées.

Si vous définissez la Content propriété, la SerializableContent propriété est définie en interne. Si la Content propriété est déjà définie, mais qu’une autre propriété doit être sérialisée, veillez à concaténer la propriété lors de la SerializableContent spécification de cette propriété supplémentaire. Consultez l’exemple de code ci-dessous pour obtenir un exemple de cette procédure.

Cette propriété affecte toutes les opérations d’enregistrement, de chargement et de réinitialisation.