可以将下表中的属性应用于类和类成员,以控制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 序列化的属性。