WebProxy WebProxy WebProxy WebProxy Class

Definition

Enthält HTTP-Proxyeinstellungen für die WebRequest-Klasse.Contains HTTP proxy settings for the WebRequest class.

public ref class WebProxy : System::Runtime::Serialization::ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
type WebProxy = class
    interface ISerializable
    interface IWebProxy
Public Class WebProxy
Implements ISerializable
Vererbung
WebProxyWebProxyWebProxyWebProxy
Attribute
Implementiert

Beispiele

Im folgenden Codebeispiel Beispiel weist eine WebProxy -Instanz, auf eine WebRequest Instanz.The following code example assigns a WebProxy instance to a WebRequest instance. Die WebRequest Instanz des Proxys für die Verbindung und externe Ressourcen im Internet verwendet.The WebRequest instance uses the proxy to connect to external Internet resources. (Ein Beispiel zur Veranschaulichung mithilfe des WPAD-Features finden Sie unter der Dokumentation für die IWebProxyScript Klasse.)(For an example that demonstrates using the WPAD feature, see the documentation for the IWebProxyScript class.)

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

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)
Dim req As WebRequest = WebRequest.Create("http://www.contoso.com")
req.Proxy = proxyObject

Hinweise

Die WebProxy -Klasse enthält die Proxy-Einstellungen, die WebRequest Instanzen verwenden, um zu bestimmen, ob ein Webproxy verwendet wird, um Anforderungen zu senden.The WebProxy class contains the proxy settings that WebRequest instances use to determine whether a Web proxy is used to send requests. Globale Web Proxy-Einstellungen in Anwendungskonfigurationsdateien, Computer- und Anwendungen angegeben werden können, können Instanzen von der WebProxy Klasse, um die Web-Proxy-Verwendung anpassen.Global Web proxy settings can be specified in machine and application configuration files, and applications can use instances of the WebProxy class to customize Web proxy use. Die WebProxy Klasse ist die basisimplementierung für die IWebProxy Schnittstelle.The WebProxy class is the base implementation of the IWebProxy interface.

Um Instanzen der Webdienst-Proxyklasse zu erhalten, können Sie eine der folgenden Methoden verwenden:To obtain instances of the Web proxy class, you can use any of the following methods:

Geben Sie jede dieser Methoden eine WebProxy -Instanz, die Sie weitere können anpassen, wird des Unterschied zwischen ihnen, wie die Instanz initialisiert wird, bevor er an die Anwendung zurückgegeben wird.These methods each supply a WebProxy instance that you can further customize; the difference between them is how the instance is initialized before it is returned to your application. Die WebProxy Konstruktor gibt eine Instanz des der WebProxy -Klasse mit der Address -Eigenschaftensatz auf null.The WebProxy constructor returns an instance of the WebProxy class with the Address property set to null. Wenn eine Anforderung verwendet eine WebProxy Instanz in diesem Fall kein Proxy wird verwendet, um die Anforderung zu senden.When a request uses a WebProxy instance in this state, no proxy is used to send the request.

Die GetDefaultProxy Methode gibt eine Instanz des der WebProxy -Klasse mit der Address, BypassProxyOnLocal, und BypassList Eigenschaften festgelegt werden, auf die Werte, die von Internet Explorer 5.5 und höher verwendet.The GetDefaultProxy method returns an instance of the WebProxy class with the Address, BypassProxyOnLocal, and BypassList properties set to the values used by Internet Explorer 5.5 and later.

Die Select Methode gibt eine Instanz des der WebProxy Klasse mit Eigenschaften, die gemäß einer Kombination von Einstellungen in Internet Explorer und die Konfiguration festgelegt.The Select method returns an instance of the WebProxy class with it properties set according to a combination of Internet Explorer and configuration file settings.

Die WebProxy Klasse unterstützt die automatische Erkennung und Ausführung von Proxy-Konfigurationsskripts.The WebProxy class supports automatic detection and execution of proxy configuration scripts. Diese Funktion ist auch bekannt als Web Proxy Auto-Discovery (WPAD).This feature is also known as Web Proxy Auto-Discovery (WPAD). Bei Verwendung der automatischen Proxy-Konfiguration muss ein Konfigurationsskript, in der Regel mit der Bezeichnung "WPAD.dat", sich befindet, heruntergeladen, kompiliert und ausgeführt werden.When using automatic proxy configuration, a configuration script, typically named Wpad.dat, must be located, downloaded, compiled, and run. Wenn diese Vorgänge erfolgreich sind, gibt das Skript die Proxys, die für eine Anforderung verwendet werden können.If these operations are successful, the script returns the proxies that can be used for a request.

Konstruktoren

WebProxy() WebProxy() WebProxy() WebProxy()

Initialisiert eine leere Instanz der WebProxy-Klasse.Initializes an empty instance of the WebProxy class.

WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext)

Initialisiert unter Verwendung zuvor serialisierten Inhalts eine Instanz der WebProxy-Klasse.Initializes an instance of the WebProxy class using previously serialized content.

WebProxy(String) WebProxy(String) WebProxy(String) WebProxy(String)

Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI.Initializes a new instance of the WebProxy class with the specified URI.

WebProxy(String, Boolean) WebProxy(String, Boolean) WebProxy(String, Boolean) WebProxy(String, Boolean)

Initialisiert eine neue Instanz der WebProxy-Klasse mit dem angegebenen URI und der angegebenen Umgehungseinstellung.Initializes a new instance of the WebProxy class with the specified URI and bypass setting.

WebProxy(String, Boolean, String[]) WebProxy(String, Boolean, String[]) WebProxy(String, Boolean, String[]) 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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, and list of URIs to bypass.

WebProxy(String, Boolean, String[], ICredentials) WebProxy(String, Boolean, String[], ICredentials) WebProxy(String, Boolean, String[], ICredentials) 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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, list of URIs to bypass, and credentials.

WebProxy(String, Int32) WebProxy(String, Int32) WebProxy(String, Int32) WebProxy(String, Int32)

Initialisiert eine neue Instanz der WebProxy-Klasse mit den Angaben für Host und Anschlussnummer.Initializes a new instance of the WebProxy class with the specified host and port number.

WebProxy(Uri) WebProxy(Uri) WebProxy(Uri) WebProxy(Uri)

Initialisiert eine neue Instanz der WebProxy-Klasse mit der angegebenen Uri-Instanz.Initializes a new instance of the WebProxy class from the specified Uri instance.

WebProxy(Uri, Boolean) WebProxy(Uri, Boolean) WebProxy(Uri, Boolean) WebProxy(Uri, Boolean)

Initialisiert eine neue Instanz der WebProxy-Klasse mit der Uri-Instanz und der Umgehungseinstellung.Initializes a new instance of the WebProxy class with the Uri instance and bypass setting.

WebProxy(Uri, Boolean, String[]) WebProxy(Uri, Boolean, String[]) WebProxy(Uri, Boolean, String[]) 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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, and list of URIs to bypass.

WebProxy(Uri, Boolean, String[], ICredentials) WebProxy(Uri, Boolean, String[], ICredentials) WebProxy(Uri, Boolean, String[], ICredentials) 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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, list of URIs to bypass, and credentials.

Eigenschaften

Address Address Address Address

Ruft die Adresse des Proxyservers ab oder legt diese fest.Gets or sets the address of the proxy server.

BypassArrayList BypassArrayList BypassArrayList BypassArrayList

Ruft eine Liste der Adressen ab, bei denen der Proxyserver nicht verwendet wird.Gets a list of addresses that do not use the proxy server.

BypassList BypassList BypassList BypassList

Ruft ein Array von Adressen ab, bei denen der Proxyserver nicht verwendet wird, oder legt diese fest.Gets or sets an array of addresses that do not use the proxy server.

BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal BypassProxyOnLocal

Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Proxyserver bei lokalen Adressen umgangen werden soll.Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

Credentials Credentials Credentials Credentials

Ruft die Anmeldeinformationen ab oder legt diese fest, die an den Proxyserver zur Authentifizierung übermittelt werden sollen.Gets or sets the credentials to submit to the proxy server for authentication.

UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials UseDefaultCredentials

Ruft einen Boolean-Wert ab, der steuert, ob mit den Anforderungen DefaultCredentials gesendet werden, oder legt diesen fest.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Methoden

CreateDefaultProxy() CreateDefaultProxy() CreateDefaultProxy() CreateDefaultProxy()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetDefaultProxy() GetDefaultProxy() GetDefaultProxy() GetDefaultProxy()

Liest die nicht dynamischen Proxyeinstellungen von Internet Explorer.Reads the Internet Explorer nondynamic proxy settings.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Füllt eine SerializationInfo mit den Daten auf, die zum Serialisieren des Zielobjekts erforderlich sind.Populates a SerializationInfo with the data that is needed to serialize the target object.

GetProxy(Uri) GetProxy(Uri) GetProxy(Uri) GetProxy(Uri)

Gibt den Proxy-URI einer Anforderung zurück.Returns the proxied URI for a request.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IsBypassed(Uri) IsBypassed(Uri) IsBypassed(Uri) IsBypassed(Uri)

Gibt an, ob der Proxyserver für den angegebenen Host verwendet werden soll.Indicates whether to use the proxy server for the specified host.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Erstellt die Serialisierungsdaten und den Serialisierungskontext, die vom System zum Serialisieren eines WebProxy-Objekts verwendet werden.Creates the serialization data and context that are used by the system to serialize a WebProxy object.

Gilt für: