<proxy>-Element (Netzwerkeinstellungen)

Artikel
08/10/2011

Definiert einen Proxyserver.

<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, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribute	Beschreibungen
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. Lokale Ressourcen schließen den lokalen Server (https://localhost, https://loopback oder http://127.0.0.1) und einen URI ohne einen Punkt (http://webserver) ein. Der Standardwert ist unspecified.
proxyaddress	Gibt den zu verwendenden Proxy-URI an.
scriptLocation	Gibt den Speicherort des Konfigurationsskripts an.
usesystemdefault	Gibt an, ob Internet Explorer-Proxyeinstellungen verwendet werden. Falls auf true festgelegt, überschreiben nachfolgende Attribute die Internet Explorer-Proxyeinstellungen. Der Standardwert ist unspecified.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibungen
<defaultProxy>	Konfiguriert den HTTP-Proxyserver (Hypertext Transfer Protocol).

Hinweise

Das <proxy>-Element definiert einen Proxyserver für eine Anwendung. Wenn dieses Element in der Konfigurationsdatei fehlt, verwendet .NET Framework die Proxyeinstellungen von Internet Explorer.

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

Das scriptLocation-Attribut verweist auf die automatische Erkennung von Proxykonfigurationsskripts. Wenn die Option Automatisches Konfigurationsskript verwenden in Internet Explorer ausgewählt ist, versucht die WebProxy-Klasse, ein lokales Konfigurationsskript ausfindig zu machen (dieses heißt üblicherweise Wpad.dat).

Verwenden Sie das usesystemdefault-Attribut für .NET Framework Version 1.1-Anwendungen, die zu Version 2.0 migriert werdem.

Eine Ausnahme wird ausgelöst, wenn das proxyaddress-Attribut einen ungültigen Standardproxy angibt. Die InnerException-Eigenschaft für die Ausnahme enthält zusätzliche Informationen zur Fehlerursache.

Konfigurationsdateien

Dieses Element kann in der Konfigurationsdatei der Anwendung oder in der Konfigurationsdatei des Computers (Machine.config) verwendet werden.

Beispiel

Das folgende Codebeispiel verwendet die Standardeinstellungen des Internet Explorer-Proxys, 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

Referenz

Netzwerkeinstellungsschema

System.Net.WebProxy

Freigeben über