<defaultProxy>-Element (Netzwerkeinstellungen)

  • Artikel

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>

Siehe auch