ChartSerializer.SerializableContent Propriété

Définition

Espace de noms:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Obtient ou définit les propriétés du 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 séparée par des virgules string qui représente les propriétés du graphique à sérialiser. La syntaxe est « Class.Property[,Class.Property] ».

Remarques

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

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 du 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 et Series d’objets ChartArea doivent également être spécifiés pour permettre l’application des données persistantes aux objets et Series existantsChartArea ; autrement dit, vous devez spécifier des 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 donné aux expressions de chaîne qui utilisent des caractères génériques. Par exemple, si la propriété a la SerializableContent valeur « *. BackColor » et la NonSerializableContent propriété est définie BackColorsur , toutes les propriétés BackColor à l’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.