Compartilhar via


HttpClient.DefaultProxy Propriedade

Definição

Obtém ou define o proxy HTTP global.

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

Valor da propriedade

Um proxy usado por cada solicitação HTTP.

Exceções

O valor passado não pode ser null.

Comentários

Essa propriedade estática determina o proxy padrão que todas as HttpClient instâncias usam se nenhum proxy for definido explicitamente no HttpMessageHandler passado por meio de seu construtor.

A instância padrão retornada por essa propriedade será inicializada seguindo um conjunto diferente de regras, dependendo da plataforma:

  • Para Windows: lê a configuração de proxy a partir de variáveis de ambiente ou, se elas não estiverem definidas, a partir das configurações de proxy do usuário.

  • Para macOS: lê a configuração de proxy a partir de variáveis de ambiente ou, se elas não estiverem definidas, a partir das configurações de proxy do sistema.

  • Para Linux: lê a configuração de proxy a partir de variáveis de ambiente ou, se elas não estiverem definidas, essa propriedade inicializa uma instância não configurada que ignora todos os endereços.

As variáveis de ambiente usadas para inicialização DefaultProxy em plataformas baseadas em Windows e Unix são:

  • HTTP_PROXY: o servidor proxy usado em solicitações HTTP.
  • HTTPS_PROXY: o servidor proxy usado em solicitações HTTPS.
  • ALL_PROXY: o servidor proxy usado em solicitações HTTP e/ou HTTPS caso HTTP_PROXY e/ou HTTPS_PROXY não estejam definidos.
  • NO_PROXY: uma lista separada por vírgulas de nomes de host que devem ser excluídos do proxy. Não há suporte para asteriscos para curingas; use um ponto à esquerda caso você queira corresponder a um subdomínio. Exemplos: NO_PROXY=.example.com (com ponto à esquerda) corresponderá a www.example.com, mas não corresponderá a example.com. NO_PROXY=example.com (sem ponto à esquerda) não corresponderá a www.example.com. Esse comportamento pode ser revisitado no futuro para corresponder melhor a outros ecossistemas.

Em sistemas nos quais as variáveis de ambiente diferenciam maiúsculas de minúsculas, os nomes de variáveis podem apenas em minúsculas ou apenas em maiúsculas. Os nomes em minúsculas são verificados primeiro.

O servidor proxy pode ser um nome de host ou endereço IP, opcionalmente seguido por dois-pontos e número da porta, ou pode ser uma URL http, incluindo opcionalmente um nome de usuário e uma senha para autenticação de proxy. A URL deve ser iniciada com http, e não https, e não pode incluir nenhum texto após o nome do host, IP ou porta.

Aplica-se a