ChartSerializer Clase

Definición

Espacio de nombres:

System.Windows.Forms.DataVisualization.Charting

Ensamblado:

System.Windows.Forms.DataVisualization.dll

Habilita la serialización del Chart control.

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.

Esta clase se puede usar opcionalmente 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, que se usan 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 uso de Chart los Save métodos y Load , sin especificar ninguna propiedad serializable. Todas las propiedades del gráfico con valores no predeterminados, que incluyen 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 los objetos y se serializan automáticamente; los datos serializados se aplican a las áreas y Series series de ChartArea 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 se pueden serializar. 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 y series del gráfico 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

Nombre	Description
Content	Obtiene o establece el tipo de contenido del gráfico que se va a serializar.
Format	Obtiene o establece el formato utilizado cuando se serializa el gráfico.
IsResetWhenLoading	Obtiene o establece una marca que indica si las propiedades del objeto se restablecen a valores predeterminados antes de cargarse.
IsTemplateMode	Obtiene o establece una marca que indica si el serializador del gráfico funciona en modo de creación de plantillas.
IsUnknownAttributeIgnored	Obtiene o establece una marca que indica si se omitirán las propiedades y elementos XML desconocidos sin iniciar una excepción.
NonSerializableContent	Obtiene o establece las propiedades del gráfico que no se serializarán.
SerializableContent	Obtiene o establece las propiedades del gráfico que se pueden serializar.

Métodos

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