HttpClientHandler.Proxy HttpClientHandler.Proxy HttpClientHandler.Proxy HttpClientHandler.Proxy Property

Definicja

Pobiera lub ustawia informacje o serwerze proxy używane przez program obsługi.Gets or sets proxy information used by the handler.

public:
 property System::Net::IWebProxy ^ Proxy { System::Net::IWebProxy ^ get(); void set(System::Net::IWebProxy ^ value); };
public System.Net.IWebProxy Proxy { get; set; }
member this.Proxy : System.Net.IWebProxy with get, set
Public Property Proxy As IWebProxy

Wartość właściwości

Informacje o serwerze proxy używane przez program obsługi.The proxy information used by the handler. Wartość domyślna to null.The default value is null.

Uwagi

Właściwość identyfikuje obiekt, WebProxy który ma być używany do przetwarzania żądań do zasobów internetowych. ProxyThe Proxy property identifies the WebProxy object to use to process requests to Internet resources. Aby określić, że żaden serwer proxy nie powinien być używany Proxy , należy ustawić właściwość na wystąpienie serwera proxy GetEmptyWebProxy zwrócone przez metodę.To specify that no proxy should be used, set the Proxy property to the proxy instance returned by the GetEmptyWebProxy method.

Plik konfiguracji komputera lokalnego lub aplikacji może określać, że zostanie użyty domyślny serwer proxy.The local computer or application config file may specify that a default proxy be used. Jeśli właściwość jest określona, ustawienia serwera proxy Proxy z właściwości przesłaniają plik konfiguracji komputera lokalnego lub aplikacji, a program obsługi użyje określonych ustawień serwera proxy. ProxyIf the Proxy property is specified, then the proxy settings from the Proxy property override the local computer or application config file and the handler will use the proxy settings specified. Jeśli w pliku konfiguracji nie określono żadnego serwera proxy, a Proxy właściwość nie zostanie określona, program obsługi używa ustawień serwera proxy dziedziczonych z programu Internet Explorer na komputerze lokalnym.If no proxy is specified in a config file and the Proxy property is unspecified, the handler uses the proxy settings inherited from Internet Explorer on the local computer. Jeśli nie ma żadnych ustawień serwera proxy w programie Internet Explorer, żądanie jest wysyłane bezpośrednio na serwer.If there are no proxy settings in Internet Explorer, the request is sent directly to the server.

HttpClientHandler Klasa analizuje listę pomijania proxy z symbolami wieloznacznymi dziedziczonymi z programu Internet Explorer tak samo, jak Lista pomijania jest analizowana bezpośrednio przez program Internet Explorer.The HttpClientHandler class parses a proxy bypass list with wildcard characters inherited from Internet Explorer the same as the bypass list is parsed directly by Internet Explorer. Na przykład HttpClientHandler Klasa przeanalizuje listę pomijania "NT *" z programu Internet Explorer jako wyrażenie regularne "NT.*".For example, the HttpClientHandler class will parse a bypass list of "nt*" from Internet Explorer as a regular expression of "nt.*". Dlatego adres URL http://nt.com mógłby pominąć serwer proxy HttpClientHandler przy użyciu klasy i programu Internet Explorer.So a URL of http://nt.com would bypass the proxy using the HttpClientHandler class and using Internet Explorer.

HttpClientHandler Klasa obsługuje obejście lokalnego serwera proxy.The HttpClientHandler class supports local proxy bypass. Klasa traktuje miejsce docelowe jako lokalne w przypadku spełnienia dowolnego z następujących warunków:The class considers a destination to be local if any of the following conditions are met:

  1. Lokalizacja docelowa zawiera nazwę płaską (bez kropek w adresie URL).The destination contains a flat name (no dots in the URL).

  2. Lokalizacja docelowa zawiera adres sprzężenia IPv6Loopbackzwrotnego (Loopback lub) IPAddress lub miejsce docelowe zawiera przypisane do komputera lokalnego.The destination contains a loopback address (Loopback or IPv6Loopback) or the destination contains an IPAddress assigned to the local computer.

  3. Sufiks domeny miejsca docelowego jest zgodny z sufiksem domeny komputera lokalnego (DomainName).The domain suffix of the destination matches the local computer's domain suffix (DomainName).

Dotyczy