Elemento <proxy> (Impostazioni di rete)

Articolo
08/11/2011

Consente di definire un server proxy.

<proxy 
  autoDetect="true|false|unspecified"  
  bypassonlocal="true|false|unspecified" 
proxyaddress="uriString"
  scriptLocation="uriString" 
  usesystemdefault="true|false|unspecified " 
/>

Attributi ed elementi

Nelle sezioni seguenti vengono illustrati attributi, elementi figlio e padre.

Attributi

Attribute	Oggetto di descrizione
autoDetect	Specifica se il proxy viene rilevato automaticamente. Il valore predefinito è unspecified.
bypassonlocal	Specifica se il proxy viene ignorato per le risorse locali. Le risorse locali includono il server locale (http://hostlocale, https://loopback o http://127.0.0.1) e un URI senza punto (http://serverweb). Il valore predefinito è unspecified.
proxyaddress	Specifica l'URI del proxy da utilizzare.
scriptLocation	Specifica il percorso dello script di configurazione.
usesystemdefault	Specifica se utilizzare le impostazioni proxy di Internet Explorer. Se impostato su true, gli attributi successivi eseguiranno l'override delle impostazioni proxy di Internet Explorer. Il valore predefinito è unspecified.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Oggetto di descrizione
<defaultProxy>	Configura il server proxy Hypertext Transfer Protocol (HTTP).

Note

L'elemento <proxy> consente di definire un server proxy per un'applicazione. Se questo elemento non è incluso nel file di configurazione, .NET Framework utilizzerà le impostazioni proxy di Internet Explorer.

Il valore dell'attributo proxyaddress deve essere un URI (Uniform Resource Indicator) ben formato.

L'attributo scriptLocation si riferisce al rilevamento automatico degli script di configurazione del proxy. La classe WebProxy tenterà di individuare uno script di configurazione, generalmente denominato Wpad.dat, quando viene selezionata l'opzione Utilizza script di configurazione automatica di Internet Explorer.

Utilizzare l'attributo usesystemdefault per le applicazioni .NET Framework versione 1.1 che eseguono la migrazione alla versione 2.0.

Viene generata un'eccezione se l'attributo proxyaddress specifica un proxy predefinito non valido. La proprietà InnerException sull'eccezione deve disporre di maggiori informazioni sulla causa principale dell'errore.

File di configurazione

L'elemento può essere utilizzato nel file di configurazione dell'applicazione o nel file di configurazione del computer (Machine.config).

Esempio

Nell'esempio di codice riportato di seguito vengono utilizzate le impostazioni predefinite del proxy di Internet Explorer, viene specificato l'indirizzo del proxy e viene ignorato il proxy per l'accesso locale.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="true"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="true"
      />
    </defaultProxy>
  </system.net>
</configuration>

Vedere anche

Riferimenti

Schema delle impostazioni di rete

System.Net.WebProxy

Condividi tramite