<defaultProxy>-Element (Netzwerkeinstellungen)

Artikel
08/17/2023

Konfiguriert den HTTP-Proxyserver (Hypertext Transfer Protocol).

<configuration><system.net><defaultProxy>

Hinweis

Wenn Sie zu .NET 6 und höher migrieren, konfigurieren Sie den Proxyserver mithilfe der HttpClient.DefaultProxy-Eigenschaft.

Syntax

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Element	Beschreibung
`enabled`	Gibt an, ob ein Webproxy verwendet wird. Der Standardwert ist `True`.
`useDefaultCredentials`	Gibt an, ob die Standardanmeldeinformationen für diesen Host für den Zugriff auf den Webproxy verwendet werden. Der Standardwert ist `False`.

Untergeordnete Elemente

Element	Beschreibung
bypasslist	Gibt einen Satz von regulären Ausdrücken zur Beschreibung der Adressen an, die keinen Proxy verwenden.
module	Fügt der Anwendung ein neues Proxymodul hinzu.
proxy	Definiert einen Proxyserver.

Übergeordnete Elemente

Element	Beschreibung
system.net	Enthält Einstellungen, die festlegen, wie Verbindungen zwischen .NET Framework und dem Netzwerk hergestellt werden.

Hinweise

Wenn das defaultProxy-Element leer ist, werden die Proxyeinstellungen des Systems verwendet.

Es wird eine Ausnahme ausgelöst, wenn das module-Element einen nicht öffentlichen Typ angibt, der Typ nicht von der IWebProxy-Klasse abgeleitet ist, eine Ausnahme vom parameterlosen Konstruktor dieses Objekts ausgelöst wurde oder beim Abrufen des vom System angegebenen Standardproxys eine Ausnahme aufgetreten ist. Die InnerException-Eigenschaft für die Ausnahme muss zusätzliche Informationen zur Fehlerursache enthalten.

Konfigurationsdateien

Dieses Element kann in der Anwendungskonfigurationsdatei oder in der Computerkonfigurationsdatei ("Machine.config") verwendet werden.

Beispiel

Das folgende Beispiel verwendet die Standardeinstellungen des Systemproxys, gibt die Proxyadresse an und umgeht den Proxy für den lokalen Zugriff und 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>

Freigeben über