用来控制编码的 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 类型。

请参阅