ChartSerializer Classe

Definição

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Habilita a serialização do controle Chart.

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

Herança

Object

ChartSerializer

Comentários

Essa classe é exposta como a Serializer propriedade da classe raiz Chart .

A serialização salva o estado do gráfico e também fornece a opção de carregar os dados serializados no gráfico. Todas as propriedades do gráfico podem ser mantidas, incluindo os dados do gráfico. Além disso, todas as propriedades do gráfico marcadas para serialização podem ser redefinidas.

Opcionalmente, essa classe pode ser usada ao gerenciar o estado de exibição definido pelo usuário. Um de seus Load métodos pode ser usado para carregar o estado de exibição e um dos Save métodos pode ser usado ao definir o estado de exibição.

Os formatos XML ou binário podem ser usados para armazenar dados serializados. XML é usado por padrão, mas você pode alterar o formato com a Format propriedade .

As propriedades do gráfico são salvas e carregadas usando os Save métodos e Load , respectivamente. Observe que somente propriedades com valores não padrão serão salvas. Os dados podem ser salvos e/ou carregados usando um arquivo, fluxo, TextWriter, TextReaderXmlWriter e XmlReader objetos. Ao salvar e/ou carregar dados usando um objeto derivado das TextReaderclasses , TextWriterou XmlReaderXmlWriter , o formato dos dados deve ser XML.

A lista a seguir descreve três técnicas, do básico ao avançado, usadas para definir dados serializáveis. Observe que também é possível definir dados não serializáveis. Essa técnica é descrita no próximo parágrafo.

• Serialize o Chart usando os Save métodos e Load , sem especificar nenhuma propriedade serializável. Todas as propriedades do gráfico com valores não padrão, que incluem dados do gráfico, serão serializadas.

• Serialize as propriedades do gráfico especificadas pela Content propriedade . A Content propriedade agrupa as propriedades do gráfico a serem serializadas em categorias como Dados, Aparência e assim por diante. Observe que os nomes de ChartArea e Series objetos são serializados automaticamente; os dados serializados são aplicados a áreas e séries de gráficos existentes quando carregados.

Importante

A Content propriedade é implementada internamente pelo Chart controle como a SerializableContent propriedade

• Serialização de propriedades do gráfico especificadas pela SerializableContent propriedade . Essa é uma listagem separada por vírgulas de todas as propriedades do gráfico que são serializáveis. Depois que essa propriedade é definida como um valor explícito, é responsabilidade do desenvolvedor especificar todas as propriedades a serem salvas. Em outras palavras, ao contrário da Content propriedade , os nomes das áreas e séries do gráfico não serão mantidos automaticamente. As Content propriedades e SerializableContent também podem ser usadas em conjunto. No entanto, certifique-se de que SerializableContent seja concatenado consigo mesmo ao ser definido, caso contrário, as propriedades do gráfico especificadas pela Content propriedade serão substituídas.

Para proibir que determinadas propriedades sejam serializadas, use a NonSerializableContent propriedade . Quando uma propriedade é definida como serializável e não serializável, o que é comum quando curingas são usados, a SerializableContent propriedade tem precedência. No entanto, a precedência também depende de quantos curingas foram usados quando uma propriedade foi especificada.

Por padrão, as propriedades serializáveis são redefinidas para seus padrões antes de serem carregadas. Esse comportamento pode ser alterado usando a IsResetWhenLoading propriedade . O Reset método também pode ser usado para redefinir explicitamente as propriedades do gráfico para seus valores padrão.

Propriedades

Content	Obtém ou define o tipo de conteúdo do gráfico a ser serializado.
Format	Obtém ou define o formato usado quando o gráfico é serializado.
IsResetWhenLoading	Obtém ou define um sinalizador que indica se as propriedades do objeto são redefinidas para os valores padrão antes do carregamento.
IsTemplateMode	Obtém ou define um sinalizador que indica se o serializador de gráfico está funcionando no modo de criação de modelo.
IsUnknownAttributeIgnored	Obtém ou define um sinalizador que indica se as propriedades e elementos XML desconhecidos serão ignorados sem geração de uma exceção.
NonSerializableContent	Obtém ou define as propriedades do gráfico que não serão serializadas.
SerializableContent	Obtém ou define as propriedades do gráfico que podem ser serializados.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetContentString(SerializationContents, Boolean)	Retorna uma classe serializável ou não serializável e/ou nomes de propriedade, dependendo do valor de sinalizador específico.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
Load(Stream)	Carrega os dados serializados no controle de um objeto derivado da classe Stream.
Load(String)	Carrega dados serializados salvos em disco no controle Chart.
Load(TextReader)	Carrega os dados serializados no controle de um objeto reader derivado da classe TextReader.
Load(XmlReader)	Carrega os dados serializados no controle de um objeto derivado da classe XmlReader.
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Reset()	Redefine todas as propriedades do gráfico marcadas para serialização.
Save(Stream)	Salva dados e propriedades do gráfico com valores não padrão para um objeto que deriva da classe Stream.
Save(String)	Salva dados do gráfico e propriedades com valores não padrão para o arquivo especificado.
Save(TextWriter)	Salva dados e propriedades do gráfico com valores não padrão para o objeto fornecido que é derivado da classe TextWriter.
Save(XmlWriter)	Salva dados e propriedades do gráfico com valores não padrão para o objeto fornecido que é derivado da classe XmlWriter.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)