ChartSerializer.Save 方法

定义

命名空间:

System.Windows.Forms.DataVisualization.Charting

程序集:

System.Windows.Forms.DataVisualization.dll

保存具有非默认值的图表属性。 可以对所有图表属性进行序列化，其中包括数据。

重载

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 ChartSerializer 先将对象的属性设置为， true 然后再调用此方法。

作为模板的图表序列化与非模板序列化的发生方式不同;模板序列化着重于外观属性。

序列化模板时， 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。

注解

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

使用此定义时，格式必须为 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

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

注解

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

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

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

如果使用此方法将外观属性保存为模板，请确保 IsTemplateMode 先将属性设置为， true 然后再调用此方法。

作为模板的图表序列化与非模板序列化的方式不同，主要是因为模板序列化会集中于外观属性。

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

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