ChartSerializer Classe

Definição

Espaço de Nomes:
System.Web.UI.DataVisualization.Charting
Assemblagem:
System.Web.DataVisualization.dll

Permite a serialização do Chart controlo.

public ref class ChartSerializer
public class ChartSerializer
type ChartSerializer = class
Public Class ChartSerializer
Herança
Object
ChartSerializer

Observações

Esta classe é exposta como propriedade Serializer da classe raiz.Chart

A serialização guarda o estado do mapa e também oferece a opção de carregar os dados serializados no gráfico. Todas as propriedades do mapa podem ser preservadas, incluindo os dados do mapa. Além disso, todas as propriedades do mapa marcadas para serialização podem ser reiniciadas.

Esta classe pode ser opcionalmente usada na gestão do estado da vista definida pelo utilizador. Um dos seus Load métodos pode ser usado para carregar o estado da vista, e um dos Save métodos pode ser usado ao definir o estado da vista.

Os formatos XML ou binários podem ser usados para armazenar dados serializados. XML é usado por defeito, mas podes mudar o formato com essa Format propriedade.

As propriedades do gráfico são guardadas e carregadas usando os Save métodos e Load , respetivamente. Note que apenas propriedades com valores não predefinidos serão guardadas. Os dados podem ser guardados e/ou carregados usando um ficheiro, stream, TextWriter, TextReader, XmlWriter e XmlReader objetos. Ao gravar e/ou carregar dados usando um objeto derivado das TextReaderclasses, TextWriter, XmlReader o formato XmlWriter dos dados deve ser XML.

A lista seguinte descreve três técnicas, das básicas às avançadas, usadas para definir dados serializáveis. Note-se que também é possível definir dados não serializáveis. Esta técnica é descrita no parágrafo seguinte.

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

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

Importante

A Content propriedade é implementada internamente pelo Chart controlo enquanto a SerializableContent propriedade

  • Serialização das propriedades do mapa especificadas pela SerializableContent propriedade. Esta é uma listagem separada por vírgulas de todas as propriedades do mapa que são serializáveis. Depois de esta propriedade ser definida com um valor explícito, é responsabilidade do promotor especificar todas as propriedades a salvar. Ou seja, ao contrário da Content propriedade, os nomes das áreas e séries do mapa não serão automaticamente mantidos. As Content propriedades e SerializableContent também podem ser usadas em conjunção. No entanto, certifique-se de que está SerializableContent concatenado consigo próprio quando for definido, caso contrário as propriedades do gráfico especificadas pela Content propriedade serão sobrepostas.

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

Por defeito, as propriedades serializáveis são redefinidas para os seus valores antes de serem carregadas. Este 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 os seus valores padrão.

Propriedades

Name Description
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

Recebe ou define uma flag que indica se as propriedades do objeto são redefinidas para valores predefinidos antes do carregamento.
IsTemplateMode

Recebe ou define uma flag que indica se o serializador de gráficos está a funcionar em modo de criação de templates.
IsUnknownAttributeIgnored

Recebe ou define um flag que indica se propriedades e elementos XML desconhecidos serão ignorados sem lançar 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 serializadas.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetContentString(SerializationContents, Boolean)

Devolve uma classe e/ou nomes de propriedades serializáveis ou não serializáveis, dependendo do valor específico da bandeira.
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
Load(Stream)

Carrega dados serializados no controlo a partir de um objeto derivado da Stream classe.
Load(String)

Carrega os dados serializados guardados no disco no Chart controlo.
Load(TextReader)

Carrega dados serializados no controlo a partir de um objeto leitor que deriva da TextReader classe.
Load(XmlReader)

Carrega dados serializados no controlo a partir de um objeto derivado da XmlReader classe.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Reset()

Reinicia todas as propriedades do mapa marcadas para serialização.
Save(Stream)

Guarda os dados do gráfico e propriedades com valores não predefinidos para um objeto que deriva da Stream classe.
Save(String)

Guarda dados gráficos e propriedades com valores não padrão no ficheiro dado.
Save(TextWriter)

Guarda dados de gráficos e propriedades com valores não padrão para o objeto dado que é derivado da TextWriter classe.
Save(XmlWriter)

Guarda dados de gráficos e propriedades com valores não padrão para o objeto dado que é derivado da XmlWriter classe.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a