Elemento <proxy> (Configurações de rede)
Define um servidor proxy.
<configuration>
<system.net>
<defaultProxy>
<proxy>
Syntax
<proxy
autoDetect="True|False|Unspecified"
bypassonlocal="True|False|Unspecified"
proxyaddress="uriString"
scriptLocation="uriString"
usesystemdefault="True|False|Unspecified"
/>
Atributos e elementos
As seções a seguir descrevem atributos, elementos filho e elementos pai.
Atributos
Atributo | Descrição |
---|---|
autoDetect |
Especifica se o proxy é detectado automaticamente. O valor padrão é Unspecified . |
bypassonlocal |
Especifica se o proxy é ignorado para os recursos locais. Os recursos locais incluem o servidor local (http://localhost , http://loopback ou http://127.0.0.1 ) e um URI sem um ponto (http://webserver ). O valor padrão é Unspecified . |
proxyaddress |
Especifica o URI do proxy a ser usado. |
scriptLocation |
Especifica o local do script de configuração. Não use o atributo bypassonlocal com esse atributo. |
usesystemdefault |
Especifica se as configurações de proxy do sistema devem ser usadas. Se definido como True , os atributos subsequentes substituirão as configurações de proxy do sistema. O valor padrão é Unspecified . |
Elementos filho
Nenhum.
Elementos pai
Element | Descrição |
---|---|
defaultProxy | Configura o servidor proxy HTTP (Hypertext Transfer Protocol). |
Valor de texto
Comentários
O elemento proxy
define um servidor proxy para um aplicativo. Se esse elemento estiver ausente do arquivo de configuração, o .NET Framework usará as configurações de proxy do sistema.
O valor do atributo proxyaddress
deve ser um URI (Uniform Resource Indicator) bem formado.
O atributo scriptLocation
refere-se à detecção automática de scripts de configuração de proxy. A classe WebProxy tentará localizar um script de configuração (geralmente chamado Wpad.dat) quando a opção Usar script de configuração automática for selecionada para a conexão nas propriedades da Internet. Se bypassonlocal
estiver definido como qualquer valor, scriptLocation
será ignorado.
Uma exceção será gerada se o atributo proxyaddress
especificar um proxy padrão inválido. 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.
<configuration>
<system.net>
<defaultProxy>
<proxy
usesystemdefault="True"
proxyaddress="http://192.168.1.10:3128"
bypassonlocal="True"
/>
</defaultProxy>
</system.net>
</configuration>