Partager via


ChartSerializer.Save Méthode

Définition

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, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique qui sont sérialisées, utilisez les Contentpropriétés et SerializableContentNonSerializableContent .

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

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, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique à sérialiser, utilisez les Contentpropriétés et SerializableContentNonSerializableContent .

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’objet ChartSerializer est d’abord définie sur 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 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, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique qui sont sérialisées, utilisez les Contentpropriétés et SerializableContentNonSerializableContent .

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

Si la ViewStateData propriété du contrôle est utilisée pour conserver l’état Chart , cette méthode peut être utilisée pour enregistrer les données sérialisées dans un objet dérivé de TextWriter, qui est ensuite utilisé pour écrire les données dans la ViewStateData 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, sont sérialisées lorsque cette méthode est appelée. Pour contrôler les caractéristiques du graphique à sérialiser, utilisez les Contentpropriétés et SerializableContentNonSerializableContent .

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 Appearance en tant que modèle, assurez-vous que la IsTemplateMode propriété est d’abord définie sur true avant d’appeler cette méthode.

La sérialisation d’un graphique en tant que modèle se déroule 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 Apparence d’un graphique.

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

S’applique à