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

Artigo
04/11/2023

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://loopback`ou `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>

Partilhar via