HttpClient.DefaultProxy Propriedade

Definição

Namespace:
System.Net.Http
Assemblies:
netstandard.dll, System.Net.Http.dll
Assembly:
System.Net.Http.dll
Origem:
HttpClient.cs
Origem:
HttpClient.cs
Origem:
HttpClient.cs
Origem:
HttpClient.cs
Origem:
HttpClient.cs

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

IWebProxy

Um proxy usado por cada solicitação HTTP.

Exceções

ArgumentNullException

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 construtor passado.

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 de variáveis de ambiente ou, se não estiverem definidas, das configurações de proxy do usuário.

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

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

As variáveis de ambiente usadas para a inicialização do 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 sejam definidos.
  • NO_PROXY: uma lista separada por vírgulas de nomes de host que devem ser excluídos do proxying. 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á www.example.com, mas não corresponderá example.com. NO_PROXY=example.com (sem ponto à esquerda) não corresponderá www.example.com. Esse comportamento pode ser revisitado no futuro para corresponder melhor a outros ecossistemas.

Em sistemas em que as variáveis de ambiente diferenciam maiúsculas de minúsculas, os nomes das variáveis podem ser todos minúsculos ou todos maiúsculos. 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 um número de porta, ou pode ser um http, https, socks4, socks4aou socks5 URL. A URL não pode incluir nenhum texto após o nome do host, IP ou porta. Se um esquema não for especificado, http será assumido. Opcionalmente, a URL pode incluir um nome de usuário e senha para autenticação de proxy, mas a senha é ignorada ao usar socks4 ou socks4a porque os protocolos não têm suporte para autenticação de senha.

  • http: http://[username:password@]hostname[:port]
  • https: https://[username:password@]hostname[:port]
  • socks4: socks4://[username@]hostname[:port]
  • socks4a: socks4a://[username@]hostname[:port]
  • socks5: socks5://[username:password@]hostname[:port]

Aplica-se a