ChartSerializer Classe

Définition

Espace de noms:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Permet la sérialisation du contrôle Chart.

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Héritage

Object

ChartSerializer

Remarques

Cette classe est exposée en tant que Serializer propriété de la classe racine Chart .

La sérialisation enregistre l’état du graphique et fournit également la possibilité de charger les données sérialisées dans le graphique. Toutes les propriétés du graphique peuvent être conservées, y compris les données du graphique. En outre, toutes les propriétés de graphique marquées pour la sérialisation peuvent être réinitialisées.

Cette classe peut éventuellement être utilisée lors de la gestion de l’état d’affichage défini par l’utilisateur. L’une de ses Load méthodes peut être utilisée pour charger l’état d’affichage, et l’une des méthodes peut être utilisée lors de la Save définition de l’état d’affichage.

Les formats XML ou binaires peuvent être utilisés pour stocker des données sérialisées. XML est utilisé par défaut, mais vous pouvez modifier le format avec la Format propriété .

Les propriétés de graphique sont enregistrées et chargées à l’aide des Save méthodes et Load , respectivement. Notez que seules les propriétés avec des valeurs autres que celles par défaut sont enregistrées. Les données peuvent être enregistrées et/ou chargées à l’aide d’un fichier, d’un flux, TextWriterd’un objet , TextReaderet d’un XmlWriterXmlReader objet. Lors de l’enregistrement et/ou du chargement de données à l’aide TextReaderd’un objet dérivé des classes , TextWriterou XmlReaderXmlWriter , le format des données doit être XML.

La liste suivante décrit trois techniques, de base à avancées, utilisées pour définir des données sérialisables. Notez qu’il est également possible de définir des données non sérialisables. Cette technique est décrite dans le paragraphe suivant.

• Sérialisez le à l’aide Chart des Save méthodes et Load , sans spécifier de propriétés sérialisables. Toutes les propriétés de graphique avec des valeurs autres que celles par défaut, qui incluent les données de graphique, seront sérialisées.

• Sérialisez les propriétés de graphique spécifiées par la Content propriété . La Content propriété regroupe les propriétés de graphique à sérialiser en catégories telles que Données, Apparence, etc. Notez que les noms des ChartArea objets et Series sont automatiquement sérialisés ; les données sérialisées sont ensuite appliquées aux zones et séries de graphiques existantes lorsqu’elles sont chargées.

Important

La Content propriété est implémentée en interne par le Chart contrôle en tant que SerializableContent propriété

• Sérialisation des propriétés de graphique spécifiées par la SerializableContent propriété . Il s’agit d’une liste séparée par des virgules de toutes les propriétés de graphique sérialisables. Une fois cette propriété définie sur une valeur explicite, il incombe au développeur de spécifier toutes les propriétés à enregistrer. En d’autres termes, contrairement à la Content propriété, les noms des zones et des séries de graphiques ne sont pas automatiquement conservés. Les Content propriétés et SerializableContent peuvent également être utilisées conjointement. Toutefois, assurez-vous que SerializableContent est concaténé avec lui-même lors de la définition, sinon les propriétés de graphique spécifiées par la Content propriété seront remplacées.

Pour empêcher la sérialisation de certaines propriétés, utilisez la NonSerializableContent propriété . Lorsqu’une propriété est définie comme sérialisable et non sérialisable, ce qui est courant lorsque des caractères génériques sont utilisés, la SerializableContent propriété est prioritaire. Toutefois, la priorité dépend également du nombre de caractères génériques utilisés lorsqu’une propriété a été spécifiée.

Par défaut, les propriétés sérialisables sont réinitialisées à leurs valeurs par défaut avant d’être chargées. Ce comportement peut être modifié à l’aide de la IsResetWhenLoading propriété . La Reset méthode peut également être utilisée pour réinitialiser explicitement les propriétés du graphique à leurs valeurs par défaut.

Propriétés

Content	Obtient ou définit le type du contenu de graphique à sérialiser.
Format	Obtient ou définit le format utilisé lorsque le graphique est sérialisé.
IsResetWhenLoading	Obtient ou définit un indicateur qui détermine si les valeurs par défaut des propriétés d'objet sont rétablies avant le chargement de ces dernières.
IsTemplateMode	Obtient ou définit un indicateur qui détermine si le sérialiseur de graphique fonctionne en mode de création de modèle.
IsUnknownAttributeIgnored	Obtient ou définit un indicateur qui détermine si les éléments et propriétés XML inconnus sont ignorés sans qu'une exception ne soit levée.
NonSerializableContent	Obtient ou définit les propriétés de graphique qui ne seront pas sérialisées.
SerializableContent	Obtient ou définit les propriétés de graphique qui peuvent être sérialisées.

Méthodes

Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetContentString(SerializationContents, Boolean)	Retourne une classe sérialisable ou non sérialisable et/ou des noms de propriétés, selon la valeur d'indicateur spécifique.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
Load(Stream)	Charge des données sérialisées dans le contrôle à partir d'un objet dérivé de la classe Stream.
Load(String)	Charge des données sérialisées, qui sont enregistrées sur le disque, dans le contrôle Chart.
Load(TextReader)	Charge des données sérialisées dans le contrôle à partir d'un objet Reader qui est dérivé de la classe TextReader.
Load(XmlReader)	Charge des données sérialisées dans le contrôle à partir d'un objet dérivé de la classe XmlReader.
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Reset()	Réinitialise toutes les propriétés de graphique marquées pour la sérialisation.
Save(Stream)	Enregistre les données et propriétés de graphique avec des valeurs autres que celles par défaut dans un objet qui est dérivé de la classe Stream.
Save(String)	Enregistre les données et propriétés de graphique avec les valeurs non définies par défaut dans le fichier donné.
Save(TextWriter)	Enregistre les données et propriétés de graphique avec des valeurs autres que celles par défaut dans l'objet indiqué qui est dérivé de la classe TextWriter.
Save(XmlWriter)	Enregistre les données et propriétés de graphique avec des valeurs autres que celles par défaut dans l'objet indiqué qui est dérivé de la classe XmlWriter.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)