用来控制编码的 SOAP 序列化的特性

万维网联合会 (www.w3.org) 文档“简单对象访问协议 (SOAP) 1.1”(Simple Object Access Protocol (SOAP) 1.1) 包含可选章节(第 5 节),该节描述如何编码 SOAP 参数。要符合该规范的第 5 节,必须使用在 System.Xml.Serialization 命名空间中找到的一组特殊特性。将这些特性适当应用于类和类的成员,然后使用 XmlSerializer 序列化一个或多个类的实例。

下表显示特性、特性的应用范围及其作用。有关使用这些特性控制 XML 序列化的更多信息,请参见如何:将对象序列化为 SOAP 编码的 XML 流如何:重写编码的 SOAP XML 序列化

有关特性的更多信息,请参见Extending Metadata Using Attributes

特性 适用对象 指定

SoapAttributeAttribute

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

类成员将序列化为 XML 特性。

SoapElementAttribute

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

类将序列化为 XML 元素。

SoapEnumAttribute

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

枚举成员的元素名称。

SoapIgnoreAttribute

公共属性和公共字段。

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

SoapIncludeAttribute

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

生成要在序列化时识别的架构时,应该将该类型包括在内。

SoapTypeAttribute

公共类声明。

类应序列化为 XML 类型。

另请参见

任务

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

参考

XmlSerializer

其他资源

XML 和 SOAP 序列化
Extending Metadata Using Attributes