HttpClientHandler.Proxy Propriedade

Definição

Obtém ou define a informação proxy usada pelo 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

Valor de Propriedade

A informação proxy usada pelo handler. O valor predefinido é null.

Observações

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

O ficheiro de configuração local do computador ou da aplicação pode especificar que deve ser usado um proxy predefinido. Se a Proxy propriedade for especificada, então as definições do proxy dessa Proxy propriedade sobrepõem-se ao ficheiro de configuração local do computador ou da aplicação e o handler usará as definições do proxy especificadas. Se não for especificado um proxy num ficheiro de configuração e a Proxy propriedade não for especificada, o handler utiliza as definições de proxy herdadas das opções da Internet no computador local. Se não houver definições de proxy nas opções de Internet, o pedido é enviado diretamente para o servidor.

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

  • O destino contém um nome plano (sem pontos na URL).
  • O destino contém um endereço de loopback (Loopback ou IPv6Loopback) ou o destino contém um IPAddress atribuído ao computador local.
  • O sufixo de domínio do destino corresponde ao sufixo de domínio do computador local (DomainName).

Aplica-se a