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

名为 Simple Object Access Protocol (SOAP) 1.1 的万维网联合会(W3C)文档包含一个可选部分(第 5 节),描述如何对 SOAP 参数进行编码。 若要符合规范的第 5 节,必须使用在 System.Xml.Serialization 命名空间中找到的一组特殊属性。 将这些属性应用于类及类的成员,然后使用 XmlSerializer 来序列化该类或类的实例。

下表展示了属性、它们的应用位置以及它们的功能。 有关使用这些属性控制 XML 序列化的详细信息,请参阅 如何将对象序列化为 SOAP-Encoded XML 流如何覆盖编码的 SOAP XML 序列化

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

特征 适用于 指定
SoapAttributeAttribute 公共字段、属性、参数或返回值。 类成员将序列化为 XML 属性。
SoapElementAttribute 公共字段、属性、参数或返回值。 该类将序列化为 XML 元素。
SoapEnumAttribute 作为枚举标识符的公共字段。 枚举成员的元素名称。
SoapIgnoreAttribute 公共属性和公共字段。 在序列化包含类时,应该忽略该类的属性或字段。
SoapIncludeAttribute Web 服务描述语言 (WSDL) 文档的公共派生类声明和公共方法。 生成架构时应包含该类型(要在序列化时识别)。
SoapTypeAttribute 公共类声明。 类应序列化为 XML 类型。

另请参阅