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 den lokalen Computer oder die Anwendungskonfigurationsdatei, 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 von Internetoptionen auf dem lokalen Computer geerbt wurden. Wenn keine Proxyeinstellungen in den Internetoptionen vorhanden sind, wird die Anforderung direkt an den Server gesendet.

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

• Das Ziel enthält einen flachen Namen (keine Punkte in der URL).
• Das Ziel enthält eine Loopbackadresse (Loopback oder IPv6Loopback), oder das Ziel enthält eine IPAddress, die dem lokalen Computer zugewiesen ist.
• Das Domänensuffix des Ziels entspricht dem Domänensuffix des lokalen Computers (DomainName).