HttpClient.DefaultProxy プロパティ

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; }

static member DefaultProxy : System.Net.IWebProxy with get, set

Public Shared Property DefaultProxy As IWebProxy

プロパティ値

すべての HTTP 要求で使用されるプロキシ。

例外

注釈

この静的プロパティは、コンストラクターを介して渡されるHttpMessageHandlerでプロキシが明示的に設定されていない場合に、すべてのHttpClient インスタンスが使用する既定のプロキシを決定します。

このプロパティによって返される既定のインスタンスは、プラットフォームに応じて異なる規則のセットに従って初期化されます。

• for Windows: 環境変数から、または定義されていない場合は、ユーザーのプロキシ設定からプロキシ構成を読み取ります。

• macOS の場合: 環境変数からプロキシ構成を読み取るか、定義されていない場合はシステムのプロキシ設定から読み取ります。

• Linux の場合: 環境変数からプロキシ構成を読み取るか、定義されていない場合は、すべてのアドレスをバイパスする構成されていないインスタンスを初期化します。

Windows および Unix ベースのプラットフォームでの DefaultProxy 初期化に使用される環境変数は次のとおりです。

• HTTP_PROXY: HTTP 要求で使用されるプロキシ サーバー。
• HTTPS_PROXY: HTTPS 要求で使用されるプロキシ サーバー。
• ALL_PROXY: HTTP_PROXYやHTTPS_PROXYが定義されていない場合に、HTTP 要求または HTTPS 要求で使用されるプロキシ サーバー。
• NO_PROXY: プロキシから除外する必要があるホスト名のコンマ区切りのリスト。 アスタリスクはワイルドカードではサポートされていません。サブドメインと一致させる場合は、先頭のドットを使用します。 例: NO_PROXY=.example.com (先頭にドットを付ける) は www.example.comと一致しますが、 example.comと一致しません。 NO_PROXY=example.com (先頭にドットがない) は www.example.comと一致しません。 この動作は、今後、他のエコシステムに合わせる目的で再検討される可能性があります。

環境変数で大文字と小文字が区別されるシステムでは、変数名はすべて小文字またはすべて大文字にすることができます。 小文字の名前が最初にチェックされます。

プロキシ サーバーは、ホスト名または IP アドレス、必要に応じてコロンとポート番号、または http、 https、 socks4、 socks4a、または socks5 URL である場合があります。 URL には、ホスト名、IP、またはポートの後にテキストを含めることはできません。 スキームが指定されていない場合は、 http が想定されます。 URL には必要に応じてプロキシ認証用のユーザー名とパスワードを含めることができますが、プロトコルでパスワード認証がサポートされていないため、 socks4 または socks4a を使用する場合、パスワードは無視されます。

• http: http://[username:password@]hostname[:port]
• https: https://[username:password@]hostname[:port]
• socks4: socks4://[username@]hostname[:port]
• socks4a: socks4a://[username@]hostname[:port]
• socks5: socks5://[username:password@]hostname[:port]