ChartSerializer.Save 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,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)
参数
注解
默认情况下,当调用此方法时,将序列化所有具有非默认值的图表属性,这些属性包含数据点。 若要控制序列化哪些图表特征,请使用 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 可以使用方法加载模板,以提供图表的外观属性。
模板可用于模拟自定义调色板。