HttpClientHandler.Proxy Propriedade

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Origem:

HttpClientHandler.cs

Obtém ou define as informações de proxy usadas pelo manipulador.

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

Valor da propriedade

IWebProxy

As informações de proxy usadas pelo manipulador. O valor padrão é null.

Atributos

UnsupportedOSPlatformAttribute

Comentários

A propriedade Proxy identifica o objeto WebProxy a ser usado para processar solicitações para recursos da Internet. Para especificar que nenhum proxy deve ser usado, defina a propriedade Proxy como a instância de proxy retornada pelo método GetEmptyWebProxy.

O computador local ou o arquivo de configuração do aplicativo pode especificar que um proxy padrão seja usado. Se a Proxy propriedade for especificada, as configurações de proxy da Proxy propriedade substituirão o computador local ou o arquivo de configuração do aplicativo e o manipulador usará as configurações de proxy especificadas. Se nenhum proxy for especificado em um arquivo de configuração e a Proxy propriedade não for especificada, o manipulador usará as configurações de proxy herdadas da Internet Explorer no computador local. Se não houver configurações de proxy na Internet Explorer, a solicitação será enviada diretamente ao servidor.

A HttpClientHandler classe analisa uma lista de bypass de proxy com caracteres curinga herdados da Internet Explorer o mesmo que a lista de bypass é analisada diretamente por Explorer da Internet. Por exemplo, a HttpClientHandler classe analisará uma lista de bypass de "nt*" da Internet Explorer como uma expressão regular de "nt.*". Portanto, uma URL de http://nt.com ignoraria o proxy usando a HttpClientHandler classe e usando Explorer da Internet.

A classe HttpClientHandler dá suporte ao bypass de proxy local. A classe considera um destino como local se qualquer uma das seguintes condições for atendida:

1. O destino contém um nome simples (nenhum ponto na URL).

2. O destino contém um endereço de loopback (Loopback ou IPv6Loopback) ou o destino contém um IPAddress atribuído ao computador local.

3. O sufixo de domínio do destino corresponde ao sufixo de domínio do computador local (DomainName).