HttpClient.DefaultProxy Vlastnost

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Zdroj:

HttpClient.cs

Získá nebo nastaví globální proxy server 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ždým požadavkem 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í inicializuje následující jinou sadu pravidel v závislosti na vaší platformě:

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

• Pro macOS: Načte konfiguraci proxy serveru z proměnných prostředí nebo pokud nejsou definovány, 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 definovány, tato vlastnost inicializuje nekonfigurovanou instanci, která obchází všechny adresy.

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

• HTTP_PROXY: proxy server použitý u požadavků HTTP.
• HTTPS_PROXY: proxy server použitý v požadavcích HTTPS.
• ALL_PROXY: Proxy server používaný v požadavcích HTTP a/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ů; pro případ, že chcete shodovat subdoménu, použijte úvodní tečku. Příklady: NO_PROXY=.example.com (s úvodní tečkou) se shodují www.example.com, ale nebudou se shodovat example.com. NO_PROXY=example.com (bez úvodní tečky) se neshoduje www.example.com. Toto chování se může v budoucnu znovu vrátit, aby se lépe shodovaly s jinými ekosystémy.

Na systémech, kde jsou proměnné prostředí citlivé na velikost písmen, mohou být názvy proměnných buď pouze malými písmeny, nebo pouze velkými písmeny. Nejdřív se zkontrolují malá písmena v názvech.

Proxy server může být název hostitele nebo IP adresa, případně za ním dvojtečka a číslo portu, nebo to může být httpčíslo , , httpssocks4, socks4anebo socks5 adresa URL. Adresa URL nemůže obsahovat žádný text za názvem hostitele, IP adresou nebo portem. Pokud schéma není zadané, http předpokládá se. Adresa URL může volitelně obsahovat uživatelské jméno a heslo pro ověřování proxy serveru, ale heslo se při použití socks4 nebo socks4a jako protokoly nepodporují ověřování heslem.

• 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]