(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde maschinell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen. Weitere Informationen
Übersetzung
Original

WebProxy-Klasse

Enthält HTTP-Proxyeinstellungen für die WebRequest-Klasse.

System.Object
  System.Net.WebProxy

Namespace:  System.Net
Assembly:  System (in System.dll)

[SerializableAttribute]
public class WebProxy : IWebProxy, ISerializable

Der WebProxy-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Öffentliche MethodeWebProxy()Initialisiert eine leere Instanz der WebProxy-Klasse.
Öffentliche MethodeWebProxy(String)Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI.
Öffentliche MethodeWebProxy(Uri)Initialisiert eine neue Instanz der WebProxy-Klasse mit der angegebenen Uri-Instanz.
Geschützte MethodeWebProxy(SerializationInfo, StreamingContext)Initialisiert unter Verwendung zuvor serialisierten Inhalts eine Instanz der WebProxy-Klasse.
Öffentliche MethodeWebProxy(String, Boolean)Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI und der angegebenen Umgehungseinstellung.
Öffentliche MethodeWebProxy(String, Int32)Initialisiert eine neue Instanz der WebProxy-Klasse mit den Angaben für Host und Anschlussnummer.
Öffentliche MethodeWebProxy(Uri, Boolean)Initialisiert eine neue Instanz der WebProxy-Klasse mit der Uri-Instanz und der Umgehungseinstellung.
Öffentliche MethodeWebProxy(String, Boolean, String[])Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI, der angegebenen Umgehungseinstellung und der Liste der zu umgehenden URIs.
Öffentliche MethodeWebProxy(Uri, Boolean, String[])Initialisiert eine neue Instanz der WebProxy-Klasse mit der angegebenen Uri-Instanz, der angegebenen Umgehungseinstellung und der Liste der zu umgehenden URIs.
Öffentliche MethodeWebProxy(String, Boolean, String[], ICredentials)Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI, der angegebenen Umgehungseinstellung, der Liste der zu umgehenden URIs und den Anmeldeinformationen.
Öffentliche MethodeWebProxy(Uri, Boolean, String[], ICredentials)Initialisiert eine neue Instanz der WebProxy-Klasse mit der angegebenen Uri-Instanz, der angegebenen Umgehungseinstellung, der Liste der zu umgehenden URIs und den Anmeldeinformationen.
Zum Seitenanfang

  NameBeschreibung
Öffentliche EigenschaftAddressRuft die Adresse des Proxyservers ab oder legt diese fest.
Öffentliche EigenschaftBypassArrayListRuft eine Liste der Adressen ab, bei denen der Proxyserver nicht verwendet wird.
Öffentliche EigenschaftBypassListRuft ein Array von Adressen ab, bei denen der Proxyserver nicht verwendet wird, oder legt diese fest.
Öffentliche EigenschaftBypassProxyOnLocalRuft einen Wert ab, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll, oder legt diesen fest.
Öffentliche EigenschaftCredentialsRuft die für die Authentifizierung an den Proxyserver zu übermittelnden Anmeldeinformationen ab oder legt diese fest.
Öffentliche EigenschaftUseDefaultCredentialsRuft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.
Zum Seitenanfang

  NameBeschreibung
Öffentliche MethodeEquals(Object)Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeStatischer MemberGetDefaultProxy Veraltet. Liest die nicht dynamischen Proxyeinstellungen von Internet Explorer.
Öffentliche MethodeGetHashCodeFungiert als die Standardhashfunktion. (Von Object geerbt.)
Geschützte MethodeGetObjectDataFüllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.
Öffentliche MethodeGetProxyGibt den Proxy-URI einer Anforderung zurück.
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Öffentliche MethodeIsBypassedGibt an, ob der Proxyserver für den angegebenen Host verwendet werden soll.
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang

  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate MethodeISerializable.GetObjectDataInfrastruktur. Erstellt die Serialisierungsdaten und den Serialisierungskontext, die vom System zum Serialisieren eines WebProxy-Objekts verwendet werden.
Zum Seitenanfang

Die WebProxy-Klasse enthält die Proxyeinstellungen, anhand derer WebRequest-Instanzen bestimmen, ob zum Senden von Anforderungen ein Webproxy verwendet wird. Globale Webproxyeinstellungen können in Computer- und Anwendungskonfigurationsdateien angegeben werden. Anwendungen können die Verwendung von Webproxys mithilfe von Instanzen der WebProxy-Klasse anpassen. Die WebProxy-Klasse ist die Basisimplementierung der IWebProxy-Schnittstelle.

Um Instanzen der Webproxyklasse abzurufen, können Sie eine der folgenden Methoden verwenden:

Jede dieser Methoden stellt eine WebProxy-Instanz bereit, die Sie weiter anpassen können. Die Methoden unterscheiden sich in der Art der Initialisierung der Instanz vor ihrer Rückgabe an die Anwendung. Der WebProxy-Konstruktor gibt eine Instanz der WebProxy-Klasse mit der auf null festgelegten Address-Eigenschaft zurück. Wenn eine Anforderung in diesem Zustand eine WebProxy-Instanz verwendet, wird die Anforderung ohne Proxy gesendet.

Die GetDefaultProxy-Methode gibt eine Instanz der WebProxy-Klasse zurück, wobei die Eigenschaften Address, BypassProxyOnLocal und BypassList auf Werte festgelegt sind, die von Internet Explorer 5.5 und höher verwendet werden.

Die Select-Methode gibt eine Instanz der WebProxy-Klasse zurück, deren Eigenschaften entsprechend einer Kombination von Einstellungen in Internet Explorer und in der Konfigurationsdatei festgelegt sind.

Die WebProxy-Klasse unterstützt die automatische Erkennung und Ausführung von Proxykonfigurationsskripts. Dieses Feature wird auch als WAPD (Web Proxy Auto-Discovery) bezeichnet. Bei der Verwendung einer automatischen Proxykonfiguration muss ein Konfigurationsskript, i. d. R. mit dem Namen Wpad.dat, gesucht, heruntergeladen, kompiliert und ausgeführt werden. Wenn diese Vorgänge erfolgreich ausgeführt wurden, gibt das Skript die Proxys zurück, die für eine Anforderung verwendet werden können.

Im folgenden Codebeispiel wird einer WebRequest-Instanz eine WebProxy-Instanz zugewiesen. Die WebRequest-Instanz verwendet den Proxy, um eine Verbindung mit externen Internetressourcen herzustellen. (Ein Beispiel, in dem die Verwendung des WPAD-Features veranschaulicht wird, finden Sie in der Dokumentation zur IWebProxyScript-Klasse.)


WebProxy proxyObject = new WebProxy("http://proxyserver:80/",true);
WebRequest req = WebRequest.Create("http://www.contoso.com");
req.Proxy = proxyObject;



.NET Framework

Unterstützt in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Unterstützt in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

Es werden nicht alle Versionen sämtlicher Plattformen von .NET Framework unterstützt.. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft