<Elemento proxy> (impostazioni di rete)

  • Articolo

Definisce un server proxy.

<Configurazione>
  <system.net>
    <defaultProxy>
      <proxy>

Sintassi

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli 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://localhost, http://loopbacko http://127.0.0.1) e un URI senza un punto (http://webserver). Il valore predefinito è Unspecified.
proxyaddress Specifica l'URI proxy da usare.
scriptLocation Specifica il percorso dello script di configurazione. Non usare l'attributo bypassonlocal con questo attributo.
usesystemdefault Specifica se utilizzare le impostazioni proxy di sistema. Se impostato su True, gli attributi successivi eseguiranno l'override delle impostazioni proxy di sistema. Il valore predefinito è Unspecified.

Elementi figlio

Nessuno.

Elementi padre

elemento Descrizione
defaultProxy Configura il server proxy Hypertext Transfer Protocol (HTTP).

Valore di testo

Commenti

L'elemento proxy definisce un server proxy per un'applicazione. Se questo elemento non è presente nel file di configurazione, .NET Framework userà le impostazioni proxy di sistema.

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

L'attributo scriptLocation fa riferimento al rilevamento automatico degli script di configurazione del proxy. La WebProxy classe tenterà di individuare uno script di configurazione (in genere denominato Wpad.dat) quando viene selezionata l'opzione Usa script di configurazione automatica per la connessione nelle proprietà Internet. Se bypassonlocal è impostato su un valore qualsiasi, scriptLocation viene ignorato.

Viene generata un'eccezione se l'attributo proxyaddress specifica un proxy predefinito non valido. La proprietà InnerException nell'eccezione dovrebbe contenere altre informazioni sulla causa radice dell'errore.

File di configurazione

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

Esempio

Nell'esempio seguente vengono usate le impostazioni predefinite del proxy di sistema, viene specificato l'indirizzo 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>

Vedi anche