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>  

Confira também