WebProxy Klasse

Definition

Namespace:

System.Net

Assembly:

System.Net.WebProxy.dll

Quelle:

WebProxy.cs

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

public ref class WebProxy : System::Net::IWebProxy, System::Runtime::Serialization::ISerializable

public class WebProxy : System.Net.IWebProxy, System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Vererbung

Object

WebProxy

Implementiert

IWebProxy ISerializable

Beispiele

Im folgenden Codebeispiel wird eine HttpClient Instanz mit einer WebProxy -Instanz eingerichtet. Die HttpClient -Instanz verwendet den Proxy, um eine Verbindung mit externen Internetressourcen herzustellen. (Ein Beispiel, das die Verwendung des WPAD-Features veranschaulicht, finden Sie in der Dokumentation für die IWebProxyScript -Klasse.)

WebProxy^ proxyObject = gcnew WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClientHandler^ handler = gcnew HttpClientHandler();
handler->Proxy = proxyObject;
HttpClient^ client = gcnew HttpClient(handler);

WebProxy proxyObject = new WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
HttpClient client = new HttpClient(new HttpClientHandler
{
    Proxy = proxyObject
});

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)

' HttpClient lifecycle management best practices:
' https://learn.microsoft.com/dotnet/fundamentals/networking/http/httpclient-guidelines#recommended-use
Dim client As New HttpClient(New HttpClientHandler With
{
    .Proxy = proxyObject
})

Hinweise

Die WebProxy -Klasse enthält die Proxyeinstellungen, mit denen HttpClient Instanzen bestimmen, ob ein Webproxy zum Senden von Anforderungen verwendet wird. Globale Webproxyeinstellungen können in Computer- und Anwendungskonfigurationsdateien angegeben werden, und Anwendungen können Instanzen der -Klasse verwenden, um die WebProxy Webproxynutzung anzupassen. Die WebProxy -Klasse ist die Basisimplementierung der IWebProxy Schnittstelle.

Zum Abrufen von Instanzen der Webproxyklasse können Sie eine der folgenden Methoden verwenden:

• Der WebProxy Konstruktor.

• Die GetDefaultProxy -Methode.

• Die Select -Methode.

Diese Methoden stellen jeweils eine WebProxy Instanz bereit, die Sie weiter anpassen können. Der Unterschied besteht darin, wie die Instanz initialisiert wird, bevor sie an Ihre Anwendung zurückgegeben wird. Der WebProxy Konstruktor gibt eine Instanz der WebProxy -Klasse zurück, deren Address -Eigenschaft auf festgelegt ist null. Wenn eine Anforderung eine WebProxy Instanz in diesem Zustand verwendet, wird kein Proxy zum Senden der Anforderung verwendet.

Die GetDefaultProxy -Methode gibt eine Instanz der WebProxy -Klasse mit den AddressEigenschaften , und BypassList zurück, BypassProxyOnLocaldie auf die vom lokalen Computer verwendeten Werte festgelegt sind.

Die Select -Methode gibt eine Instanz der WebProxy -Klasse zurück, wobei die Eigenschaften gemäß einer Kombination aus Internet- und Konfigurationsdateieinstellungen festgelegt sind.

Die WebProxy -Klasse unterstützt die automatische Erkennung und Ausführung von Proxykonfigurationsskripts. Diese Funktion ist auch bekannt als Web Proxy Auto-Discovery (WPAD). Bei verwendung der automatischen Proxykonfiguration muss ein Konfigurationsskript, das in der Regel Wpad.dat genannt wird, gefunden, heruntergeladen, kompiliert und ausgeführt werden. Wenn diese Vorgänge erfolgreich sind, gibt das Skript die Proxys zurück, die für eine Anforderung verwendet werden können.

Konstruktoren

WebProxy()	Initialisiert eine leere Instanz der WebProxy-Klasse.
WebProxy(SerializationInfo, StreamingContext)	Veraltet. Initialisiert unter Verwendung zuvor serialisierten Inhalts eine Instanz der WebProxy-Klasse.
WebProxy(String)	Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI.
WebProxy(String, Boolean)	Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI und der angegebenen Umgehungseinstellung.
WebProxy(String, Boolean, String[])	Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI, der angegebenen Umgehungseinstellung und der Liste der zu umgehenden URIs.
WebProxy(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.
WebProxy(String, Int32)	Initialisiert eine neue Instanz der WebProxy-Klasse mit den Angaben für Host und Anschlussnummer.
WebProxy(Uri)	Initialisiert eine neue Instanz der WebProxy-Klasse mit der angegebenen Uri-Instanz.
WebProxy(Uri, Boolean)	Initialisiert eine neue Instanz der WebProxy-Klasse mit der Uri-Instanz und der Umgehungseinstellung.
WebProxy(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.
WebProxy(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.

Eigenschaften

Address	Ruft die Adresse des Proxyservers ab oder legt diese fest.
BypassArrayList	Ruft eine Liste der Adressen ab, bei denen der Proxyserver nicht verwendet wird.
BypassList	Ruft ein Array von Adressen ab, bei denen der Proxyserver nicht verwendet wird, oder legt diese fest.
BypassProxyOnLocal	Ruft einen booleschen Wert ab, der angibt, ob der Proxyserver für lokale Adressen umgangen werden soll, oder legt ihn fest.
Credentials	Ruft die Anmeldeinformationen ab oder legt diese fest, die an den Proxyserver zur Authentifizierung übermittelt werden sollen.
UseDefaultCredentials	Ruft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.

Methoden

Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetDefaultProxy()	Veraltet. Liest die nicht dynamischen Proxyeinstellungen der Internetoptionen.
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetObjectData(SerializationInfo, StreamingContext)	Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.
GetProxy(Uri)	Gibt den Proxy-URI einer Anforderung zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IsBypassed(Uri)	Gibt an, ob der Proxyserver für den angegebenen Host verwendet werden soll.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Erstellt die Serialisierungsdaten und den Serialisierungskontext, die vom System zum Serialisieren eines WebProxy-Objekts verwendet werden.