ChartSerializer Classe

Definição

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.

Essa classe pode ser usada opcionalmente 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 métodos e Load os Save métodos, respectivamente. Observe que somente as propriedades com valores não padrão serão salvas. Os dados podem ser salvos e/ou carregados usando um arquivo, TextWriterTextReaderXmlWriter fluxo e XmlReader objetos. Ao salvar e/ou carregar dados usando um objeto derivado de TextReader, TextWriterXmlReader ou XmlWriter classes, 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 uso e Load os Save métodos, 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 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.

• Serialização das propriedades do gráfico especificadas pela SerializableContent propriedade. Esta é 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 do gráfico e da série não serão mantidos automaticamente. O e SerializableContent as Content propriedades também podem ser usados em conjunto. No entanto, verifique se isso SerializableContent é 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 caracteres 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.