<Elemento proxy> (impostazioni di rete)

Articolo
05/09/2023

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

Condividi tramite