HttpClient.DefaultProxy HttpClient.DefaultProxy HttpClient.DefaultProxy HttpClient.DefaultProxy Property

定義

グローバル HTTP プロキシを取得または設定します。Gets or sets the global Http proxy.

public:
 static property System::Net::IWebProxy ^ DefaultProxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };
public static System.Net.IWebProxy DefaultProxy { get; set; }
member this.DefaultProxy : System.Net.IWebProxy with get, set
Public Shared Property DefaultProxy As IWebProxy

プロパティ値

HttpWebRequestインスタンス化するすべての呼び出しによって使用されるプロキシ。A proxy used by every call that instantiates a HttpWebRequest.

例外

渡される値を null とすることはできません。The value passed cannot be null.

注釈

この静的プロパティは、 HttpClient HttpClientHandlerコンストラクターを介して渡されたでプロキシが明示的に設定されていない場合に、すべて のインスタンスが使用する既定のプロキシを決定します。This static property determines the default proxy that all HttpClient instances use if no proxy is set explicitly in the HttpClientHandler passed through its constructor.

このプロパティによって返される既定のインスタンスは、プラットフォームに応じて異なる規則のセットに従って初期化されます。The default instance returned by this property will initialize following a different set of rules depending on your platform:

  • Windows の場合: 環境変数から、または定義されていない場合は、ユーザーのプロキシ設定からプロキシ構成を読み取ります。For Windows: Reads proxy configuration from environment variables or, if those are not defined, from the user's proxy settings.

  • MacOS の場合: 環境変数から、または定義されていない場合はシステムのプロキシ設定からプロキシ構成を読み取ります。For macOS: Reads proxy configuration from environment variables or, if those are not defined, from the system's proxy settings.

  • Linux の場合: 環境変数からプロキシ構成を読み取ります。これらが定義されていない場合、このプロパティは、すべてのアドレスをバイパスする構成されていないインスタンスを初期化します。For Linux: Reads proxy configuration from environment variables or, in case those are not defined, this property initializes a non-configured instance that bypasses all addresses.

Windows および Unix ベースのDefaultProxyプラットフォームでの初期化に使用される環境変数は次のとおりです。The environment variables used for DefaultProxy initialization on Windows and Unix-based platforms are:

  • HTTP_PROXY: HTTP 要求で使用されるプロキシサーバーのホスト名または IP アドレス。HTTP_PROXY: the hostname or IP address of the proxy server used on HTTP requests.
  • HTTPS_PROXY: HTTPS 要求で使用されるプロキシサーバーのホスト名または IP アドレス。HTTPS_PROXY: the hostname or IP address of the proxy server used on HTTPS requests.
  • ALL_PROXY: HTTP_PROXY または HTTPS_PROXY の場合は、HTTP または HTTPS 要求で使用されるプロキシサーバーのホスト名または IP アドレスが定義されていません。ALL_PROXY: the hostname or IP address of the proxy server used on HTTP and/or HTTPS requests in case HTTP_PROXY and/or HTTPS_PROXY are not defined.
  • NO_PROXY: プロキシから除外する必要があるホスト名のコンマ区切りのリスト。NO_PROXY: a comma-separated list of hostnames that should be excluded from proxying.

適用対象