Freigeben über


<proxy>-Element (Netzwerkeinstellungen)

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>  

Siehe auch