控制 XML 序列化的属性

可以将下表中的属性应用于类和类成员,以控制XmlSerializer对类实例进行序列化或反序列化的方式。 若要了解这些属性如何控制 XML 序列化,请参阅 使用属性控制 XML 序列化

这些属性还可用于控制 XML Web 服务生成的文本样式 SOAP 消息。 有关将这些属性应用于 XML Web 服务方法的详细信息,请参阅 使用 XML Web Services 进行 XML 序列化

有关属性的详细信息,请参阅 “属性”。

特征 适用于 指定
XmlAnyAttributeAttribute 返回对象数组 XmlAttribute 的公共字段、属性、参数或返回值。 反序列化时,该数组将填充代表所有架构未知的 XML 属性的 XmlAttribute 对象。
XmlAnyElementAttribute 返回对象数组 XmlElement 的公共字段、属性、参数或返回值。 反序列化时,该数组将填充XmlElement对象,这些对象表示架构未知的所有XML元素。
XmlArrayAttribute 返回复杂对象的数组的公共字段、属性、参数或返回值。 数组的成员将作为 XML 数组的成员生成。
XmlArrayItemAttribute 返回复杂对象的数组的公共字段、属性、参数或返回值。 可以插入数组的派生类型。 通常与一个 XmlArrayAttribute 一起使用。
XmlAttributeAttribute 公共字段、属性、参数或返回值。 该成员将序列化为 XML 属性。
XmlChoiceIdentifierAttribute 公共字段、属性、参数或返回值。 可以使用枚举进一步消除成员的歧义。
XmlElementAttribute 公共字段、属性、参数或返回值。 字段或属性将序列化为 XML 元素。
XmlEnumAttribute 作为枚举标识符的公共字段。 枚举成员的元素名称。
XmlIgnoreAttribute 公共属性和公共字段。 在序列化包含类时,应该忽略该类的属性或字段。
XmlIncludeAttribute 公共派生类的声明,以及 Web 服务描述语言 (WSDL) 文档中公共方法的返回值。 生成架构时应包含该类(要在序列化时识别)。
XmlRootAttribute 公共类声明。 控制属性目标的 XML 序列化,使其作为 XML 根元素。 使用特性进一步指定命名空间和元素名称。
XmlTextAttribute 公共属性和公共字段。 属性或字段应序列化为 XML 文本。
XmlTypeAttribute 公共类声明。 XML 类型的名称和命名空间。
ObsoleteAttribute 公共属性和公共字段。 序列化包含类时将忽略该属性或字段。

除了这些属性(这些属性都位于命名空间中 System.Xml.Serialization )外,还可以将 DefaultValueAttribute 属性应用于字段。 DefaultValueAttribute 设置一个值,如果未指定任何其他值,该值将自动赋予成员。

若要控制编码的 SOAP XML 序列化,请参阅 控制编码的 SOAP 序列化的属性

另请参阅