控制编码的 SOAP 序列化的属性

名为“Simple Object Access Protocol (SOAP) 1.1”的万维网联合会 (www.w3.org) 文档包含一个可选的小节(第 5 节),该节描述如何对 SOAP 参数进行编码。为遵循该规范的第 5 节,必须使用 System.Xml.Serialization 命名空间中的一组特殊属性。将那些属性根据需要应用于类和类的成员,然后使用 XmlSerializer 序列化类的实例。

下表显示属性、属性的应用对象和属性的功能。有关使用这些属性控制 XML 序列化的更多信息,请参见如何:将对象序列化为 SOAP 编码的 XML 流如何:重写已编码的 SOAP XML 序列化

有关属性的更多信息,请参见利用属性扩展元数据

属性 应用于 指定

SoapAttributeAttribute

公共字段、属性、参数或返回值。

该类成员将被序列化为 XML 属性。

SoapElementAttribute

公共字段、属性、参数或返回值。

该类将被序列化为 XML 元素。

SoapEnumAttribute

作为枚举标识符的公共字段。

枚举成员的元素名。

SoapIgnoreAttribute

公共属性和字段。

包含类被序列化时应忽略此属性或字段。

SoapIncludeAttribute

公共派生类声明,以及用于 Web 服务描述语言 (WSDL) 文档的公共方法。

生成架构时应包括该类型(以便序列化时能够识别该类型)。

SoapTypeAttribute

公共类声明。

此类应序列化为 XML 类型。

请参见

任务

如何:将对象序列化为 SOAP 编码的 XML 流
如何:重写已编码的 SOAP XML 序列化
如何:将对象序列化
如何:将对象反序列化

参考

XmlSerializer

其他资源

XML 和 SOAP 序列化
利用属性扩展元数据