ChartSerializer 类

定义

命名空间:

System.Windows.Forms.DataVisualization.Charting

程序集:

System.Windows.Forms.DataVisualization.dll

启用 Chart 控件的序列化功能。

public ref class ChartSerializer

public class ChartSerializer

type ChartSerializer = class

Public Class ChartSerializer

继承

Object

ChartSerializer

注解

此类作为 Serializer 根 Chart 类的 属性公开。

序列化会保存图表的状态，并提供将序列化数据加载到图表中的选项。 可以保留所有图表属性，包括图表的数据。 此外，可以重置标记为序列化的所有图表属性。

在管理用户定义的视图状态时，可以选择使用此类。 其 Load 方法之一可用于加载视图状态，其中一种方法 Save 可在设置视图状态时使用。

XML 或二进制格式可用于存储序列化的数据。 默认情况下使用 XML，但可以使用 属性更改格式 Format 。

图表属性分别使用 Save 和 Load 方法保存和加载。 请注意，仅保存具有非默认值的属性。 可以使用文件、流TextWriter、、 TextReaderXmlWriter 和 对象保存和XmlReader/或加载数据。 使用派生自 TextReader、 TextWriterXmlReader 或 类的对象保存和/或XmlWriter加载数据时，数据的格式必须为 XML。

以下列表介绍了用于定义可序列化数据的三种技术（从基本到高级）。 请注意，还可以定义不可序列化的数据。 下一段中将介绍此方法。

• Chart使用 Save 和 Load 方法序列化 ，而不指定任何可序列化属性。 具有非默认值（包括图表数据）的所有图表属性都将序列化。

• 序列化由 Content 属性指定的图表属性。 属性 Content 将要序列化的图表属性分组为数据、外观等类别。 请注意，和 Series 对象的名称ChartArea会自动序列化;然后，加载时，序列化的数据将应用于现有图表区域和序列。

重要

属性 Content 由 Chart 控件作为 SerializableContent 属性在内部实现

• 由 属性指定的图表属性的 SerializableContent 序列化。 这是所有可序列化的图表属性的逗号分隔列表。 此属性设置为显式值后，开发人员负责指定要保存的所有属性。 换句话说，与 属性不同 Content ，图表区域和系列的名称不会自动保留。 Content和 SerializableContent 属性也可以结合使用。 但是，请确保 SerializableContent 在设置 时与自身连接，否则将重写 由 Content 属性指定的图表属性。

若要禁止序列化某些属性，请使用 NonSerializableContent 属性。 当一个属性设置为可序列化和不可序列化（在使用通配符时很常见）时，该 SerializableContent 属性具有优先级。 但是，优先级还取决于指定属性时使用了多少个通配符。

默认情况下，可序列化属性在加载之前重置为默认值。 可以使用 属性更改 IsResetWhenLoading 此行为。 方法 Reset 还可用于将图表属性显式重置为其默认值。

属性

Content	获取或设置要序列化的图表内容的类型。
Format	获取或设置序列化图表时所使用的格式。
IsResetWhenLoading	获取或设置一个标志，该标志指示是否将对象属性重置为加载之前的默认值。
IsTemplateMode	获取或设置指示图表序列化程序是否在模板创建模式下运行的标志。
IsUnknownAttributeIgnored	获取或设置指示是否忽略未知 XML 属性和元素而不引发异常的标志。
NonSerializableContent	获取或设置不进行序列化的图表属性。
SerializableContent	获取或设置可以序列化的图表属性。

方法

Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
GetContentString(SerializationContents, Boolean)	返回可序列化或不可序列化的类和/或属性名称，可否序列化取决于具体的标志值。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetType()	获取当前实例的 Type。 (继承自 Object)
Load(Stream)	将已序列化的数据从派生自 Stream 类的对象加载到控件。
Load(String)	将已保存到磁盘的序列化数据加载到 Chart 控件。
Load(TextReader)	将已序列化的数据从派生自 TextReader 类的读取器对象加载到控件。
Load(XmlReader)	将已序列化的数据从派生自 XmlReader 类的对象加载到控件。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
Reset()	重置所有标记为要进行序列化的图表属性。
Save(Stream)	将具有非默认值的图表数据和属性保存到派生自 Stream 类的对象。
Save(String)	将具有非默认值的图表数据和属性保存到给定文件中。
Save(TextWriter)	将具有非默认值的图表数据和属性保存到派生自 TextWriter 类的给定对象中。
Save(XmlWriter)	将具有非默认值的图表数据和属性保存到派生自 XmlWriter 类的给定对象中。
ToString()	返回表示当前对象的字符串。 (继承自 Object)