WebProxy Klasa

Definicja

Przestrzeń nazw:

System.Net

Zestaw:

System.Net.WebProxy.dll

Źródło:

WebProxy.cs

Zawiera ustawienia serwera proxy HTTP dla HttpClient klasy.

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

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

type WebProxy = class
    interface IWebProxy
    interface ISerializable

Public Class WebProxy
Implements ISerializable, IWebProxy

Dziedziczenie

Object

WebProxy

Implementuje

IWebProxy ISerializable

Przykłady

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

WebProxy^ proxyObject = gcnew WebProxy("http://proxyserver:80/", true);

// HttpClient lifecycle management best practices:
// https://learn.microsoft.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://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
})

Uwagi

Klasa WebProxy zawiera ustawienia serwera proxy używane przez wystąpienia w celu określenia, HttpClient 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 serwera proxy sieci Web, można użyć dowolnej z następujących metod:

• Konstruktor WebProxy .

• Metoda GetDefaultProxy .

• Metoda Select .

Te metody zapewniają 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 wysył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 komputer lokalny.

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

Klasa WebProxy obsługuje automatyczne wykrywanie i wykonywanie skryptów konfiguracji serwera proxy. Ta funkcja jest również nazywana automatycznym odnajdywaniem 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 zakończyły się pomyślnie, skrypt zwraca serwery proxy, których można użyć dla żądania.

Konstruktory

WebProxy()	Inicjuje puste wystąpienie WebProxy klasy.
WebProxy(SerializationInfo, StreamingContext)	Przestarzałe. Inicjuje wystąpienie klasy przy użyciu wcześniej serializowanej WebProxy 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 nowe wystąpienie WebProxy 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 WebProxy nowe wystąpienie klasy przy użyciu określonego Uri wystąpienia, ustawienia obejścia i listy identyfikatorów URI do obejścia.
WebProxy(Uri, Boolean, String[], ICredentials)	Inicjuje nowe wystąpienie klasy przy użyciu określonego Uri wystąpieniaWebProxy, ustawienie obejścia, listę 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 korzystają z 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

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetDefaultProxy()	Przestarzałe. Odczytuje ustawienia niedynamicznego serwera proxy opcji internetowych.
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 bieżące wystąpienie. (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.