ChartSerializer.Save Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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.
Aplica-se a
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.
Aplica-se a
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.
Se a ViewStateData Propriedade do Chart controle for usada para persistir o estado, esse método poderá ser usado para salvar os dados serializados em um objeto derivado de TextWriter , que é usado para gravar os dados na ViewStateData propriedade.
Aplica-se a
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.