用来控制编码的 SOAP 序列化的属性
命名为“简单对象访问协议 (SOAP) 1.1”的万维网联合会 (W3C) 文档包含一个可选章节(第 5 节),该节描述了如何编码 SOAP 参数。 要符合该规范的第 5 节,必须使用在 System.Xml.Serialization 命名空间中找到的一组特殊属性。 将这些特性适当应用于类和类的成员,然后使用 XmlSerializer 序列化一个或多个类的实例。
下表显示属性、属性的应用范围及其作用。 有关使用这些特性控制 XML 序列化的更多信息,请参阅如何:将对象序列化为 SOAP 编码的 XML 流以及如何:替代编码的 SOAP XML 序列化。
有关属性的详细信息,请参阅属性。
特性 | 适用对象 | 指定 |
---|---|---|
SoapAttributeAttribute | 公共字段、属性、参数或返回值。 | 类成员将序列化为 XML 属性。 |
SoapElementAttribute | 公共字段、属性、参数或返回值。 | 类将序列化为 XML 元素。 |
SoapEnumAttribute | 作为枚举标识符的公共字段。 | 枚举成员的元素名称。 |
SoapIgnoreAttribute | 公共属性和公共字段。 | 序列化包含类时,应该忽略属性或字段。 |
SoapIncludeAttribute | 公共的派生类声明,以及 Web 服务描述语言 (WSDL) 文档的公共方法。 | 生成要在序列化时识别的架构时,应该将该类型包括在内。 |
SoapTypeAttribute | 公共类声明。 | 类应序列化为 XML 类型。 |