Elemento <defaultProxy> (configurações de rede)
Configura o servidor proxy HTTP (Hypertext Transfer Protocol).
<configuration><system.net><defaultProxy>
Observação
Se você estiver migrando para o .NET 6+, configure o servidor proxy usando a propriedade HttpClient.DefaultProxy.
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
Element | Descrição |
---|---|
enabled |
Especifica se um proxy Web é usado. O valor padrão é True . |
useDefaultCredentials |
Especifica se as credenciais padrão para esse host são usadas para acessar o proxy da Web. O valor padrão é False . |
Elementos filho
Element | Descrição |
---|---|
bypasslist | Fornece um conjunto de expressões regulares que descrevem endereços que não usam o proxy. |
module | Adiciona um novo módulo proxy ao aplicativo. |
proxy | Define um servidor proxy. |
Elementos pai
Element | Descrição |
---|---|
system.net | Contém configurações que especificam como o .NET Framework se conecta à rede. |
Comentários
Se o elemento defaultProxy
estiver vazio, as configurações de proxy do sistema serão usadas.
Uma exceção será gerada se o elemento do módulo especificar um tipo não público, o tipo não é derivado da IWebProxy classe, uma exceção do construtor sem parâmetros desse objeto ocorreu ou ocorreu uma exceção ao recuperar o proxy padrão especificado pelo sistema. A propriedade InnerException na exceção deve ter mais informações sobre a causa raiz do erro.
Arquivos de configuração
Esse elemento pode ser usado no arquivo de configuração do aplicativo ou no arquivo de configuração do computador (Machine.config).
Exemplo
O exemplo a seguir usa os padrões do proxy do sistema, especifica o endereço 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>