HttpClientHandler.Proxy プロパティ

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

Source:

HttpClientHandler.cs

ハンドラーで使用するプロキシ情報を取得または設定します。

public:
 property System::Net::IWebProxy ^ Proxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.IWebProxy? Proxy { get; set; }

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
member this.Proxy : System.Net.IWebProxy with get, set

Public Property Proxy As IWebProxy

プロパティ値

IWebProxy

ハンドラーで使用するプロキシ情報。 既定値は null です。

属性

UnsupportedOSPlatformAttribute

注釈

Proxy プロパティによって、インターネット リソースへの要求の処理に使う WebProxy オブジェクトが指定されます。 プロキシを使わない場合は、Proxy プロパティを GetEmptyWebProxy メソッドから返されるプロキシ インスタンスに設定します。

ローカル コンピューターまたはアプリケーション構成ファイルでは、既定のプロキシを使うことを指定できます。 プロパティが Proxy 指定されている場合、プロパティの Proxy プロキシ設定はローカル コンピューターまたはアプリケーション構成ファイルをオーバーライドし、ハンドラーは指定されたプロキシ設定を使用します。 構成ファイルProxyにプロキシが指定されておらず、 プロパティが指定されていない場合、ハンドラーはローカル コンピューター上のインターネット エクスプローラーから継承されたプロキシ設定を使用します。 インターネット エクスプローラーにプロキシ設定がない場合、要求はサーバーに直接送信されます。

クラスはHttpClientHandler、インターネットから継承されたワイルドカード文字を使用してプロキシ バイパス リストを解析エクスプローラー、バイパス リストがインターネット エクスプローラーによって直接解析されるのと同じです。 たとえば、 クラスは、HttpClientHandlerインターネット エクスプローラーの "nt*" のバイパス リストを "nt.*" の正規表現として解析します。 そのため、 の http://nt.com URL は、 クラスを使用しHttpClientHandler、インターネット エクスプローラーを使用してプロキシをバイパスします。

HttpClientHandler クラスでは、ローカル プロキシのバイパスがサポートされています。 次のいずれかの条件が満たされている場合、クラスは宛先をローカルと見なします。

1. 宛先にフラット名が含まれている (URL にドットがない)。

2. 宛先にループバック アドレス (Loopback または IPv6Loopback) が含まれている、または宛先にローカル コンピューターに割り当てられた IPAddress が含まれている。

3. 宛先のドメイン サフィックスが、ローカル コンピューターのドメイン サフィックス (DomainName) と一致する。