HttpClient.DefaultProxy Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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, setPublic Shared Property DefaultProxy As IWebProxyValor 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á awww.example.com, mas não corresponderá aexample.com.NO_PROXY=example.com(sem ponto à esquerda) não corresponderá awww.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.
