ChartSerializer.Save Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Guarda las propiedades de gráfico que tienen valores no predeterminados. Se pueden serializar todas las propiedades de gráfico; esto incluye los datos.
Sobrecargas
Save(XmlWriter) |
Guarda datos y propiedades de gráfico con valores no predeterminados en el objeto dado que se deriva de la clase XmlWriter. |
Save(Stream) |
Guarda datos y propiedades de gráfico con valores no predeterminados en un objeto que se deriva de la clase Stream. |
Save(TextWriter) |
Guarda datos y propiedades de gráfico con valores no predeterminados en el objeto dado que se deriva de la clase TextWriter. |
Save(String) |
Guarda datos y propiedades de gráfico con valores no predeterminados en el archivo dado. |
Save(XmlWriter)
Guarda datos y propiedades de gráfico con valores no predeterminados en el objeto dado que se deriva de la clase 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)
Parámetros
Comentarios
De forma predeterminada, todas las propiedades de 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 del gráfico se serializan, use Content las SerializableContent propiedades, y NonSerializableContent .
Cuando se usa esta definición, el formato debe ser XML; el formato se puede cambiar con la Format propiedad.
Al trabajar con archivos de texto de formato XML, para simplificar, use el Save método en su lugar.
Se aplica a
Save(Stream)
Guarda datos y propiedades de gráfico con valores no predeterminados en un objeto que se deriva de la clase 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)
Parámetros
- stream
- Stream
Objeto derivado de la clase Stream, como MemoryStream, que se usa para guardar propiedades de gráfico.
Comentarios
De forma predeterminada, todas las propiedades de 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 de los gráficos que se van a serializar, utilice las Content SerializableContent propiedades, y NonSerializableContent .
Si este método se usa para guardar las propiedades de apariencia como una plantilla, asegúrese de que la IsTemplateMode propiedad del ChartSerializer objeto se establece primero en true
antes de llamar a este método.
La serialización de un gráfico como una plantilla se produce de manera diferente a la serialización sin plantilla. la serialización de plantilla se concentra en las propiedades de apariencia.
Cuando se serializa una plantilla, el LoadTemplate método se puede utilizar para cargar la plantilla, con el fin de proporcionar las propiedades de apariencia de un gráfico.
Las plantillas se pueden usar para simular paletas personalizadas.
Se aplica a
Save(TextWriter)
Guarda datos y propiedades de gráfico con valores no predeterminados en el objeto dado que se deriva de la clase 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)
Parámetros
- writer
- TextWriter
Objeto derivado de la clase TextWriter, por ejemplo StringWriter, que se usa para guardar propiedades de gráfico.
Comentarios
De forma predeterminada, todas las propiedades de 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 del gráfico se serializan, use Content las SerializableContent propiedades, y NonSerializableContent .
Cuando se usa esta definición, el formato debe ser XML; el formato se puede establecer con la Format propiedad.
Si la ViewStateData propiedad del Chart control se utiliza para conservar el estado, se puede utilizar este método para guardar los datos serializados en un objeto derivado de TextWriter , que se utiliza para escribir los datos en la ViewStateData propiedad.
Se aplica a
Save(String)
Guarda datos y propiedades de gráfico con valores no predeterminados en el archivo dado.
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 absoluta o relativa del archivo usado para almacenar los datos serializados. Tenga en cuenta que si se especifica una ruta de acceso relativa, se considerará relativa al directorio actual.
Comentarios
De forma predeterminada, todas las propiedades de 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 de los gráficos que se van a serializar, use las Content SerializableContent propiedades, y NonSerializableContent .
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, se trata de la carpeta bin de la aplicación.
Si este método se usa para guardar las propiedades de apariencia como una plantilla, asegúrese de que la IsTemplateMode propiedad se establece primero en true
antes de llamar a este método.
La serialización de un gráfico como una plantilla se realiza de forma diferente a la serialización sin plantilla, principalmente porque la serialización de la plantilla se concentra en las propiedades de apariencia.
Cuando se serializa una plantilla, el LoadTemplate método se puede utilizar para cargar la plantilla, con el fin de proporcionar las propiedades de apariencia de un gráfico.
Las plantillas se pueden usar para simular paletas personalizadas.