HttpClientHandler.Proxy プロパティ

定義

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

public:
 property System::Net::IWebProxy ^ Proxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };
public System.Net.IWebProxy Proxy { get; set; }
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.IWebProxy? Proxy { get; set; }
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.IWebProxy? Proxy { get; set; }
member this.Proxy : System.Net.IWebProxy with get, set
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
member this.Proxy : System.Net.IWebProxy with 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

プロパティ値

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

属性

注釈

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

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

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

  • 宛先にフラット名が含まれている (URL にドットがない)。
  • 宛先にループバック アドレス (Loopback または IPv6Loopback) が含まれている、または宛先にローカル コンピューターに割り当てられた IPAddress が含まれている。
  • 宛先のドメイン サフィックスが、ローカル コンピューターのドメイン サフィックス (DomainName) と一致する。

適用対象