webRequestModules の <add> 要素 (ネットワーク設定)

  • [アーティクル]

アプリケーションにカスタム Web 要求モジュールを追加します。

configuration
  <system.net>
    <webRequestModules>
      <add>

構文

<add
  prefix="URI prefix"
  type="type_fullname, assembly_fullname"
/>

属性および要素

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

属性

属性 説明
prefix この Web 要求モジュールによって処理される要求の URI プレフィックス。
type この Web 要求モジュールを実装する、コンマで区切られた完全修飾型名 (FullName プロパティによって示されます) とアセンブリ名 (FullName プロパティによって示されます)。

子要素

なし。

親要素

要素 説明
webRequestModules ネットワーク ホストから情報を要求するために使用するモジュールを指定します。

解説

prefix 属性は、指定された Web 要求モジュールを使用する URI プレフィックスを定義します。 通常、Web 要求モジュールは、HTTP や FTP などの特定のプロトコルを処理するように登録されますが、特定のサーバーまたはサーバー上のパスへの要求を処理するように登録することもできます。

Web 要求モジュールは、URI 照合プレフィックスが WebRequest.Create メソッドに渡されたときに作成されます。

prefix 属性の値は、有効な URI の先頭の文字である必要があります。 たとえば、http または http://www.contoso.com です。

type 属性の値は、有効な型名と、それに対応するアセンブリ名をコンマで区切って指定する必要があります。

構成ファイル

この要素は、アプリケーション構成ファイルまたはマシン構成ファイル (Machine.config) で使用できます。

例

次の例では、HTTP 用のカスタム Web 要求モジュールを登録します。 Version と PublicKeyToken の値は、指定されたモジュールの正しい値に置き換える必要があります。

<configuration>  
  <system.net>  
    <webRequestModules>  
      <add prefix="http"  
           type="System.Net.HttpRequestCreator, System, Version=2.0.3600.0,  
           Culture=neutral, PublicKeyToken=b77a5c561934e089"  
      />  
    </webRequestModules>  
  </system.net>  
</configuration>

関連項目