SoapBindingStyle (クエリ・キーワード)
使用法
クエリが (Web メソッドとして使用される場合に) 使用する既定のバインディング・スタイルをオーバーライドするには、以下の構文を使用します。
Query name(formal_spec) As classname [ WebMethod, SoapBindingStyle = soapbindingstyle ] { //implementation }
soapbindingstyle は以下のいずれかの値になります。
-
document — この Web メソッドはドキュメント・スタイルの呼び出しを使用します。
このバインディング・スタイルにより、SOAP メッセージはドキュメントとしてフォーマットされ、通常はパートを 1 つのみ持ちます。
SOAP メッセージでは、通常、<Body> 要素に 1 つの子要素が含まれます。<Body> 要素のそれぞれの子は、メッセージ・パートに対応します。
-
rpc — この Web メソッドは RPC (リモート・プロシージャ呼び出し) スタイルの呼び出しを使用します。
このバインディング・スタイルにより、SOAP メッセージは複数のパートを持つメッセージとしてフォーマットされます。
SOAP メッセージでは、<Body> 要素に 1 つの子要素が含まれ、その名前は対応する処理名から取得されます。この要素は生成されたラッパ要素であり、これにはメソッドの引数リストの引数ごとに 1 つの子要素が含まれます。
手動で作成した Web サービスでは、通常はこのキーワードの既定値が最適な値となります。SOAP ウィザードで WSDL から Web クライアントまたは Web サービスを生成すると、このキーワードはその WSDL に最適に設定されます。この値を変更すると、Web クライアントまたは Web サービスは機能しなくなる場合があります。
詳細
このキーワードは、このクエリが Web メソッドとして呼び出された場合の、このクエリによって使用されるバインディング・スタイルを指定します。
このキーワードは、指定されたクエリに対して、SoapBindingStyle クラス・キーワードをオーバーライドします。
既定値
このキーワードを省略すると、<soap:operation> 要素の style 属性が、代わりに SoapBindingStyle クラス・キーワードの値により決定されます。
WSDL との関係
詳細は、SoapBindingStyle メソッド・キーワードのエントリを参照してください (同じ名前のクラス・キーワードがあると、メソッド・キーワードやクエリ・キーワードの動作よりも WSDL のパートのほうに大きく影響します)。
SOAP メッセージへの影響
詳細は、SoapBindingStyle クラス・キーワードのエントリを参照してください。