Partager via

ChartSerializer.Save Méthode

  • Référence

Définition

Espace de noms:
System.Windows.Forms.DataVisualization.Charting
Assembly:
System.Windows.Forms.DataVisualization.dll

Enregistre des propriétés de graphique dont les valeurs ne sont pas par défaut. Toutes les propriétés de graphique peuvent être sérialisées, y compris les données.

Surcharges

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.
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(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(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(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.

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 la classe XmlWriter qui est utilisé pour enregistrer les propriétés Chart.

Remarques

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

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

Lorsque vous travaillez avec des fichiers texte au format XML, pour plus de simplicité, utilisez Save plutôt la méthode.

S’applique à

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.

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 classe Stream, tel que MemoryStream, qui est utilisé pour enregistrer les propriétés de graphique.

Remarques

Par défaut, toutes les propriétés de graphique avec des valeurs autres que celles par défaut, qui incluent des points de données, seront sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques de graphique à sérialiser, utilisez Content les SerializableContent Propriétés, et NonSerializableContent .

Si cette méthode est utilisée pour enregistrer les propriétés d’apparence en tant que modèle, assurez-vous que la IsTemplateMode propriété de l' ChartSerializer objet est définie en premier 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 sans modèle ; la sérialisation du 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.

S’applique à

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.

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 la classe TextWriter (par exemple, StringWriter) qui est utilisé pour enregistrer les propriétés de graphique.

Remarques

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

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

S’applique à

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é.

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 d'accès relatif est spécifié, il est relatif par rapport au répertoire actif.

Remarques

Par défaut, toutes les propriétés de graphique avec des valeurs autres que celles par défaut, qui incluent des points de données, seront sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques de graphique à sérialiser, utilisez les Content SerializableContent Propriétés, et NonSerializableContent .

Par défaut, les données sont enregistrées au 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, assurez-vous que la IsTemplateMode propriété a d’abord la valeur 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 sans modèle, principalement parce que la sérialisation du 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.

S’applique à