HttpClient.DefaultProxy プロパティ

定義

グローバル HTTP プロキシを取得または設定します。

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 要求で使用されるプロキシ。

例外

渡される値を null とすることはできません。

注釈

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

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

  • 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 URL である場合があります。 URL は、https ではなく http で始まる必要があり、ホスト名、IP、またはポートの後にテキストを含めることはできません。

適用対象