ChartSerializer.Save Método

Definición

Espacio de nombres:

System.Windows.Forms.DataVisualization.Charting

Ensamblado:

System.Windows.Forms.DataVisualization.dll

Guarda las propiedades del gráfico que tienen valores no predeterminados. Todas las propiedades del gráfico se pueden serializar; esto incluye datos.

Sobrecargas

Nombre	Description
Save(XmlWriter)	Guarda los datos y propiedades del gráfico con valores no predeterminados en el objeto especificado que se deriva de la XmlWriter clase .
Save(Stream)	Guarda los datos y propiedades del gráfico con valores no predeterminados en un objeto que deriva de la Stream clase .
Save(TextWriter)	Guarda los datos y propiedades del gráfico con valores no predeterminados en el objeto especificado que se deriva de la TextWriter clase .
Save(String)	Guarda los datos y propiedades del gráfico con valores no predeterminados en el archivo especificado.

Save(XmlWriter)

Guarda los datos y propiedades del gráfico con valores no predeterminados en el objeto especificado que se deriva de la XmlWriter clase .

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)

Parámetros

writer

XmlWriter

Objeto derivado de XmlWriter usado para guardar Chart propiedades.

Comentarios

De forma predeterminada, todas las propiedades del gráfico con valores no predeterminados, que incluyen puntos de datos, se serializarán cuando se llame a este método. Para controlar qué características de gráfico se serializan, use las Contentpropiedades y NonSerializableContentSerializableContent .

Cuando se usa esta definición, el formato debe ser XML; el formato se puede cambiar con la Format propiedad .

Cuando se trabaja con archivos de texto de formato XML, por motivos de simplicidad, use el Save método en su lugar.

Save(Stream)

Guarda los datos y propiedades del gráfico con valores no predeterminados en un objeto que deriva de la Stream clase .

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)

Parámetros

stream

Stream

Objeto derivado de la Stream clase , como MemoryStream, que se usa para guardar las propiedades del gráfico.

Comentarios

De forma predeterminada, todas las propiedades del gráfico con valores no predeterminados, que incluyen puntos de datos, se serializarán cuando se llame a este método. Para controlar las características del gráfico que se van a serializar, use las Contentpropiedades , SerializableContent y NonSerializableContent .

Si este método se usa para guardar propiedades de apariencia como plantilla, asegúrese de que la IsTemplateMode propiedad del ChartSerializer objeto se establece true primero en antes de llamar a este método.

La serialización de un gráfico como plantilla se produce de forma diferente a la serialización que no es de plantilla; la serialización de plantillas se centra en las propiedades De apariencia.

Cuando se serializa una plantilla, el LoadTemplate método se puede usar para cargar la plantilla para proporcionar las propiedades Apariencia de un gráfico.

Las plantillas se pueden usar para simular paletas personalizadas.

Save(TextWriter)

Guarda los datos y propiedades del gráfico con valores no predeterminados en el objeto especificado que se deriva de la TextWriter clase .

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)

Parámetros

writer

TextWriter

Objeto derivado de TextWriter la clase , por ejemplo, StringWriter, que se usa para guardar las propiedades del gráfico.

Comentarios

De forma predeterminada, todas las propiedades del gráfico con valores no predeterminados, que incluyen puntos de datos, se serializarán cuando se llame a este método. Para controlar qué características de gráfico se serializan, use las Contentpropiedades y NonSerializableContentSerializableContent .

Cuando se usa esta definición, el formato debe ser XML; el formato se puede establecer con la Format propiedad .

Save(String)

Guarda los datos y propiedades del gráfico con valores no predeterminados en el archivo especificado.

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

public void Save(string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Parámetros

fileName

String

Ruta de acceso relativa o absoluta del archivo que se usa para almacenar los datos serializados. Tenga en cuenta que si se especifica una ruta de acceso relativa, la ruta de acceso será relativa al directorio actual.

Comentarios

De forma predeterminada, todas las propiedades del gráfico con valores no predeterminados, que incluyen puntos de datos, se serializarán cuando se llame a este método. Para controlar las características del gráfico que se van a serializar, use las Contentpropiedades y SerializableContentNonSerializableContent .

De forma predeterminada, los datos se guardan en formato XML. Para guardar los datos en un formato binario, use la Format propiedad .

Tenga en cuenta que los permisos de escritura deben estar habilitados para el directorio en el que se almacena el archivo. De forma predeterminada, esta es la carpeta Bin de la aplicación.

Si este método se usa para guardar las propiedades De apariencia como plantilla, asegúrese de que la IsTemplateMode propiedad se establece true primero en antes de llamar a este método.

La serialización de un gráfico como plantilla continúa de forma diferente a la serialización que no es de plantilla, principalmente porque la serialización de plantillas se centra en las propiedades De apariencia.

Cuando se serializa una plantilla, el LoadTemplate método se puede usar para cargar la plantilla para proporcionar las propiedades Apariencia de un gráfico.

Las plantillas se pueden usar para simular paletas personalizadas.