HttpClient.DefaultProxy Właściwość

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Źródło:

HttpClient.cs

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

Wartość właściwości

IWebProxy

Serwer proxy używany przez każde żądanie HTTP.

Wyjątki

ArgumentNullException

Przekazana wartość nie może mieć nullwartości .

Uwagi

Ta właściwość statyczna określa domyślny serwer proxy, którego używają wszystkie HttpClient wystąpienia, jeśli żaden serwer proxy nie jest jawnie ustawiony w przekazanym HttpMessageHandler konstruktorze.

Domyślne wystąpienie zwrócone przez tę właściwość spowoduje zainicjowanie różnych zestawów reguł w zależności od platformy:

• Dla systemu Windows: Odczytuje konfigurację serwera proxy ze zmiennych środowiskowych lub, jeśli nie są one zdefiniowane, z ustawień serwera proxy użytkownika.

• Dla systemu macOS: Odczytuje konfigurację serwera proxy ze zmiennych środowiskowych lub, jeśli nie są one zdefiniowane, z ustawień serwera proxy systemu.

• Dla systemu Linux: Odczytuje konfigurację serwera proxy ze zmiennych środowiskowych lub, jeśli nie są one zdefiniowane, ta właściwość inicjuje nieskonfigurowane wystąpienie, które pomija wszystkie adresy.

Zmienne środowiskowe używane do DefaultProxy inicjowania na platformach opartych na systemach Windows i Unix są następujące:

• HTTP_PROXY: serwer proxy używany w żądaniach HTTP.
• HTTPS_PROXY: serwer proxy używany w żądaniach HTTPS.
• ALL_PROXY: serwer proxy używany w żądaniach HTTP i/lub HTTPS w przypadku, gdy HTTP_PROXY i/lub HTTPS_PROXY nie są zdefiniowane.
• NO_PROXY: rozdzielona przecinkami lista nazw hostów, które powinny być wykluczone z serwera proxy. Gwiazdki nie są obsługiwane w przypadku symboli wieloznacznych; użyj wiodącej kropki, jeśli chcesz dopasować poddomenę. Przykłady: NO_PROXY=.example.com (z kropką wiodącą) będzie zgodna www.example.comz wartością , ale nie będzie zgodna z .example.com NO_PROXY=example.com (bez wiodącej kropki) nie będzie zgodna www.example.comz . To zachowanie może zostać ponownie zwrócone w przyszłości, aby lepiej dopasować inne ekosystemy.

W systemach, w których uwzględniana jest wielkość liter zmiennych środowiskowych, nazwy zmiennych mogą być małe lub wielkie. Najpierw sprawdzane są małe litery.

Serwer proxy może być nazwą hosta lub adresem IP, opcjonalnie, po którym następuje dwukropek i numer portu, lub może być adresem URL http, opcjonalnie, w tym nazwą użytkownika i hasłem na potrzeby uwierzytelniania serwera proxy. Adres URL musi zaczynać się od http, a nie https, i nie może zawierać żadnego tekstu po nazwie hosta, adresie IP lub porcie.