ChartSerializer.Save Método

Definição

Espaço de Nomes:: System.Windows.Forms.DataVisualization.Charting

Assemblagem:: System.Windows.Forms.DataVisualization.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Guarda propriedades de gráficos que têm valores não predefinidos. Todas as propriedades do mapa podem ser serializadas; Isto inclui dados.

Sobrecargas

Name	Description
Save(XmlWriter)	Guarda dados de gráficos e propriedades com valores não padrão para o objeto dado que é derivado da XmlWriter classe.
Save(Stream)	Guarda os dados do gráfico e propriedades com valores não predefinidos para um objeto que deriva da Stream classe.
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(String)	Guarda dados gráficos e propriedades com valores não padrão no ficheiro dado.

Save(XmlWriter)

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

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 used to save Chart properties.

Observações

Por defeito, todas as propriedades do gráfico com valores não predefinidos, incluindo pontos de dados, serão serializadas quando este método for chamado. Para controlar quais as características do mapa que são serializadas, use as Contentpropriedades , SerializableContent e NonSerializableContent .

Quando se usa esta definição, o formato deve ser XML; O formato pode ser alterado com a Format propriedade.

Quando trabalha com ficheiros de texto em formato XML, para simplificar use o Save método em vez disso.

Aplica-se a

Save(Stream)

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

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 Stream classe, como MemoryStream, que é usado para guardar propriedades do mapa.

Observações

Por defeito, todas as propriedades do gráfico com valores não predefinidos, incluindo pontos de dados, serão serializadas quando este método for chamado. Para controlar as características do mapa a serem serializadas, use as Contentpropriedades , SerializableContent e NonSerializableContent .

Se este método for usado para guardar propriedades de aparência como modelo, certifique-se de que a IsTemplateMode propriedade do ChartSerializer objeto está primeiro definida como true antes de chamar este método.

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

Quando um template é serializado, o LoadTemplate método pode ser usado para carregar o template, fornecendo as propriedades de Aparência para um gráfico.

Os templates podem ser usados para simular paletas personalizadas.

Aplica-se a

Save(TextWriter)

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

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 TextWriter classe, por exemplo, StringWriter, que é usado para guardar propriedades do gráfico.

Observações

Quando se usa esta definição, o formato deve ser XML; o formato pode ser definido com a Format propriedade.

Aplica-se a

Save(String)

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

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 ficheiro usado para armazenar os dados serializados. Note que, se for especificado um caminho relativo, o caminho será relativo ao diretório atual.

Observações

Por defeito, todas as propriedades do gráfico com valores não predefinidos, incluindo pontos de dados, serão serializadas quando este método for chamado. Para controlar as características do mapa a serializar, utilize-se as Contentpropriedades , SerializableContent e NonSerializableContent .

Por defeito, os dados são guardados num formato XML. Para guardar os dados num formato binário, use a Format propriedade.

Note que as permissões de escrita devem estar ativadas para o diretório onde o ficheiro está armazenado. Por defeito, esta é a pasta Bin da aplicação.

Se este método estiver a ser usado para guardar propriedades de Aparência como modelo, certifique-se de que a IsTemplateMode propriedade está primeiro definida como true antes de chamar este método.

A serialização de um gráfico como modelo procede de forma diferente da serialização não-template, principalmente porque a serialização de templates se concentra nas propriedades da Aparência.

Quando um template é serializado, o LoadTemplate método pode ser usado para carregar o template, fornecendo as propriedades de Aparência para um gráfico.

Os templates podem ser usados para simular paletas personalizadas.

Aplica-se a

Comentários

Esta página foi útil?