<proxy>-Element (Netzwerkeinstellungen)

Artikel
04/06/2023

Definiert einen Proxyserver.

<configuration>
  <system.net>
    <defaultProxy>
      <proxy>

Syntax

<proxy
  autoDetect="True|False|Unspecified"
  bypassonlocal="True|False|Unspecified"
  proxyaddress="uriString"
  scriptLocation="uriString"
  usesystemdefault="True|False|Unspecified"
/>

Attribute und Elemente

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

Attribute

Attribut	Beschreibung
`autoDetect`	Gibt an, ob der Proxy automatisch erkannt wird. Der Standardwert ist `Unspecified`.
`bypassonlocal`	Gibt an, ob der Proxy für lokale Ressourcen umgangen wird. Zu den lokalen Ressourcen gehören der lokale Server (`http://localhost`, `http://loopback` oder `http://127.0.0.1`) und ein URI ohne Punkt (`http://webserver`). Der Standardwert ist `Unspecified`.
`proxyaddress`	Gibt den zu verwendenden Proxy-URI an.
`scriptLocation`	Gibt den Speicherort des Konfigurationsskripts an. Verwenden Sie nicht das `bypassonlocal`-Attribut mit diesem Attribut.
`usesystemdefault`	Gibt an, ob Systemproxyeinstellungen verwendet werden sollen. Wenn Sie `True` festlegen, setzen die nachfolgenden Attribute die Proxyeinstellungen des Systems außer Kraft. Der Standardwert ist `Unspecified`.

Untergeordnete Elemente

Keine

Übergeordnete Elemente

Element	Beschreibung
defaultProxy	Konfiguriert den HTTP-Proxyserver (Hypertext Transfer Protocol).

Textwert

Bemerkungen

Das proxy-Element definiert einen Proxyserver für eine Anwendung. Wenn dieses Element in der Konfigurationsdatei fehlt, verwendet .NET Framework die Systemproxyeinstellungen.

Der Wert für das proxyaddress-Attribut sollte ein wohlgeformter URI (Uniform Resource Indicator) sein.

Das scriptLocation-Attribut bezieht sich auf die automatische Erkennung von Proxykonfigurationsskripts. Die WebProxy-Klasse versucht, ein Konfigurationsskript (normalerweise mit dem Namen „Wpad.dat“) zu finden, wenn für die Verbindung in den Interneteigenschaften die Option Skript für automatische Konfiguration verwenden aktiviert ist. scriptLocation wird ignoriert, wenn bypassonlocal auf einen beliebigen Wert festgelegt ist.

Wenn das proxyaddress-Attribut einen ungültigen Standardproxy angibt, wird eine Ausnahme ausgelöst. 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.

<configuration>  
  <system.net>  
    <defaultProxy>  
      <proxy  
        usesystemdefault="True"  
        proxyaddress="http://192.168.1.10:3128"  
        bypassonlocal="True"  
      />  
    </defaultProxy>  
  </system.net>  
</configuration>