Elemento <proxy> (Configurações de rede)

Artigo
04/03/2023

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>

Compartilhar via