自定义 SOAP 消息的格式设置

本主题专门介绍一项旧有技术。现在应通过使用以下链接来创建 XML Web 服务和 XML Web 服务客户端： Windows Communication Foundation.

对于使用 SOAP 与客户端进行通信的 ASP.NET Web 服务，将提供一种复杂的机制来控制在请求和响应中发送的 SOAP 消息的格式。SOAP 规定发往和来自 Web 服务的 SOAP 消息的内容必须在 Body 和 Header 元素所包含的 XML 中，而这两个元素又是 Envelope 元素（属于命名空间 https://schemas.xmlsoap.org/soap/envelope/）的子级。但是，SOAP 不限制 XML 的格式设置。

为了生成和使用采用不同格式设置的 Web 服务，.NET Framework 提供了一种基于特性的机制，用于控制 SOAP 消息中 XML 的格式。此外，还提供了一种用于指定通过网络发送的 SOAP 的特定元素名称和特性名称的机制，该机制也基于特性，可以更加精细地控制 SOAP。

本主题中的每一节都涉及到一个演示如何使用所讨论的特性的相应帮助主题。

本节内容

• 使用 WSDL 指定的标准 SOAP 消息格式
  描述使用 WSDL 指定的标准 SOAP 消息格式。

• .NET Framework 对 SOAP 格式的支持
  描述 .NET Framework 对 SOAP 格式提供的支持。

• 如何：控制 Web 服务方法的整体 SOAP 正文格式设置
  描述如何控制 Web 服务方法的整体 SOAP 正文格式设置。

• 如何：控制 Web 服务方法的参数和返回值的格式设置
  描述如何控制 Web 服务方法的参数和返回值的格式设置。

• 如何：控制 Web 服务方法参数是否包含在额外的元素中
  描述如何控制 Web 服务方法参数是否包含在额外的元素中。

• 如何：修改整个 Web 服务的默认 SOAP 格式设置
  描述如何修改整个 Web 服务的默认 SOAP 格式设置。

• 如何：使用 XML 序列化自定义 SOAP 消息
  描述如何使用 XML 序列化来自定义 SOAP 消息。

参考

• System.Xml.Serialization
  包含用于将对象序列化为 XML 格式的文档或流的类。

• SoapRpcMethodAttribute
  指定发往和来自该方法的 SOAP 消息使用 RPC 格式设置。

• SoapDocumentServiceAttribute
  将可选的 SoapDocumentServiceAttribute 特性应用于 XML Web services，会设置发往 Web 服务的 Web 服务方法的 SOAP 请求和从这些 Web 服务方法发出的 SOAP 响应的默认格式。

• SoapDocumentMethodAttribute
  对方法应用 SoapDocumentMethodAttribute 特性将指定发往和来自该方法的 SOAP 消息使用 Document 格式设置。

• SoapRpcServiceAttribute
  设置发往 Web 服务的 Web 服务方法的 SOAP 请求和从这些 Web 服务方法发出的 SOAP 响应的默认格式。

相关章节

• Introducing XML Serialization
  提供序列化（尤其是 XML 序列化）的一般定义。

• 使用 SOAP 扩展修改 SOAP 消息
  解释如何为使用 ASP.NET 创建的 XML Web services 及其客户端生成用来修改通过网络发送的 SOAP 消息的扩展。

• 使用 ASP.NET 的 XML Web services
  详细介绍如何使用 ASP.NET 创建 XML Web services。

• 生成 XML Web services 客户端
  详细介绍如何生成 XML Web services 的客户端，而不管使用什么平台或技术生成 XML Web services。

生成日期：2011-02-23