HttpClient.DefaultProxy Właściwość

Definicja

Pobiera lub ustawia globalny serwer proxy 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

Wartość właściwości

IWebProxy

Serwer proxy używany przez każde wywołanie, które tworzy wystąpienie HttpWebRequest.A proxy used by every call that instantiates a HttpWebRequest.

Wyjątki

Przeniesiona wartość nie może być null.The value passed cannot be null.

Uwagi

Ta właściwość statyczna określa domyślny serwer proxy, który jest używany przez wszystkie wystąpienia   HttpClient, jeśli żaden serwer proxy nie został jawnie ustawiony w HttpClientHandler przekazaną przez jego Konstruktor.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.

Wystąpienie domyślne zwrócone przez tę właściwość będzie inicjowane po różnym zestawie reguł w zależności od platformy:The default instance returned by this property will initialize following a different set of rules depending on your platform:

  • Dla systemu Windows: Odczytuje konfigurację serwera proxy ze zmiennych środowiskowych lub, jeśli te nie są zdefiniowane, z ustawień serwera proxy użytkownika.For Windows: Reads proxy configuration from environment variables or, if those are not defined, from the user's proxy settings.

  • Dla macOS: Odczytuje konfigurację serwera proxy ze zmiennych środowiskowych lub, jeśli te nie są zdefiniowane, z ustawień serwera proxy systemu.For macOS: Reads proxy configuration from environment variables or, if those are not defined, from the system's proxy settings.

  • Dla systemu Linux: Odczytuje konfigurację serwera proxy ze zmiennych środowiskowych lub, w przypadku, gdy nie są zdefiniowane, ta właściwość inicjuje nieskonfigurowane wystąpienie, które pomija wszystkie adresy.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.

Zmienne środowiskowe używane do inicjowania DefaultProxy na platformach opartych na systemie Windows i UNIX są następujące:The environment variables used for DefaultProxy initialization on Windows and Unix-based platforms are:

  • HTTP_PROXY: Nazwa hosta lub adres IP serwera proxy używany w żądaniach HTTP.HTTP_PROXY: the hostname or IP address of the proxy server used on HTTP requests.
  • HTTPS_PROXY: Nazwa hosta lub adres IP serwera proxy używany w żądaniach HTTPS.HTTPS_PROXY: the hostname or IP address of the proxy server used on HTTPS requests.
  • ALL_PROXY: Nazwa hosta lub adres IP serwera proxy używany w żądaniach HTTP i/lub HTTPS w przypadku HTTP_PROXY i/lub HTTPS_PROXY nie są zdefiniowane.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: rozdzielona przecinkami lista nazw hostów, które powinny być wykluczone z proxy.NO_PROXY: a comma-separated list of hostnames that should be excluded from proxying.

Dotyczy