ChartSerializer.Save 方法

定义

命名空间:: System.Windows.Forms.DataVisualization.Charting

程序集:: System.Windows.Forms.DataVisualization.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

保存具有非默认值的图表属性。可以序列化所有图表属性;这包括数据。

重载

名称	说明
Save(XmlWriter)	将具有非默认值的图表数据和属性保存到派生自类的 XmlWriter 给定对象。
Save(Stream)	将具有非默认值的图表数据和属性保存到派生自类的对象 Stream 。
Save(TextWriter)	将具有非默认值的图表数据和属性保存到派生自类的 TextWriter 给定对象。
Save(String)	将具有非默认值的图表数据和属性保存到给定文件。

Save(XmlWriter)

将具有非默认值的图表数据和属性保存到派生自类的 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)

参数

writer: XmlWriter

派生自 XmlWriter 用于保存 Chart 属性的对象。

注解

默认情况下，调用此方法时，将序列化包含数据点的非默认值的所有图表属性。若要控制哪些图表特征是序列化的，请使用Content SerializableContent和NonSerializableContent属性。

使用此定义时，格式必须为 XML;可以使用属性更改 Format 格式。

使用 XML 格式化文本文件时，为简单起见，请改用该方法 Save 。

适用于

Save(Stream)

将具有非默认值的图表数据和属性保存到派生自类的对象 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)

参数

stream: Stream

派生自 Stream 类的对象，例如 MemoryStream用于保存图表属性的对象。

注解

默认情况下，调用此方法时，将序列化包含数据点的非默认值的所有图表属性。若要控制要序列化的图表特征，请使用Content SerializableContent和NonSerializableContent属性。

如果此方法用于将外观属性保存为模板，请确保IsTemplateMode在调用此方法之前先将对象的属性设置为true该属性ChartSerializer。

以模板形式序列化图表的方式与非模板序列化不同;模板序列化侧重于外观属性。

序列化模板时， LoadTemplate 该方法可用于加载模板，以提供图表的外观属性。

模板可用于模拟自定义调色板。

适用于

Save(TextWriter)

将具有非默认值的图表数据和属性保存到派生自类的 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)

参数

writer: TextWriter

从类派生 TextWriter 的对象，例如， StringWriter用于保存图表属性。

注解

使用此定义时，格式必须为 XML;可以使用属性设置 Format 格式。

适用于

Save(String)

将具有非默认值的图表数据和属性保存到给定文件。

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

public void Save(string fileName);

member this.Save : string -> unit

Public Sub Save (fileName As String)

参数

fileName: String

用于存储序列化数据的文件的相对或绝对路径。请注意，如果指定了相对路径，则路径将相对于当前目录。

注解

默认情况下，调用此方法时，将序列化包含数据点的非默认值的所有图表属性。若要控制要序列化的图表特征，SerializableContent请使用Content和NonSerializableContent属性。

默认情况下，数据以 XML 格式保存。若要以二进制格式保存数据，请使用 Format 该属性。

请注意，必须为存储文件的目录启用写入权限。默认情况下，这是应用程序的 Bin 文件夹。

如果使用此方法将外观属性保存为模板，请确保在 IsTemplateMode 调用此方法之前先将该属性设置为 true 该属性。

以模板形式序列化图表的方式与非模板序列化不同，主要是因为模板序列化侧重于外观属性。