ChartSerializer Classe

Définition

Espace de noms:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.DataVisualization.dll

Active la sérialisation du Chart contrôle.

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 de 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. 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 définition de Save l’état d’affichage.

Les formats XML ou binaires peuvent être utilisés pour stocker des données sérialisées. Le code 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 des méthodes, respectivement. Notez que seules les propriétés avec des valeurs autres que les valeurs 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, TextWriterTextReaderd’un flux et XmlWriter d’objetsXmlReader. Lors de l’enregistrement et/ou du chargement de données à l’aide d’un objet dérivé du TextReader, TextWriterXmlReader ou XmlWriter des classes, 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 l’utilisation Chart des méthodes et Load des Save méthodes, sans spécifier de propriétés sérialisables. Toutes les propriétés de graphique avec des valeurs non par défaut, qui incluent des données de graphique, seront sérialisées.

• Sérialisez les propriétés de graphique spécifiées par la Content propriété. Les Content propriétés regroupent les propriétés du graphique à sérialiser dans des catégories telles que Données, Apparence, etc. Notez que les noms et ChartAreaSeries objets sont automatiquement sérialisés ; les données sérialisées sont ensuite appliquées aux zones et séries de graphiques existantes lors du chargement.

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 qui sont 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 de graphique et des séries ne seront pas automatiquement conservés. Les Content propriétés peuvent SerializableContent également être utilisées conjointement. Toutefois, assurez-vous qu’elle SerializableContent est concaténée avec elle-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 interdire 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é a la priorité. 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 leur chargement. 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

Nom	Description
Content	Obtient ou définit le type de contenu du 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 indique si les propriétés d’objet sont réinitialisées aux valeurs par défaut avant le chargement.
IsTemplateMode	Obtient ou définit un indicateur qui indique si le sérialiseur de graphique fonctionne en mode création de modèle.
IsUnknownAttributeIgnored	Obtient ou définit un indicateur qui indique si les propriétés et les éléments XML inconnus sont ignorés sans lever d’exception.
NonSerializableContent	Obtient ou définit les propriétés du graphique qui ne seront pas sérialisées.
SerializableContent	Obtient ou définit les propriétés du graphique qui peuvent être sérialisées.

Méthodes

Nom	Description
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, en fonction de la valeur d’indicateur spécifique.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
Load(Stream)	Charge les données sérialisées dans le contrôle à partir d’un objet dérivé de la Stream classe.
Load(String)	Charge les données sérialisées enregistrées sur le disque dans le Chart contrôle.
Load(TextReader)	Charge les données sérialisées dans le contrôle à partir d’un objet lecteur qui dérive de la TextReader classe.
Load(XmlReader)	Charge les données sérialisées dans le contrôle à partir d’un objet dérivé de la XmlReader classe.
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (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 les propriétés du graphique avec des valeurs non par défaut dans un objet dérivé de la Stream classe.
Save(String)	Enregistre les données et les propriétés du graphique avec des valeurs non par défaut dans le fichier donné.
Save(TextWriter)	Enregistre les données et les propriétés du graphique avec des valeurs non par défaut dans l’objet donné dérivé de la TextWriter classe.
Save(XmlWriter)	Enregistre les données et les propriétés du graphique avec des valeurs non par défaut dans l’objet donné dérivé de la XmlWriter classe.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)