Partilhar via

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

Define um servidor proxy.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy>

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 é detetado automaticamente. O valor predefinido é Unspecified.
bypassonlocal Especifica se o proxy é contornado para recursos locais. Os recursos locais incluem o servidor local (http://localhost, http://loopback, ou http://127.0.0.1) e um URI sem ponto (http://webserver). O valor predefinido é Unspecified.
proxyaddress Especifica o URI proxy a usar.
scriptLocation Especifica a localização do script de configuração. Não uses o bypassonlocal atributo com este atributo.
usesystemdefault Especifica se deve usar as definições do proxy do sistema. Se definido como True, os atributos subsequentes irão sobrepor as definições do proxy do sistema. O valor predefinido é Unspecified.

Elementos Subordinados

Nenhum.

Elementos Principais

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

Valor do 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, então o .NET Framework usará as definições do proxy do sistema.

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

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

É lançada uma exceção se o proxyaddress atributo especificar um proxy padrão inválido. A InnerException propriedade na exceção deve conter mais informação sobre a causa raiz do erro.

Arquivos de configuração

Este elemento pode ser usado no ficheiro de configuração da aplicação ou no ficheiro de configuração da máquina (Machine.config).

Example

O exemplo seguinte utiliza os valores predefinidos do proxy do sistema, especifica o endereço do proxy e contorna 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