Freigeben über


HttpClient.DefaultProxy Eigenschaft

Definition

Ruft den globalen HTTP-Proxy ab oder legt diesen fest.

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

Eigenschaftswert

Ein Proxy, der von jeder HTTP-Anforderung verwendet wird.

Ausnahmen

Der übergebene Wert kann nicht null sein.

Hinweise

Diese statische Eigenschaft bestimmt den Standardproxy, den alle HttpClient Instanzen verwenden, wenn im HttpMessageHandler übergebenen Konstruktor kein Proxy explizit festgelegt wird.

Die über diese Eigenschaft zurückgegebene Standardinstanz wird abhängig von Ihrer Plattform nach unterschiedlichen Regeln initialisiert:

  • Für Windows: Die Proxykonfiguration wird aus den Umgebungsvariablen gelesen, sofern definiert. Andernfalls wird sie aus den Proxyeinstellungen des Benutzers gelesen.

  • Für macOS: Die Proxykonfiguration wird aus den Umgebungsvariablen gelesen, sofern definiert. Andernfalls wird sie aus den Proxyeinstellungen des Systems gelesen.

  • Für Linux: Die Proxykonfiguration wird aus den Umgebungsvariablen gelesen, sofern definiert. Andernfalls initialisiert diese Eigenschaft eine nicht konfigurierte Instanz, die alle Adressen umgeht.

Für die Initialisierung von DefaultProxy auf Windows- und Unix-basierten Plattformen werden folgende Umgebungsvariablen verwendet:

  • HTTP_PROXY: Der in HTTP-Anforderungen verwendete Proxyserver
  • HTTP_PROXY: Der in HTTPS-Anforderungen verwendete Proxyserver
  • ALL_PROXY: Der Proxyserver, der für HTTP- und/oder HTTPS-Anforderungen verwendet wird, falls HTTP_PROXY und/oder HTTPS_PROXY nicht definiert sind.
  • NO_PROXY: Eine durch Trennzeichen getrennte Liste von Hostnamen fest, die aus der Proxyfunktion ausgeschlossen werden sollen Sternchen werden nicht als Platzhalter unterstützt. Verwenden Sie einen vorangestellten Punkt, wenn Sie eine Unterdomäne abgleichen möchten. Beispiele: NO_PROXY=.example.com (mit vorangestelltem Punkt) führt zu einer Übereinstimmung mit www.example.com, nicht jedoch mit example.com. NO_PROXY=example.com (ohne vorangestelltem Punkt) führt nicht zu einer Übereinstimmung mit www.example.com. Dieses Verhalten könnte in Zukunft überarbeitet werden, um anderen Ökosystemen besser zu entsprechen.

Bei Systemen, bei denen bei Umgebungsvariablen die Groß-/Kleinschreibung beachtet wird, bestehen die Variablennamen unter Umständen nur aus Kleinbuchstaben oder nur aus Großbuchstaben. Die Namen in Kleinbuchstaben werden zuerst überprüft.

Der Proxyserver kann ein Hostname oder eine IP-Adresse sein, optional gefolgt von einem Doppelpunkt und einer Portnummer, oder es kann sich um eine HTTP-URL handeln, die optional einen Benutzernamen und ein Kennwort für die Proxyauthentifizierung enthält. Die URL muss mit http beginnen (nicht mit https) und darf nach dem Hostnamen, der IP-Adresse oder dem Port keinen Text enthalten.

Gilt für: