Elemento <proxy> (Impostazioni di rete)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Consente di definire un server proxy.

Elemento <Configuration>
  Elemento <system.Net> (Impostazioni di rete)
    Elemento <defaultProxy> (Impostazioni di rete)
      Elemento <proxy> (Impostazioni di rete)

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

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

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

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