HttpClient.DefaultProxy Vlastnost

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

Zdroj:

HttpClient.cs

Získá nebo nastaví globální 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

Hodnota vlastnosti

IWebProxy

Proxy server používaný každou žádostí HTTP.

Výjimky

ArgumentNullException

Předaná hodnota nemůže být null.

Poznámky

Tato statická vlastnost určuje výchozí proxy server, který všechny HttpClient instance používají, pokud není v předaném konstruktoru HttpMessageHandler explicitně nastaven žádný proxy server.

Výchozí instance vrácená touto vlastností se inicializuje podle jiné sady pravidel v závislosti na vaší platformě:

• Pro Windows: Načte konfiguraci proxy serveru z proměnných prostředí nebo, pokud nejsou definované, z nastavení proxy serveru uživatele.

• Pro macOS: Načte konfiguraci proxy serveru z proměnných prostředí nebo, pokud nejsou definované, z nastavení proxy serveru systému.

• Pro Linux: Načte konfiguraci proxy serveru z proměnných prostředí, nebo v případě, že nejsou definované, tato vlastnost inicializuje nenakonfigurovanou instanci, která obchází všechny adresy.

Proměnné prostředí používané pro DefaultProxy inicializaci na platformách Windows a Unix jsou:

• HTTP_PROXY: proxy server používaný v požadavcích HTTP.
• HTTPS_PROXY: proxy server používaný pro požadavky HTTPS.
• ALL_PROXY: proxy server používaný pro požadavky HTTP nebo HTTPS v případě, že nejsou definovány HTTP_PROXY nebo HTTPS_PROXY.
• NO_PROXY: seznam názvů hostitelů oddělených čárkami, které by měly být vyloučeny z proxy serveru. Hvězdičky nejsou podporovány u zástupných znaků; pokud chcete shodovat subdoménu, použijte úvodní tečku. Příklady: NO_PROXY=.example.com (s počáteční tečkou) se bude shodovat www.example.com, ale nebude odpovídat example.com. NO_PROXY=example.com (bez počáteční tečky) se neshoduje www.example.coms . Toto chování se může v budoucnu znovu vrátit, aby lépe odpovídalo jiným ekosystémům.

V systémech, kde proměnné prostředí rozlišují malá a malá písmena, můžou být názvy proměnných všechna malá nebo velká písmena. Jako první se zaškrtnou malá písmena.

Proxy serverem může být název hostitele nebo IP adresa, volitelně za ním dvojtečka a číslo portu nebo adresa URL http, volitelně včetně uživatelského jména a hesla pro ověření proxy serveru. Adresa URL musí začínat httpna , ne httpsa nesmí obsahovat žádný text za názvem hostitele, IP adresou nebo portem.