構成 (インターネット アプリケーションを)

  • [アーティクル]

<> 要素 (ネットワーク設定) 構成要素には、アプリケーションのネットワーク構成情報が含まれています。 <system.Net> 要素 (ネットワーク設定) 要素を使用すると、プロキシ サーバーを設定し、接続管理パラメーターを設定し、カスタム認証および要求モジュールをアプリケーションに組み込むことができます。

<defaultProxy> 要素 (ネットワーク設定) 要素は、GlobalProxySelection クラスによって返されるプロキシ サーバーを定義します。 独自の Proxy プロパティが特定の値に設定されていない HttpWebRequest はすべて、既定のプロキシを使用します。 プロキシ アドレスを設定するだけでなく、プロキシを使用しないサーバー アドレスの一覧を作成し、ローカル アドレスにプロキシを使用しないように指定できます。

システムのインターネット設定は構成の設定と組み合わせられており、構成の設定が優先されることに注意してください。

次の例では、既定のプロキシ サーバー アドレスを http://proxyserver に設定し、ローカル アドレスにプロキシを使用しないようにし、contoso.com ドメインにあるサーバーへのすべての要求でプロキシをバイパスするように指定しています。

<configuration>  
    <system.net>  
        <defaultProxy>  
            <proxy  
                usesystemdefault = "false"  
                proxyaddress = "http://proxyserver:80"  
                bypassonlocal = "true"  
            />  
            <bypasslist>  
                <add address="http://[a-z]+\.contoso\.com/" />  
            </bypasslist>  
        </defaultProxy>  
    </system.net>  
</configuration>

特定のサーバーまたは他のすべてのサーバーに対して行うことができる持続接続の数を構成する場合は、<connectionManagement> 要素 (ネットワーク設定) 要素を使用します。 次の例では、サーバー www.contoso.com への 2 つの持続接続、IP アドレス 192.168.1.2 を持つサーバーへの 4 つの持続接続、および他のすべてのサーバーへの 1 つの持続接続が使用されるようにアプリケーションを構成します。

<configuration>  
    <system.net>  
        <connectionManagement>  
            <add address="http://www.contoso.com" maxconnection="2" />  
            <add address="192.168.1.2" maxconnection="4" />  
            <add address="*" maxconnection="1" />  
        </connectionManagement>  
    </system.net>  
</configuration>

カスタム認証モジュールは、<authenticationModules> 要素 (ネットワーク設定) 要素で構成されます。 カスタム認証モジュールは IAuthenticationModule インターフェイスを実装する必要があります。

次の例では、カスタム認証モジュールを構成します。

<configuration>  
    <system.net>  
        <authenticationModules>  
            <add type="MyAuthModule, MyAuthModule.dll" />  
        </authenticationModules>  
    </system.net>  
</configuration>

<webRequestModules> 要素 (ネットワーク設定) 要素を使用し、カスタム プロトコル固有のモジュールを使用してインターネット リソースから情報を要求するようにアプリケーションを構成することができます。 指定されたモジュールは IWebRequestCreate インターフェイスを実装する必要があります。 既定の HTTP、HTTPS、およびファイル要求モジュールは、次の例のように、構成ファイルでカスタム モジュールを指定してオーバーライドすることができます。

<configuration>  
    <system.net>  
        <webRequestModules>  
            <add  
                prefix="HTTP"  
                type = "MyHttpRequest.dll, MyHttpRequestCreator"  
            />  
        </webRequestModules>  
    </system.net>  
</configuration>

関連項目