WebProxy Klasa

Definicja

Zawiera ustawienia serwera proxy HTTP dla klasy WebRequest.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
Dziedziczenie
WebProxy
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu przypisuje wystąpienie WebProxy do wystąpienia WebRequest.The following code example assigns a WebProxy instance to a WebRequest instance. Wystąpienie WebRequest używa serwera proxy do łączenia się z zewnętrznymi zasobami internetowymi.The WebRequest instance uses the proxy to connect to external Internet resources. (Przykład demonstrujący korzystanie z funkcji WPAD można znaleźć w dokumentacji klasy IWebProxyScript).(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

Uwagi

Klasa WebProxy zawiera ustawienia serwera proxy, których WebRequest wystąpienia używa do określenia, czy serwer proxy sieci Web jest używany do wysyłania żądań.The WebProxy class contains the proxy settings that WebRequest instances use to determine whether a Web proxy is used to send requests. Globalne ustawienia serwera proxy sieci Web można określić w plikach konfiguracji komputera i aplikacji, a aplikacje mogą używać wystąpień klasy WebProxy, aby dostosować użycie serwera proxy sieci Web.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. Klasa WebProxy jest podstawową implementacją interfejsu IWebProxy.The WebProxy class is the base implementation of the IWebProxy interface.

Aby uzyskać wystąpienia klasy proxy sieci Web, można użyć dowolnej z następujących metod:To obtain instances of the Web proxy class, you can use any of the following methods:

Te metody udostępniają wystąpienie WebProxy, które można bardziej dostosować. różnica między nimi polega na sposobie inicjowania wystąpienia przed zwróceniem ich do aplikacji.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. Konstruktor WebProxy zwraca wystąpienie klasy WebProxy z właściwością Address ustawioną na null.The WebProxy constructor returns an instance of the WebProxy class with the Address property set to null. Gdy żądanie używa wystąpienia WebProxy w tym stanie, do wysłania żądania nie jest używany żaden serwer proxy.When a request uses a WebProxy instance in this state, no proxy is used to send the request.

Metoda GetDefaultProxy zwraca wystąpienie klasy WebProxy z właściwościami Address, BypassProxyOnLocali BypassList ustawionymi na wartości używane przez Internet Explorer 5,5 i nowsze.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.

Metoda Select zwraca wystąpienie klasy WebProxy z właściwościami IT ustawionymi zgodnie z kombinacją ustawień programu Internet Explorer i pliku konfiguracji.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.

Klasa WebProxy obsługuje automatyczne wykrywanie i wykonywanie skryptów konfiguracji serwera proxy.The WebProxy class supports automatic detection and execution of proxy configuration scripts. Ta funkcja jest nazywana również autowykrywaniem serwera proxy sieci Web (WPAD).This feature is also known as Web Proxy Auto-Discovery (WPAD). W przypadku korzystania z automatycznej konfiguracji serwera proxy skrypt konfiguracji o nazwie WPAD. dat musi być zlokalizowany, pobrany, skompilowany i uruchomiony.When using automatic proxy configuration, a configuration script, typically named Wpad.dat, must be located, downloaded, compiled, and run. Jeśli te operacje zakończą się pomyślnie, skrypt zwróci serwery proxy, których można użyć dla żądania.If these operations are successful, the script returns the proxies that can be used for a request.

Konstruktory

WebProxy()

Inicjuje puste wystąpienie klasy WebProxy.Initializes an empty instance of the WebProxy class.

WebProxy(SerializationInfo, StreamingContext)

Inicjuje wystąpienie klasy WebProxy przy użyciu wcześniej zserializowanej zawartości.Initializes an instance of the WebProxy class using previously serialized content.

WebProxy(String)

Inicjuje nowe wystąpienie klasy WebProxy z określonym identyfikatorem URI.Initializes a new instance of the WebProxy class with the specified URI.

WebProxy(String, Boolean)

Inicjuje nowe wystąpienie klasy WebProxy z określonym identyfikatorem URI i ustawieniem obejścia.Initializes a new instance of the WebProxy class with the specified URI and bypass setting.

WebProxy(String, Boolean, String[])

Inicjuje nowe wystąpienie klasy WebProxy z określonym identyfikatorem URI, ustawieniem obejścia oraz listą identyfikatorów URI do obejścia.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)

Inicjuje nowe wystąpienie klasy WebProxy z określonym identyfikatorem URI, ustawieniem obejścia, listą identyfikatorów URI do obejścia i poświadczeniami.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, list of URIs to bypass, and credentials.

WebProxy(String, Int32)

Inicjuje nowe wystąpienie klasy WebProxy z określonym hostem i numerem portu.Initializes a new instance of the WebProxy class with the specified host and port number.

WebProxy(Uri)

Inicjuje nowe wystąpienie klasy WebProxy z określonego wystąpienia Uri.Initializes a new instance of the WebProxy class from the specified Uri instance.

WebProxy(Uri, Boolean)

Inicjuje nowe wystąpienie klasy WebProxy z wystąpieniem Uri i ustawieniem obejścia.Initializes a new instance of the WebProxy class with the Uri instance and bypass setting.

WebProxy(Uri, Boolean, String[])

Inicjuje nowe wystąpienie klasy WebProxy przy użyciu określonego wystąpienia Uri, ustawienia obejścia i listy identyfikatorów URI do obejścia.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)

Inicjuje nowe wystąpienie klasy WebProxy z określonym wystąpieniem Uri, ustawienie obejścia, listę identyfikatorów URI do obejścia i poświadczenia.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, list of URIs to bypass, and credentials.

Właściwości

Address

Pobiera lub ustawia adres serwera proxy.Gets or sets the address of the proxy server.

BypassArrayList

Pobiera listę adresów, które nie korzystają z serwera proxy.Gets a list of addresses that do not use the proxy server.

BypassList

Pobiera lub ustawia tablicę adresów, która nie korzysta z serwera proxy.Gets or sets an array of addresses that do not use the proxy server.

BypassProxyOnLocal

Pobiera lub ustawia wartość wskazującą, czy serwer proxy ma być pomijany dla adresów lokalnych.Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

Credentials

Pobiera lub ustawia poświadczenia do przesłania do serwera proxy w celu uwierzytelnienia.Gets or sets the credentials to submit to the proxy server for authentication.

UseDefaultCredentials

Pobiera lub ustawia wartość Boolean, która kontroluje, czy DefaultCredentials są wysyłane z żądaniami.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Metody

CreateDefaultProxy()
Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetDefaultProxy()

Odczytuje ustawienia niedynamicznego serwera proxy programu Internet Explorer.Reads the Internet Explorer nondynamic proxy settings.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)

Wypełnia SerializationInfo danymi, które są konieczne do serializacji obiektu docelowego.Populates a SerializationInfo with the data that is needed to serialize the target object.

GetProxy(Uri)

Zwraca identyfikator URI serwera proxy dla żądania.Returns the proxied URI for a request.

GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
IsBypassed(Uri)

Wskazuje, czy serwer proxy ma być używany dla określonego hosta.Indicates whether to use the proxy server for the specified host.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Jawne implementacje interfejsu

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Tworzy dane serializacji i kontekst, które są używane przez system do serializacji obiektu WebProxy.Creates the serialization data and context that are used by the system to serialize a WebProxy object.

Dotyczy