<Elemento proxy> (Definições de Rede)

Define um servidor proxy.

<configuração>
  <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 secções seguintes descrevem atributos, elementos subordinados e elementos principais.

Atributos

Atributo Descrição
autoDetect Especifica se o proxy é detetado automaticamente. O valor predefinido é Unspecified.
bypassonlocal Especifica se o proxy é ignorado para recursos locais. Os recursos locais incluem o servidor local (http://localhost, http://loopbackou http://127.0.0.1) e um URI sem um ponto final (http://webserver). O valor predefinido é Unspecified.
proxyaddress Especifica o URI do proxy a utilizar.
scriptLocation Especifica a localização do script de configuração. Não utilize o bypassonlocal atributo com este atributo.
usesystemdefault Especifica se deve utilizar as definições de proxy do sistema. Se estiver definido como True, os atributos subsequentes substituirão as definições de proxy do sistema. O valor predefinido é Unspecified.

Elementos Subordinados

Nenhum.

Elementos Principais

Elemento Descrição
defaultProxy Configura o servidor proxy do Hypertext Transfer Protocol (HTTP).

Valor de Texto

Observações

O proxy elemento define um servidor proxy para uma aplicação. Se este elemento estiver em falta no ficheiro de configuração, .NET Framework utilizará as definições de proxy do sistema.

O valor do proxyaddress atributo deve ser um Indicador de Recursos Uniformes (URI) bem formado.

O scriptLocation atributo refere-se à deteção automática de scripts de configuração de proxy. A WebProxy classe tentará localizar um script de configuração (normalmente denominado Wpad.dat) quando a opção Utilizar script de configuração automática estiver selecionada para a ligação nas propriedades da Internet. Se bypassonlocal estiver definido como qualquer valor, scriptLocation será ignorado.

É emitida uma exceção se o proxyaddress atributo especificar um proxy predefinido inválido. A InnerException propriedade na exceção deve ter mais informações sobre a causa do erro.

Ficheiros de Configuração

Este elemento pode ser utilizado no ficheiro de configuração da aplicação ou no ficheiro de configuração do computador (Machine.config).

Exemplo

O exemplo seguinte utiliza as predefinições do proxy de 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>  

Ver também