HttpClient.DefaultProxy Propriedade

Definição

Obtém ou define o proxy HTTP global.Gets or sets the global Http proxy.

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; }
member this.DefaultProxy : System.Net.IWebProxy with get, set
Public Shared Property DefaultProxy As IWebProxy

Valor da propriedade

Um proxy usado por cada chamada que cria uma instância de um HttpWebRequest.A proxy used by every call that instantiates a HttpWebRequest.

Exceções

O valor passado não pode ser null.The value passed cannot be null.

Comentários

Essa propriedade estática determina o proxy padrão que todos os HttpClient instâncias usam se nenhum proxy for definido explicitamente no HttpClientHandler passado pelo seu construtor.This static property determines the default proxy that all HttpClient instances use if no proxy is set explicitly in the HttpClientHandler passed through its constructor.

A instância padrão retornada por essa propriedade será inicializada seguindo um conjunto diferente de regras, dependendo da sua plataforma:The default instance returned by this property will initialize following a different set of rules depending on your platform:

  • Para Windows: Lê a configuração de proxy de variáveis de ambiente ou, se elas não estiverem definidas, nas configurações de proxy do usuário.For Windows: Reads proxy configuration from environment variables or, if those are not defined, from the user's proxy settings.

  • 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.For macOS: Reads proxy configuration from environment variables or, if those are not defined, from the system's proxy settings.

  • Para Linux: Lê a configuração de proxy de variáveis de ambiente ou, caso não estejam definidas, essa propriedade Inicializa uma instância não configurada que ignora todos os endereços.For Linux: Reads proxy configuration from environment variables or, in case those are not defined, this property initializes a non-configured instance that bypasses all addresses.

As variáveis de ambiente usadas para inicialização de DefaultProxy em plataformas baseadas no Windows e no Unix são:The environment variables used for DefaultProxy initialization on Windows and Unix-based platforms are:

  • HTTP_PROXY: o nome do host ou endereço IP do servidor proxy usado em solicitações HTTP.HTTP_PROXY: the hostname or IP address of the proxy server used on HTTP requests.
  • HTTPS_PROXY: o nome do host ou endereço IP do servidor proxy usado em solicitações HTTPS.HTTPS_PROXY: the hostname or IP address of the proxy server used on HTTPS requests.
  • ALL_PROXY: o nome do host ou endereço IP do servidor proxy usado em solicitações HTTP e/ou HTTPS no caso HTTP_PROXY e/ou HTTPS_PROXY não estão definidos.ALL_PROXY: the hostname or IP address of the proxy server used on HTTP and/or HTTPS requests in case HTTP_PROXY and/or HTTPS_PROXY are not defined.
  • NO_PROXY: uma lista separada por vírgulas de nomes de host que devem ser excluídos do proxy.NO_PROXY: a comma-separated list of hostnames that should be excluded from proxying.

Aplica-se a