<webServices> 要素

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

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

ASP.NET を使用して配置された Web サービスおよび .NET Framework 上で動作する Web サービスクライアントの設定を制御します。

スキーマの階層

<configuration>
<system.web>
<webServices> 要素

構文

<webServices> 
   <protocols> 
      <add name="protocol name"/>
      <remove name="protocol name"/>
      <clear/>
   </protocols>
   <serviceDescriptionFormatExtensionTypes> 
      <add type="type"/>
      <remove type="type"/>
      <clear/>
   </serviceDescriptionFormatExtensionTypes>
   <soapExtensionTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionTypes>
   <soapExtensionReflectorTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionReflectorTypes>
   <soapExtensionImporterTypes>
      <add type="type" priority="number" group="0|1"/>/>
      <remove type="type"/>
      <clear/>
   </soapExtensionImporterTypes>
   <wsdlHelpGenerator href="help generator file"/>
   <diagnostics suppressReturningExceptions="true|false" />
</webServices>

属性と要素

以降のセクションでは、属性、子要素、および親要素について説明します。

属性

なし。

子要素

子要素	説明
diagnostics	デバッグのためにクライアントに例外を返すかどうかを指定します。
protocols	ASP.NET Web サービスがクライアントから送信された要求データの受信や応答データの送信を行うために使用するプロトコルを指定します。プロトコルを使用すると、要求データをメソッドおよびそのパラメーターに関連付けたり、応答データをメソッドおよびその戻り値に関連付けたりできます。
serviceDescriptionFormatExtensionTypes	構成ファイルのスコープ内で実行されるサービスの説明形式拡張機能を指定します。
soapExtensionTypes	Web サービスまたはクライアントでの処理中に SOAP メッセージを調べたり変更したりするために使用する、SOAP 拡張機能を指定します。SOAP 拡張機能は、Web サービスの機能を補完します。
soapExtensionReflectorTypes	SOAP 拡張リフレクタークラスを指定します。このクラスは、サービスの説明 (WSDL ドキュメント) の生成プロセスを拡張します。サービスの説明形式拡張機能 (SDFE: Service Description Format Extension) で使用するためのプロセスです。
soapExtensionImporterTypes	SOAP 拡張インポータークラスを指定します。このクラスは、クライアントプロキシの生成プロセスを拡張します。SDFE で使用するためのプロセスです。
wsdlHelpGenerator	ブラウザーが ASMX Web サービスページに直接ナビゲートするときに、ブラウザーに表示される Web サービスヘルプページ (.aspx ファイル) を指定します。

親要素

要素	説明
configuration	共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素です。
system.web	ASP.NET 構成セクションのルート要素を指定します。

例

XML Web サービス構成設定を指定する例を次に示します。

<configuration>
   <system.web>
      <webServices>
         <diagnostics suppressReturningExceptions="false"/>
         <protocols>
            <add name="HttpGet"/>
            <add name="HttpPost"/>
            <add name="Documentation"/>
         </protocols>
         <serviceDescriptionFormatExtensionTypes>
         </serviceDescriptionFormatExtensionTypes>
         <soapExtensionTypes>
         </soapExtensionTypes>
         <soapExtensionReflectorTypes>
         </soapExtensionReflectorTypes>
         <soapExtensionImporterTypes>
         </soapExtensionImporterTypes>
         <wsdlHelpGenerator href="DefaultSdlHelpGenerator.aspx"/>
      </webServices>
   </system.web>
</configuration>

参照

リファレンス

Web サービス設定スキーマ

その他のリソース

ASP.NET Settings Schema
ASP.NET と XML Web サービスクライアントを使用して作成した XML Web サービス