Compartilhar via

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

Define um servidor proxy.

<configuração>
   <system.net>
     <defaultProxy>
       <procuração>

Sintaxe

<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.

Attributes

Atributo Descrição
autoDetect Especifica se o proxy é detectado automaticamente. O valor padrão é Unspecified.
bypassonlocal Especifica se o proxy é ignorado para recursos locais. Os recursos locais incluem o servidor local (http://localhostou http://127.0.0.1http://loopback) e um URI sem um período (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 bypassonlocal atributo 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

Elemento Descrição
defaultProxy Configura o servidor proxy HTTP (Protocolo de Transferência de Hipertexto).

Valor do texto

Observações

O proxy elemento 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 proxyaddress atributo deve ser um URI (Uniform Resource Indicator) bem formado.

O scriptLocation atributo refere-se à detecção automática de scripts de configuração de proxy. A WebProxy classe 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 for definido como qualquer valor, scriptLocation será ignorado.

Uma exceção será gerada se o proxyaddress atributo especificar um proxy padrão inválido. A InnerException propriedade 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).

Example

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>

Consulte também

  • Last updated on