HttpClient.DefaultProxy Propriedade

Definição

Espaço de Nomes:
System.Net.Http
Assemblagens:
netstandard.dll, System.Net.Http.dll
Assemblagem:
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 de Propriedade

IWebProxy

Um proxy usado por cada pedido HTTP.

Exceções

ArgumentNullException

O valor passado não pode ser null.

Observações

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

A instância padrão devolvida por esta propriedade irá inicializar-se seguindo um conjunto diferente de regras dependendo da sua plataforma:

  • Para Windows: Lê a configuração do proxy a partir de variáveis de ambiente ou, se estas não estiverem definidas, das definições do proxy do utilizador.

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

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

As variáveis de ambiente usadas para a inicialização de 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 pedidos 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 uso de proxy. Asteriscos não são suportados para wildcards; Use um ponto inicial caso queira corresponder a um subdomínio. Exemplos: NO_PROXY=.example.com (com ponto à frente) corresponde www.example.coma , mas não corresponde example.coma . NO_PROXY=example.com (sem ponto inicial) não corresponde www.example.coma . Este comportamento pode ser revisitado no futuro para corresponder melhor a outros ecossistemas.

Em sistemas onde as variáveis de ambiente são sensíveis a maiúsculas e minúsculas, os nomes das variáveis podem ser todos minúsculos ou maiúsculos. Os nomes minúsculos 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 de porta, ou pode ser um http, https, socks4, socks4a, ou socks5 URL. O URL não pode incluir texto após o nome do host, IP ou porta. Se um esquema não for especificado, http assume-se. O URL pode, opcionalmente, incluir um nome de utilizador e uma palavra-passe para autenticação por proxy, mas a palavra-passe é ignorada ao utilizar socks4 ou socks4a porque os protocolos não suportam autenticação por palavra-passe.

  • 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