ChartSerializer Classe

Definição

Namespace:

System.Web.UI.DataVisualization.Charting

Assembly:

System.Web.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 persistidas, incluindo os dados do gráfico. Além disso, todas as propriedades de gráfico marcadas para serialização podem ser redefinidas.

Essa classe pode, opcionalmente, 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ários podem ser usados para armazenar dados serializados. O 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 Load métodos e, respectivamente. Observe que somente as propriedades com valores não padrão serão salvas. Os dados podem ser salvos e/ou carregados usando objetos File, Stream,, TextWriter TextReader XmlWriter e XmlReader . Ao salvar e/ou carregar dados usando um objeto derivado das TextReader classes, TextWriter XmlReader ou XmlWriter , o formato dos dados deve ser XML.

A lista a seguir descreve três técnicas, de básico para 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 Load métodos e, sem especificar nenhuma propriedade serializável. Todas as propriedades de gráfico com valores não padrão, que incluem dados de 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, por exemplo, dados, aparência e assim por diante. Observe que os nomes dos ChartArea Series objetos e são serializados automaticamente; os dados serializados são aplicados às áreas de gráfico existentes e à série quando carregados.

Importante

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

• Serialização das propriedades do gráfico especificadas pela SerializableContent propriedade. Esta é uma listagem separada por vírgulas de todas as propriedades de 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 do gráfico e da série não serão persistidos automaticamente. As Content SerializableContent Propriedades e também podem ser usadas em conjunto. No entanto, certifique-se de que SerializableContent o está concatenado com ele mesmo quando 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, que é comum quando caracteres curinga 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)