ChartSerializer.Save Método

Definição

Namespace:

System.Windows.Forms.DataVisualization.Charting

Assembly:

System.Windows.Forms.DataVisualization.dll

Salva as propriedades do gráfico que têm valores não padrão. Todas as propriedades do gráfico podem ser serializadas; isso inclui dados.

Sobrecargas

Save(XmlWriter)	Salva dados e propriedades do gráfico com valores não padrão para o objeto fornecido que é derivado da classe XmlWriter.
Save(Stream)	Salva dados e propriedades do gráfico com valores não padrão para um objeto que deriva da classe Stream.
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(String)	Salva dados do gráfico e propriedades com valores não padrão para o arquivo especificado.

Save(XmlWriter)

Salva dados e propriedades do gráfico com valores não padrão para o objeto fornecido que é derivado da classe XmlWriter.

public:
 void Save(System::Xml::XmlWriter ^ writer);

public void Save (System.Xml.XmlWriter writer);

member this.Save : System.Xml.XmlWriter -> unit

Public Sub Save (writer As XmlWriter)

Parâmetros

writer

XmlWriter

Um objeto derivado de XmlWriter usado para salvar propriedades Chart.

Comentários

Por padrão, todas as propriedades de gráfico com valores não padrão, que incluem pontos de dados, serão serializadas quando esse método for chamado. Para controlar quais características de gráfico são serializadas, use as Content SerializableContent NonSerializableContent Propriedades e.

Quando você usa essa definição, o formato deve ser XML; o formato pode ser alterado com a Format propriedade.

Ao trabalhar com arquivos de texto em formato XML, para simplificar, use o Save método.

Save(Stream)

Salva dados e propriedades do gráfico com valores não padrão para um objeto que deriva da classe Stream.

public:
 void Save(System::IO::Stream ^ stream);

public void Save (System.IO.Stream stream);

member this.Save : System.IO.Stream -> unit

Public Sub Save (stream As Stream)

Parâmetros

stream

Stream

Um objeto derivado da classe Stream, tal como MemoryStream, que é usado para salvar as propriedades do gráfico.

Comentários

Por padrão, todas as propriedades de gráfico com valores não padrão, que incluem pontos de dados, serão serializadas quando esse método for chamado. Para controlar as características do gráfico a serem serializadas, use as Content SerializableContent NonSerializableContent Propriedades e.

Se esse método for usado para salvar as propriedades de aparência como um modelo, certifique-se de que a IsTemplateMode Propriedade do ChartSerializer objeto seja definida primeiro como true antes de chamar esse método.

A serialização de um gráfico como um modelo ocorre de forma diferente da serialização não modelo; a serialização de modelo concentra-se nas propriedades de aparência.

Quando um modelo é serializado, o LoadTemplate método pode ser usado para carregar o modelo, para fornecer as propriedades de aparência de um gráfico.

Os modelos podem ser usados para simular paletas personalizadas.

Save(TextWriter)

Salva dados e propriedades do gráfico com valores não padrão para o objeto fornecido que é derivado da classe TextWriter.

public:
 void Save(System::IO::TextWriter ^ writer);

public void Save (System.IO.TextWriter writer);

member this.Save : System.IO.TextWriter -> unit

Public Sub Save (writer As TextWriter)

Parâmetros

writer

TextWriter

Um objeto derivado da classe TextWriter, por exemplo, StringWriter, que é usado para salvar as propriedades do gráfico.

Comentários

Por padrão, todas as propriedades de gráfico com valores não padrão, que incluem pontos de dados, serão serializadas quando esse método for chamado. Para controlar quais características de gráfico são serializadas, use as Content SerializableContent NonSerializableContent Propriedades e.

Quando você usa essa definição, o formato deve ser XML; o formato pode ser definido com a Format propriedade.

Save(String)

Salva dados do gráfico e propriedades com valores não padrão para o arquivo especificado.

public:
 void Save(System::String ^ fileName);

public void Save (string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

Parâmetros

fileName

String

O caminho relativo ou absoluto do arquivo usado para armazenar os dados serializados. Observe que, se um caminho relativo for especificado, o caminho será relativo ao diretório atual.

Comentários

Por padrão, todas as propriedades de gráfico com valores não padrão, que incluem pontos de dados, serão serializadas quando esse método for chamado. Para controlar as características do gráfico a serem serializadas, use as Content SerializableContent NonSerializableContent Propriedades e.

Por padrão, os dados são salvos em um formato XML. Para salvar os dados em um formato binário, use a Format propriedade.

Observe que as permissões de gravação devem ser habilitadas para o diretório no qual o arquivo está armazenado. Por padrão, essa é a pasta bin do aplicativo.

Se esse método estiver sendo usado para salvar propriedades de aparência como um modelo, certifique-se de que a IsTemplateMode propriedade é definida primeiro como true antes de chamar esse método.

A serialização de um gráfico como um modelo prossegue de forma diferente da serialização não modelo, principalmente porque a serialização de modelo se concentra nas propriedades de aparência.

Quando um modelo é serializado, o LoadTemplate método pode ser usado para carregar o modelo, para fornecer as propriedades de aparência de um gráfico.

Os modelos podem ser usados para simular paletas personalizadas.