<Elemento defaultProxy> (impostazioni di rete)

  • Articolo

Configura il server proxy Hypertext Transfer Protocol (HTTP).

<configurazione><system.net<>defaultProxy>

Nota

Se si esegue la migrazione a .NET 6+, configurare il server proxy usando la HttpClient.DefaultProxy proprietà .

Sintassi

<defaultProxy
  enabled="True|False"
  useDefaultCredentials="True|False">
    <bypasslist>...</bypasslist>
    <proxy>...</proxy>
    <module>...</module>
</defaultProxy>

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

elemento Descrizione
enabled Specifica se viene usato un proxy Web. Il valore predefinito è True.
useDefaultCredentials Specifica se vengono usate le credenziali predefinite per questo host per accedere al proxy Web. Il valore predefinito è False.

Elementi figlio

elemento Descrizione
bypasslist Fornisce un set di espressioni regolari che descrivono gli indirizzi che non usano il proxy.
module Aggiunge un nuovo modulo proxy all'applicazione.
Proxy Definisce un server proxy.

Elementi padre

elemento Descrizione
system.net Contiene impostazioni che specificano la modalità di connessione di .NET Framework alla rete.

Osservazioni:

Se l'elemento defaultProxy è vuoto, vengono usate le impostazioni del proxy di sistema.

Viene generata un'eccezione se l'elemento module specifica un tipo non pubblico, il tipo non deriva dalla IWebProxy classe , un'eccezione dal costruttore senza parametri di questo oggetto si è verificata o si è verificata un'eccezione durante il recupero del proxy predefinito specificato dal sistema. 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

L'esempio seguente usa le impostazioni predefinite del proxy di sistema, specifica l'indirizzo proxy e ignora il proxy per l'accesso locale e contoso.com.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy
        usesystemdefault="True"
        proxyaddress="http://192.168.1.10:3128"
        bypassonlocal="True"
      />
      <bypasslist>
        <add address="[a-z]+\.contoso\.com$" />
      </bypasslist>
    </defaultProxy>
  </system.net>
</configuration>

Vedi anche