ChartSerializer.Save Méthode

Définition

Espace de noms:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Enregistre les propriétés du graphique qui ont des valeurs non par défaut. Toutes les propriétés de graphique peuvent être sérialisées ; cela inclut les données.

Surcharges

Nom	Description
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.
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(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(String)	Enregistre les données et les propriétés du graphique avec des valeurs non par défaut dans le fichier donné.

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.

public:
 void Save(System::Xml::XmlWriter ^ writer);

public void Save(System.Xml.XmlWriter writer);

member this.Save : System.Xml.XmlWriter -> unit

Public Sub Save (writer As XmlWriter)

Paramètres

writer

XmlWriter

Objet dérivé de XmlWriter utilisé pour enregistrer les Chart propriétés.

Remarques

Par défaut, toutes les propriétés de graphique avec des valeurs non par défaut, qui incluent des points de données, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique sérialisées, utilisez les propriétés et NonSerializableContent les ContentSerializableContent propriétés.

Lorsque vous utilisez cette définition, le format doit être XML ; le format peut être modifié avec la Format propriété.

Lorsque vous utilisez des fichiers texte au format XML, utilisez plutôt la Save méthode par souci de simplicité.

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.

public:
 void Save(System::IO::Stream ^ stream);

public void Save(System.IO.Stream stream);

member this.Save : System.IO.Stream -> unit

Public Sub Save (stream As Stream)

Paramètres

stream

Stream

Objet dérivé de la Stream classe, tel que MemoryStream, utilisé pour enregistrer les propriétés du graphique.

Remarques

Par défaut, toutes les propriétés de graphique avec des valeurs non par défaut, qui incluent des points de données, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique à sérialiser, utilisez les propriétés et NonSerializableContent les ContentSerializableContent propriétés.

Si cette méthode est utilisée pour enregistrer les propriétés d’apparence en tant que modèle, vérifiez que la IsTemplateMode propriété de l’objet ChartSerializer est d’abord définie true avant d’appeler cette méthode.

La sérialisation d’un graphique en tant que modèle se produit différemment de la sérialisation non-modèle ; la sérialisation de modèle se concentre sur les propriétés d’apparence.

Lorsqu’un modèle est sérialisé, la LoadTemplate méthode peut être utilisée pour charger le modèle afin de fournir les propriétés d’apparence d’un graphique.

Les modèles peuvent être utilisés pour simuler des palettes personnalisées.

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.

public:
 void Save(System::IO::TextWriter ^ writer);

public void Save(System.IO.TextWriter writer);

member this.Save : System.IO.TextWriter -> unit

Public Sub Save (writer As TextWriter)

Paramètres

writer

TextWriter

Objet dérivé de TextWriter la classe, par exemple, StringWriterutilisé pour enregistrer les propriétés du graphique.

Remarques

Par défaut, toutes les propriétés de graphique avec des valeurs non par défaut, qui incluent des points de données, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique sérialisées, utilisez les propriétés et NonSerializableContent les ContentSerializableContent propriétés.

Lorsque vous utilisez cette définition, le format doit être XML ; le format peut être défini avec la Format propriété.

Save(String)

Enregistre les données et les propriétés du graphique avec des valeurs non par défaut dans le fichier donné.

public:
 void Save(System::String ^ fileName);

public void Save(string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Paramètres

fileName

String

Chemin d’accès relatif ou absolu du fichier utilisé pour stocker les données sérialisées. Notez que si un chemin relatif est spécifié, le chemin d’accès est relatif au répertoire actif.

Remarques

Par défaut, toutes les propriétés de graphique avec des valeurs non par défaut, qui incluent des points de données, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique à sérialiser, utilisez les propriétés et NonSerializableContent les ContentSerializableContent propriétés.

Par défaut, les données sont enregistrées dans un format XML. Pour enregistrer les données dans un format binaire, utilisez la Format propriété.

Notez que les autorisations d’écriture doivent être activées pour le répertoire dans lequel le fichier est stocké. Par défaut, il s’agit du dossier Bin de l’application.

Si cette méthode est utilisée pour enregistrer les propriétés d’apparence en tant que modèle, vérifiez que la IsTemplateMode propriété est d’abord définie true avant d’appeler cette méthode.

La sérialisation d’un graphique en tant que modèle se poursuit différemment de la sérialisation non-modèle, principalement parce que la sérialisation de modèle se concentre sur les propriétés d’apparence.

Lorsqu’un modèle est sérialisé, la LoadTemplate méthode peut être utilisée pour charger le modèle afin de fournir les propriétés d’apparence d’un graphique.

Les modèles peuvent être utilisés pour simuler des palettes personnalisées.