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 łą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);

// 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 HttpClient 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 komputer lokalny.

Metoda Select zwraca wystąpienie WebProxy klasy z właściwościami ustawionymi zgodnie z kombinacją ustawień Internetu 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)	Przestarzałe. 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 WebProxy klasy z określonym Uri wystąpieniem, 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 przesłania do serwera proxy na potrzeby uwierzytelniania.
UseDefaultCredentials	Pobiera lub ustawia Boolean wartość, która kontroluje, czy DefaultCredentials obiekt jest wysyłany 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 element SerializationInfo danymi potrzebnymi 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 używać 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, które są używane przez system do serializacji WebProxy obiektu.