SOAP メッセージの書式のカスタマイズ

[アーティクル]
02/27/2011

このトピックの対象は、レガシテクノロジに特定されています。XML Web サービスと XML Web サービスクライアントは以下を使用して作成してください。 Windows Communication Foundation.

クライアントとの通信に SOAP を使用する ASP.NET Web サービスでは、要求と応答で送信される SOAP メッセージ形式を制御するための高度な機構を利用できます。SOAP では、Web サービスとやり取りする SOAP メッセージの内容は、Body 要素と Header 要素に格納される XML で記述する必要があると規定されています。これらの要素は、名前空間 https://schemas.xmlsoap.org/soap/envelope/ に属する 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 サービスに適用して、Web サービスの Web サービスメソッドとの間で送受信される SOAP 要求と SOAP 応答の既定の形式を設定します。

SoapDocumentMethodAttribute
SoapDocumentMethodAttribute 属性をメソッドに適用して、メソッドとの間で送受信される SOAP メッセージで Document 形式を使用することを指定します。

SoapRpcServiceAttribute
Web サービスの Web サービスメソッドとの間で送受信される SOAP 要求と SOAP 応答の既定の形式を設定します。

SOAP メッセージの書式のカスタマイズ

このセクションの内容

リファレンス

関連項目

その他のリソース