自訂 SOAP 訊息格式

本主題專門說明舊有技術。 應該使用下列建立 XML Web Service 及 XML Web Service 用戶端： 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。

本主題中的每一節都是引用示範如何使用所述屬性的相關 HOW TO 主題。

本節內容

• 使用 WSDL 指定的標準 SOAP 訊息格式
  描述使用 WSDL 指定的標準 SOAP 訊息格式。

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

• HOW TO：控制 Web 服務方法的整體 SOAP 主體格式
  描述如何控制 Web 服務方法的整體 SOAP 本文格式。

• HOW TO：針對 Web 服務方法控制參數及傳回值格式
  描述如何控制 Web 服務方法的參數和傳回值格式。

• HOW TO：控制額外項目中是否要包含 Web 服務方法參數
  描述如何控制 Web 服務方法參數是否包含在額外項目中。

• HOW TO：為整個 Web 服務修改預設 SOAP 格式
  描述如何修改整個 Web 服務的預設 SOAP 格式。

• HOW TO：使用 XML 序列化自訂 SOAP 訊息
  描述如何使用 XML 序列化自訂 SOAP 訊息。

參考

• System.Xml.Serialization
  包含類別，用來將物件序列化為 XML 格式的文件或資料流。

• SoapRpcMethodAttribute
  指定往返於方法傳送的 SOAP 訊息應使用 RPC 格式。

• SoapDocumentServiceAttribute
  將選擇性的 SoapDocumentServiceAttribute 屬性套用至 XML Web Service，設定往返於 Web 服務方法傳送之 SOAP 要求和回應的預設格式。

• SoapDocumentMethodAttribute
  將 SoapDocumentMethodAttribute 屬性套用至方法，指定往返於方法的 SOAP 訊息應使用 Document 格式。

• SoapRpcServiceAttribute
  設定往返於 Web 服務方法傳送之 SOAP 要求和回應的預設格式。

相關章節

• Introducing XML Serialization
  提供序列化的一般定義，特別是 XML 序列化。

• 使用 SOAP 擴充功能修改 SOAP 訊息
  說明如何建置延伸，藉以針對使用 ASP.NET 建立的 XML Web Service 及其用戶端，修改網路之間傳送的 SOAP 訊息。

• 使用 ASP.NET 的 XML Web Service
  詳述如何使用 ASP.NET 建立 XML Web Service。

• 建置 XML Web Service 用戶端
  詳述如何建置 XML Web Service 的用戶端，不論用來建置 XML Web Service 的平台或技術為何。

建置日期：2011-02-23