ChartSerializer.Save 方法

定义

命名空间:

System.Web.UI.DataVisualization.Charting

程序集:

System.Web.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 格式。

ViewStateData如果控件的 Chart 属性用于持久保存状态，则此方法可用于将序列化的数据保存到派生自 TextWriter的对象，然后使用该对象将数据ViewStateData写入属性。

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 文件夹。

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

将图表序列化为模板与非模板序列化不同，这主要是因为模板序列化侧重于外观属性。

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

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