webRequestModules の <add> 要素 (ネットワーク設定)
カスタム Web 要求モジュールをアプリケーションに追加します。
<add
prefix = "URI prefix"
type = "module name, Version, Culture, PublicKeyToken"
/>
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
---|---|
prefix |
この Web 要求モジュールで処理される要求の URI プレフィックス。 |
type |
この Web 要求モジュールを実装するモジュールのアセンブリ名およびクラス名。 |
子要素
なし。
親要素
要素 |
説明 |
---|---|
ネットワーク ホストからの情報を要求するために使用するモジュールを指定します。 |
解説
prefix 属性は、指定した Web 要求モジュールを使用する URI プレフィックスを定義します。 通常、Web 要求モジュールは、HTTP や FTP などの特定のプロトコルを処理するために登録します。ただし、特定のサーバーまたはサーバー上の特定のパスへの要求を処理するために登録することもできます。
Web 要求モジュールは、プレフィックスと一致する URI が WebRequest.Create メソッドに渡されると作成されます。
prefix 属性の値は、"http" や "https://www.contoso.com" のように、有効な UR の先行文字である必要があります。
type 属性の値は、有効な DLL 名および対応するクラスの名前をコンマで区切って指定する必要があります。
構成ファイル
この要素は、アプリケーション構成ファイルまたはマシン構成ファイル (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>