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 für die Verwendung des WPAD-Features finden Sie in der Dokumentation für die IWebProxyScript Klasse.)

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, die Instanzen verwenden, um zu bestimmen, HttpClient 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 Verwendung von Webproxys 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, auf die die Address Eigenschaft 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 zurück, deren AddressEigenschaften BypassProxyOnLocalBypassList auf die vom lokalen Computer verwendeten Werte festgelegt sind.

Die Select Methode gibt eine Instanz der WebProxy Klasse zurück, deren Eigenschaften entsprechend einer Kombination aus Internet- und Konfigurationsdateieinstellungen festgelegt sind.

Die WebProxy Klasse unterstützt die automatische Erkennung und Ausführung von Proxykonfigurationsskripts. Dieses Feature wird auch als Webproxy-AutoErmittlung (WPAD) bezeichnet. 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.