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 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 seront sérialisées lorsque les Save Load méthodes et sont appelées. Vous pouvez utiliser la NonSerializableContent propriété pour limiter les caractéristiques de graphique à sérialiser, ainsi que SerializableContent les Content Propriétés et.

La SerializableContent propriété détermine les caractéristiques de 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 façon que la NonSerializableContent propriété. Par exemple, pour sérialiser toutes les BackColor Propriétés de graphique, affectez la valeur « * » à cette propriété. BackColor».

Si ChartArea des propriétés et/ou Series enfants sont spécifiées, les noms de tous les ChartArea Series objets et doivent également être spécifiés pour permettre l’application des données persistantes aux ChartArea objets et existants Series ; autrement dit, vous devez spécifier les expressions « Series.Name » et « ChartArea.Name ». Pour obtenir un exemple de cette procédure, consultez l’exemple de code ci-dessous. 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 comme étant à la fois sérialisée et non sérialisée, ce qui est courant lorsque des caractères génériques sont utilisés. L' NonSerializableContent expression a une priorité inférieure par rapport à l' SerializableContent expression. Toutefois, Notez qu’une pondération inférieure est donnée aux expressions de chaîne qui utilisent des caractères génériques. Par exemple, si la SerializableContent propriété a la valeur "*. BackColor» et la NonSerializableContent propriété a la valeur BackColor , toutes les propriétés B, ackColor à 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, assurez-vous de concaténer la SerializableContent propriété lors de la spécification de cette propriété supplémentaire. Pour obtenir un exemple de cette procédure, consultez l’exemple de code ci-dessous.

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