WebProxy Klasse

Definition

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

public ref class WebProxy : System::Runtime::Serialization::ISerializable

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

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

[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable

type WebProxy = class
    interface IWebProxy
    interface ISerializable

[<System.Serializable>]
type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Vererbung

Object

WebProxy

Attribute

SerializableAttribute

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://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.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

Eigenschaften

Methoden

Explizite Schnittstellenimplementierungen

Gilt für: