Web メソッドとして使用される場合に、このクエリの入出力で使用されるエンコードを指定します。Web サービスまたは Web クライアントとして定義されているクラス内でのみ適用されます。
使用法
クエリ (Web メソッドとして使用される場合) の入力および出力により使用される既定のエンコードをオーバーライドするには、以下の構文を使用します。
Query name(formal_spec) As classname [ WebMethod, SoapBodyUse = encoded ] { //implementation }
soapbodyuse は以下のいずれかの値になります。
-
literal — この Web メソッドは、リテラル・データを使用します。つまり、SOAP メッセージの <Body> の中の XML は、WSDL で提供されるスキーマと一致します。
-
encoded — この Web メソッドは、SOAP でエンコードされたデータを使用します。つまり、SOAP メッセージの <Body> の中の XML では、以下の仕様に従い、使用される SOAP のバージョンに応じて SOAP エンコードを使用します。
Important:
手動で作成した Web サービスでは、通常はこのキーワードの既定値が最適な値となります。SOAP ウィザードで WSDL から Web クライアントまたは Web サービスを生成すると、このキーワードはその WSDL に最適に設定されます。この値を変更すると、Web クライアントまたは Web サービスは機能しなくなる場合があります。
詳細
このキーワードは、このクエリが Web メソッドとして呼び出された場合の、その入出力のエンコードを指定します。
このキーワードは、指定されたクエリに対して、SoapBodyUse クラス・キーワードをオーバーライドします。
既定値
このキーワードを省略すると、SoapBodyUse クラス・キーワードの値が代わりに使用されます。
WSDL との関係と SOAP メッセージへの影響
詳細は、SoapBodyUse クラス・キーワードのエントリを参照してください。