HttpClient.DefaultProxy Egenskap

Definition

Namnområde:
System.Net.Http
Sammansättningar:
netstandard.dll, System.Net.Http.dll
Sammansättning:
System.Net.Http.dll
Källa:
HttpClient.cs
Källa:
HttpClient.cs
Källa:
HttpClient.cs
Källa:
HttpClient.cs
Källa:
HttpClient.cs

Hämtar eller anger den globala HTTP-proxyn.

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

Egenskapsvärde

IWebProxy

En proxy som används av varje HTTP-begäran.

Undantag

ArgumentNullException

Det angivna värdet får inte vara null.

Kommentarer

Den här statiska egenskapen avgör standardproxyn som alla HttpClient instanser använder om ingen proxy uttryckligen anges i den HttpMessageHandler som skickas via konstruktorn.

Standardinstansen som returneras av den här egenskapen initieras efter en annan uppsättning regler beroende på din plattform:

  • För Windows: Läser proxykonfiguration från miljövariabler eller, om de inte har definierats, från användarens proxyinställningar.

  • För macOS: Läser proxykonfiguration från miljövariabler eller, om de inte har definierats, från systemets proxyinställningar.

  • För Linux: Läser proxykonfiguration från miljövariabler eller, om de inte har definierats, initierar den här egenskapen en icke-konfigurerad instans som kringgår alla adresser.

Miljövariablerna som används för DefaultProxy initiering på Windows- och Unix-baserade plattformar är:

  • HTTP_PROXY: proxyservern som används för HTTP-begäranden.
  • HTTPS_PROXY: proxyservern som används för HTTPS-begäranden.
  • ALL_PROXY: proxyservern som används på HTTP- och/eller HTTPS-begäranden om HTTP_PROXY och/eller HTTPS_PROXY inte har definierats.
  • NO_PROXY: en kommaavgränsad lista över värdnamn som ska undantas från proxy. Asterisker stöds inte för jokertecken. använd en inledande punkt om du vill matcha en underdomän. Exempel: NO_PROXY=.example.com (med inledande punkt) matchar www.example.com, men matchar example.cominte . NO_PROXY=example.com (utan inledande punkt) matchar www.example.cominte . Det här beteendet kan ses över i framtiden för att matcha andra ekosystem bättre.

På system där miljövariabler är skiftlägeskänsliga kan variabelnamnen vara alla gemener eller versaler. De små bokstäverna i namn kontrolleras först.

Proxyservern kan vara ett värdnamn eller EN IP-adress, eventuellt följt av ett kolon och portnummer, eller så kan det vara en http, https, socks4, socks4aeller socks5 URL. URL:en kan inte innehålla någon text efter värdnamnet, IP-adressen eller porten. Om ett schema inte har angetts http antas det. URL:en kan eventuellt innehålla ett användarnamn och lösenord för proxyautentisering, men lösenordet ignoreras när du använder socks4 eller socks4a eftersom protokollen inte har något stöd för lösenordsautentisering.

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

Gäller för