WebProxy Klasa

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebProxy.dll

Zestaw:

System.dll

Zestaw:

netstandard.dll

Zawiera ustawienia serwera proxy HTTP dla WebRequest klasy .

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

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

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Dziedziczenie

Object

WebProxy

Atrybuty

SerializableAttribute

Implementuje

IWebProxy ISerializable

Przykłady

Poniższy przykład kodu przypisuje WebProxy wystąpienie do WebRequest wystąpienia. Wystąpienie WebRequest używa serwera proxy do łączenia się z zewnętrznymi zasobami internetowymi. (Aby zapoznać się z przykładem użycia funkcji WPAD, zobacz dokumentację IWebProxyScript dla klasy).

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 używane WebRequest przez wystąpienia do określania, czy serwer proxy sieci Web jest używany do wysyłania żądań. Globalne ustawienia serwera proxy sieci Web można określić w plikach konfiguracji maszyny i aplikacji, a aplikacje mogą używać wystąpień WebProxy klasy w celu dostosowania użycia serwera proxy sieci Web. Klasa WebProxy jest podstawową implementacją interfejsu IWebProxy .

Aby uzyskać wystąpienia klasy internetowego serwera proxy, można użyć dowolnej z następujących metod:

• Konstruktor WebProxy .

• Metoda GetDefaultProxy .

• Metoda Select .

Każda z tych metod dostarcza WebProxy wystąpienie, które można jeszcze bardziej dostosować. Różnica między nimi polega na tym, jak wystąpienie jest inicjowane przed zwróceniem go do aplikacji. Konstruktor WebProxy zwraca wystąpienie WebProxy klasy z właściwością ustawioną Address na null. Gdy żądanie używa WebProxy wystąpienia w tym stanie, do wysłania żądania nie jest używany żaden serwer proxy.

Metoda GetDefaultProxy zwraca wystąpienie WebProxy klasy z właściwościami Address, BypassProxyOnLocali BypassList ustawionymi na wartości używane przez program Internet Explorer 5.5 i nowsze.

Metoda Select zwraca wystąpienie WebProxy klasy z właściwościami ustawionymi zgodnie z kombinacją ustawień programu Internet Explorer i pliku konfiguracji.

Klasa WebProxy obsługuje automatyczne wykrywanie i wykonywanie skryptów konfiguracji serwera proxy. Ta funkcja jest również znana jako funkcja automatycznego odnajdywania serwera proxy sieci Web (WPAD). W przypadku korzystania z automatycznej konfiguracji serwera proxy skrypt konfiguracji, zazwyczaj o nazwie Wpad.dat, musi znajdować się, pobierać, kompilować i uruchamiać. Jeśli te operacje zostaną wykonane pomyślnie, skrypt zwróci serwery proxy, których można użyć dla żądania.

Konstruktory

WebProxy()	Inicjuje WebProxy puste wystąpienie klasy.
WebProxy(SerializationInfo, StreamingContext)	Inicjuje WebProxy wystąpienie klasy przy użyciu wcześniej serializowanej zawartości.
WebProxy(String)	Inicjuje WebProxy nowe wystąpienie klasy przy użyciu określonego identyfikatora URI.
WebProxy(String, Boolean)	Inicjuje WebProxy nowe wystąpienie klasy przy użyciu określonego identyfikatora URI i ustawienia obejścia.
WebProxy(String, Boolean, String[])	Inicjuje WebProxy nowe wystąpienie klasy z określonym identyfikatorem URI, ustawieniem obejścia i listą identyfikatorów URI do obejścia.
WebProxy(String, Boolean, String[], ICredentials)	Inicjuje WebProxy nowe wystąpienie klasy z określonym identyfikatorem URI, ustawieniem obejścia, listą identyfikatorów URI do obejścia i poświadczeniami.
WebProxy(String, Int32)	Inicjuje WebProxy nowe wystąpienie klasy z określonym hostem i numerem portu.
WebProxy(Uri)	Inicjuje WebProxy nowe wystąpienie klasy z określonego Uri wystąpienia.
WebProxy(Uri, Boolean)	Inicjuje WebProxy nowe wystąpienie klasy z ustawieniem Uri wystąpienia i obejścia.
WebProxy(Uri, Boolean, String[])	Inicjuje nowe wystąpienie klasy z określonym Uri wystąpieniemWebProxy, ustawienie obejścia i listę identyfikatorów URI do obejścia.
WebProxy(Uri, Boolean, String[], ICredentials)	Inicjuje WebProxy nowe wystąpienie klasy przy użyciu określonego Uri wystąpienia, ustawienia obejścia, listy identyfikatorów URI do obejścia i poświadczeń.

Właściwości

Address	Pobiera lub ustawia adres serwera proxy.
BypassArrayList	Pobiera listę adresów, które nie używają serwera proxy.
BypassList	Pobiera lub ustawia tablicę adresów, które nie używają serwera proxy.
BypassProxyOnLocal	Pobiera lub ustawia wartość wskazującą, czy pominąć serwer proxy dla adresów lokalnych.
Credentials	Pobiera lub ustawia poświadczenia do przesyłania do serwera proxy na potrzeby uwierzytelniania.
UseDefaultCredentials	Pobiera lub ustawia wartość, która określa Boolean , czy DefaultCredentials są wysyłane z żądaniami.

Metody

CreateDefaultProxy()
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetDefaultProxy()	Nieaktualne. Nieaktualne. Nieaktualne. Odczytuje ustawienia serwera proxy niedynamicznego programu Internet Explorer.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetObjectData(SerializationInfo, StreamingContext)	Wypełnia obiekt SerializationInfo docelowy danymi, które są potrzebne do serializacji obiektu docelowego.
GetProxy(Uri)	Zwraca identyfikator URI proxied dla żądania.
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IsBypassed(Uri)	Wskazuje, czy należy użyć serwera proxy dla określonego hosta.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Jawne implementacje interfejsu

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Tworzy dane serializacji i kontekst używany przez system do serializacji WebProxy obiektu.