<Elemento defaultProxy> (impostazioni di rete)

Articolo
08/15/2023

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>

Condividi tramite