HttpClientHandler.Proxy Właściwość

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Źródło:

HttpClientHandler.cs

Pobiera lub ustawia informacje o serwerze proxy używane przez program obsługi.

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

Wartość właściwości

IWebProxy

Informacje o serwerze proxy używane przez program obsługi. Wartość domyślna to null.

Atrybuty

UnsupportedOSPlatformAttribute

Uwagi

Właściwość Proxy identyfikuje WebProxy obiekt używany do przetwarzania żądań do zasobów internetowych. Aby określić, że nie należy używać żadnego serwera proxy, ustaw Proxy właściwość na wystąpienie serwera proxy zwrócone przez metodę GetEmptyWebProxy .

Plik konfiguracji komputera lokalnego lub aplikacji może określać, że jest używany domyślny serwer proxy. Proxy Jeśli właściwość jest określona, ustawienia serwera proxy z Proxy właściwości przesłaniają plik konfiguracji komputera lokalnego lub aplikacji, a procedura obsługi będzie używać określonych ustawień serwera proxy. Jeśli w pliku konfiguracji nie określono żadnego serwera proxy, a Proxy właściwość jest nieokreślona, program obsługi używa ustawień serwera proxy dziedziczonych z programu Internet Explorer na komputerze lokalnym. Jeśli w programie Internet Explorer nie ma żadnych ustawień serwera proxy, żądanie jest wysyłane bezpośrednio do serwera.

Klasa HttpClientHandler analizuje listę obejścia serwera proxy z symbolami wieloznacznymi dziedziczone z programu Internet Explorer tak samo jak lista pomijania jest analizowana bezpośrednio przez program Internet Explorer. Na przykład HttpClientHandler klasa przeanalizuje listę obejścia "nt*" z programu Internet Explorer jako wyrażenie regularne "nt.*". Dlatego adres URL http://nt.com polecenia pomija serwer proxy przy użyciu HttpClientHandler klasy i przy użyciu programu Internet Explorer.

Klasa HttpClientHandler obsługuje obejście lokalnego serwera proxy. Klasa traktuje lokalizację docelową jako lokalizację lokalną, jeśli zostaną spełnione jakiekolwiek z następujących warunków:

1. Miejsce docelowe zawiera płaską nazwę (bez kropek w adresie URL).

2. Miejsce docelowe zawiera adres sprzężenia zwrotnego (Loopback lub ) lub IPv6Loopbackmiejsce docelowe zawiera przypisaną IPAddress do komputera lokalnego.

3. Sufiks domeny miejsca docelowego jest zgodny z sufiksem domeny komputera lokalnego (DomainName).