ChartSerializer Clase

Definición

Espacio de nombres:

System.Windows.Forms.DataVisualization.Charting

Ensamblado:

System.Windows.Forms.DataVisualization.dll

Permite la serialización del control Chart.

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Herencia

Object

ChartSerializer

Comentarios

Esta clase se expone como la Serializer propiedad de la clase raíz Chart .

La serialización guarda el estado del gráfico y también proporciona la opción de cargar los datos serializados en el gráfico. Todas las propiedades del gráfico se pueden conservar, incluidos los datos del gráfico. Además, se pueden restablecer todas las propiedades del gráfico marcadas para la serialización.

Opcionalmente, esta clase se puede usar al administrar el estado de vista definido por el usuario. Uno de sus Load métodos se puede usar para cargar el estado de vista y se puede usar uno de los Save métodos al establecer el estado de vista.

Los formatos XML o binarios se pueden usar para almacenar datos serializados. XML se usa de forma predeterminada, pero puede cambiar el formato con la Format propiedad .

Las propiedades del gráfico se guardan y cargan mediante los Save métodos y Load , respectivamente. Tenga en cuenta que solo se guardarán las propiedades con valores no predeterminados. Los datos se pueden guardar o cargar mediante un archivo, secuencia, TextWriter, TextReaderXmlWriter y XmlReader objetos . Al guardar o cargar datos mediante un objeto derivado de las TextReaderclases , TextWriterXmlReader o XmlWriter , el formato de los datos debe ser XML.

En la lista siguiente se describen tres técnicas, de básicas a avanzadas, usadas para definir datos serializables. Tenga en cuenta que también es posible definir datos no serializables. Esta técnica se describe en el párrafo siguiente.

• Serialice el Chart uso de los Save métodos y Load , sin especificar ninguna propiedad serializable. Todas las propiedades del gráfico con valores no predeterminados, que incluyen los datos del gráfico, se serializarán.

• Serialice las propiedades del gráfico especificadas por la Content propiedad . La Content propiedad agrupa las propiedades del gráfico que se van a serializar en categorías como Datos, Apariencia, etc. Tenga en cuenta que los nombres de ChartArea los objetos y Series se serializan automáticamente; los datos serializados se aplican a las áreas y series de gráficos existentes cuando se cargan.

Importante

El Content control implementa internamente la Chart propiedad como la SerializableContent propiedad .

• Serialización de las propiedades del gráfico especificadas por la SerializableContent propiedad . Se trata de una lista separada por comas de todas las propiedades del gráfico que son serializables. Una vez establecida esta propiedad en un valor explícito, es responsabilidad del desarrollador especificar todas las propiedades que se van a guardar. En otras palabras, a diferencia de la Content propiedad , los nombres de las áreas de gráfico y la serie no se conservarán automáticamente. Las Content propiedades y SerializableContent también se pueden usar conjuntamente. Sin embargo, asegúrese de que SerializableContent se concatena con sí mismo al establecerse; de lo contrario, las propiedades del gráfico especificadas por la Content propiedad se invalidarán.

Para prohibir que ciertas propiedades se serialicen, use la NonSerializableContent propiedad . Cuando se establece una propiedad como serializable y no serializable, que es común cuando se usan caracteres comodín, la SerializableContent propiedad tiene prioridad. Sin embargo, la precedencia también depende del número de caracteres comodín que se usaron cuando se especificó una propiedad.

De forma predeterminada, las propiedades serializables se restablecen a sus valores predeterminados antes de cargarlas. Este comportamiento se puede cambiar mediante la IsResetWhenLoading propiedad . El Reset método también se puede usar para restablecer explícitamente las propiedades del gráfico a sus valores predeterminados.

Propiedades

Content	Obtiene o establece el tipo de contenido del gráfico que se va a serializar.
Format	Obtiene o establece el formato usado cuando se serializa el gráfico.
IsResetWhenLoading	Obtiene o establece una marca que indica si las propiedades de objeto se restablecen a los valores predeterminados antes de la carga.
IsTemplateMode	Obtiene o establece una marca que indica si el serializador de gráfico está en modo de creación de plantilla.
IsUnknownAttributeIgnored	Obtiene o establece una marca que indica si las propiedades y los elementos XML desconocidos se pasarán por alto sin producir una excepción.
NonSerializableContent	Obtiene o establece las propiedades de gráfico que no se serializarán.
SerializableContent	Obtiene o establece las propiedades de gráfico que se pueden serializar.

Métodos

Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetContentString(SerializationContents, Boolean)	Devuelve una clase serializable o no serializable o nombres de propiedad, según el valor concreto de la marca.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
Load(Stream)	Carga datos serializados en el control desde un objeto derivado de la clase Stream.
Load(String)	Carga datos serializados guardados en disco en el control Chart.
Load(TextReader)	Carga datos serializados en el control desde un objeto de lector que deriva de la clase TextReader.
Load(XmlReader)	Carga datos serializados en el control desde un objeto derivado de la clase XmlReader.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Reset()	Restablece todas las propiedades de gráfico marcadas para la serialización.
Save(Stream)	Guarda datos y propiedades de gráfico con valores no predeterminados en un objeto que se deriva de la clase Stream.
Save(String)	Guarda datos y propiedades de gráfico con valores no predeterminados en el archivo dado.
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(XmlWriter)	Guarda datos y propiedades de gráfico con valores no predeterminados en el objeto dado que se deriva de la clase XmlWriter.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)