名为 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 类型。 |