Condividi tramite

<proxy> Elemento (impostazioni di rete)

Definisce un server proxy.

<configurazione>
   <system.net>
     <defaultProxy>
       <procura>

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.

Attributes

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 sostituiranno le impostazioni proxy di sistema. Il valore predefinito è Unspecified.

Elementi figli

Nessuno.

Elementi padre

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

Valore testo

Osservazioni:

L'elemento proxy definisce un server proxy per un'applicazione. Se questo elemento non è presente nel file di configurazione, .NET Framework userà le impostazioni del 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 l'opzione Usa script di configurazione automatica è selezionata per la connessione nelle proprietà Internet. Se bypassonlocal è impostato su un valore, scriptLocation viene ignorato.

Viene generata un'eccezione se l'attributo proxyaddress specifica un proxy predefinito non valido. La InnerException proprietà sull'eccezione deve avere 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).

Example

L'esempio seguente usa le impostazioni predefinite del proxy di sistema, specifica l'indirizzo proxy e ignora 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

  • Last updated on