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

Artigo
08/01/2011

Define um servidor proxy.

<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 será detectado automaticamente. O valor padrão é unspecified.
bypassonlocal	Especifica se o proxy é ignorado para recursos locais. Recursos locais incluem o servidor local (https://localhost, https://loopback ou http://127.0.0.1) e um URI sem um período (http://servidorweb). O valor padrão é unspecified.
proxyaddress	Especifica o URI para usar proxy.
scriptLocation	Especifica o local do script de configuração.
usesystemdefault	Especifica se deve usar configurações de proxy do Internet Explorer. Se definido como true, os atributos subseqüentes substituirá as configurações de proxy do Internet Explorer. O valor padrão é unspecified.

Elementos filho

Nenhum.

Elementos pai

Elemento	Descrição
defaultProxy	Configura o servidor de proxy do protocolo de transferência de hipertexto (HTTP).

Comentários

O proxy elemento define um servidor proxy para um aplicativo. Se esse elemento está ausente do arquivo de configuração, o.NET Framework usará as configurações de proxy no Internet Explorer.

O valor para o proxyaddress atributo deve ser um bem formado indicador URI (Uniform Resource).

O scriptLocation atributo refere-se a detecção automática de scripts de configuração de proxy. O WebProxy classe tentará localizar um script de configuração (normalmente denominado WPAD. dat) quando o usar o script de configuração automática opção é selecionada no Internet Explorer.

Use o atributo deusesystemdefault .NET versão 1.1 Framework que está migrando para a versão 2.0.

Uma exceção é lançada se o proxyaddress atributo especifica um proxy padrão inválido. O InnerException propriedade sobre a exceção deve ter mais informações sobre a causa do erro.

Configuration Files

Esse elemento pode ser usado no arquivo de configuração do aplicativo ou o arquivo de configuração da máquina (Machine. config).

Exemplo

O exemplo de código a seguir utiliza os padrões do proxy do Internet Explorer, especifica o endereço de 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

Referência

Esquema configurações de rede

System.Net.WebProxy

Compartilhar via