<elemento defaultProxy> (configurações de rede)

Artigo
08/15/2023

Configura o servidor proxy HTTP (Hypertext Transfer Protocol).

<configuração><system.net<>defaultProxy>

Nota

Se você estiver migrando para o .NET 6+, configure o servidor proxy usando a HttpClient.DefaultProxy propriedade.

Sintaxe

<defaultProxy
  enabled="True|False"
  useDefaultCredentials="True|False">
    <bypasslist>...</bypasslist>
    <proxy>...</proxy>
    <module>...</module>
</defaultProxy>

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Elemento	Descrição
`enabled`	Especifica se um proxy da Web é usado. O valor predefinido é `True`.
`useDefaultCredentials`	Especifica se as credenciais padrão para esse host são usadas para acessar o proxy da Web. O valor predefinido é `False`.

Elementos filho

Elemento	Descrição
lista de desvios	Fornece um conjunto de expressões regulares que descrevem endereços que não usam o proxy.
módulo	Adiciona um novo módulo proxy ao aplicativo.
procuração	Define um servidor proxy.

Elementos pai

Elemento	Descrição
system.net	Contém configurações que especificam como o .NET Framework se conecta à rede.

Observações

Se o defaultProxy elemento estiver vazio, as configurações de proxy do sistema serão usadas.

Uma exceção é lançada se o elemento module especificar um tipo não-público, o tipo não estiver derivando da IWebProxy classe, uma exceção do construtor sem parâmetros deste objeto ocorreu ou uma exceção ocorreu ao recuperar o proxy padrão especificado pelo sistema. A InnerException propriedade na exceção deve ter mais informações sobre a causa raiz do erro.

Arquivos de configuração

Este elemento pode ser usado no arquivo de configuração do aplicativo ou no arquivo de configuração da máquina (Machine.config).

Exemplo

O exemplo a seguir usa os padrões do proxy do sistema, especifica o endereço do proxy e ignora o proxy para acesso local e contoso.com.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="True"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="True"
      />
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>

Partilhar via