HttpClientHandler.Proxy Eigenschaft

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Quelle:

HttpClientHandler.cs

Ruft vom Handler verwendete Proxyinformationen ab oder legt diese fest.

public:
 property System::Net::IWebProxy ^ Proxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.IWebProxy? Proxy { get; set; }

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("ios")>]
[<System.Runtime.Versioning.UnsupportedOSPlatform("tvos")>]
member this.Proxy : System.Net.IWebProxy with get, set

Public Property Proxy As IWebProxy

Eigenschaftswert

IWebProxy

Die vom Handler verwendeten Proxyinformationen. Der Standardwert ist null.

Attribute

UnsupportedOSPlatformAttribute

Hinweise

Die Eigenschaft Proxy identifiziert das WebProxy-Objekt, das zum Verarbeiten von Anforderungen an Internetressourcen verwendet wird. Um anzugeben, dass kein Proxy verwendet werden soll, legen Sie die Eigenschaft Proxy auf die Proxyinstanz fest, die von der Methode GetEmptyWebProxy zurückgegeben wird.

In der Konfigurationsdatei des lokalen Computers oder der Anwendung kann angegeben werden, dass ein Standardproxy verwendet werden soll. Wenn die Proxy -Eigenschaft angegeben ist, überschreiben die Proxyeinstellungen der Proxy -Eigenschaft die konfigurationsdatei des lokalen Computers oder der Anwendung, und der Handler verwendet die angegebenen Proxyeinstellungen. Wenn in einer Konfigurationsdatei kein Proxy angegeben ist und die Proxy Eigenschaft nicht angegeben ist, verwendet der Handler die Proxyeinstellungen, die vom Internet Explorer auf dem lokalen Computer geerbt wurden. Wenn keine Proxyeinstellungen im Internet Explorer vorhanden sind, wird die Anforderung direkt an den Server gesendet.

Die HttpClientHandler Klasse analysiert eine Proxyumgehungsliste mit Platzhalterzeichen, die vom Internet geerbt werden Explorer die gleiche wie die Umgehungsliste direkt vom Internet Explorer analysiert wird. Beispielsweise analysiert die HttpClientHandler Klasse eine Umgehungsliste von "nt*" aus dem Internet Explorer als regulären Ausdruck von "nt.*". Eine URL von http://nt.com würde also den Proxy mithilfe der HttpClientHandler -Klasse und internet-Explorer umgehen.

Die HttpClientHandler-Klasse unterstützt die lokale Proxyumgehung. Die Klasse betrachtet ein Ziel als lokal, wenn eine der folgenden Bedingungen erfüllt ist:

1. Das Ziel enthält einen flachen Namen (keine Punkte in der URL).

2. Das Ziel enthält eine Loopbackadresse (Loopback oder IPv6Loopback), oder das Ziel enthält eine IPAddress, die dem lokalen Computer zugewiesen ist.

3. Das Domänensuffix des Ziels entspricht dem Domänensuffix des lokalen Computers (DomainName).