Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Aktualisiert: November 2007
Definiert einen Proxyserver.
<configuration>-Element
<system.Net>-Element (Netzwerkeinstellungen)
<defaultProxy>-Element (Netzwerkeinstellungen)
<proxy>-Element (Netzwerkeinstellungen)
<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 sowie ü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 umgegangen 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 |
Beschreibung |
|---|---|
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.
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>