WebProxy Třída

Definice

Obor názvů:

System.Net

Sestavení:

netstandard.dll, System.Net.WebProxy.dll

Zdroj:

WebProxy.cs

Obsahuje nastavení proxy serveru HTTP pro HttpClient třídu.

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

Dědičnost

Object

WebProxy

Implementuje

IWebProxy ISerializable

Příklady

Následující příklad kódu nastaví HttpClient instanci s WebProxy instancí. Instance HttpClient používá proxy server pro připojení k externím internetovým prostředkům. (Příklad, který ukazuje použití funkce WPAD, viz dokumentace pro IWebProxyScript třídu.)

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
})

Poznámky

Třída WebProxy obsahuje nastavení proxy serveru, které HttpClient instance používají k určení, zda je webový proxy server používán k odesílání požadavků. Globální nastavení webového proxy serveru lze zadat v konfiguračních souborech počítačů a aplikací a aplikace můžou k přizpůsobení použití webového WebProxy proxy serveru použít instance třídy. Třída WebProxy je základní implementací IWebProxy rozhraní.

K získání instancí třídy webového proxy serveru můžete použít některou z následujících metod:

• Konstruktor WebProxy .
• Metoda GetDefaultProxy.
• Metoda Select.

Tyto metody poskytují WebProxy instanci, kterou můžete dále přizpůsobit. Rozdíl mezi nimi je způsob inicializace instance před jejím vrácením do vaší aplikace. Konstruktor WebProxy vrátí instanci WebProxy třídy s vlastností nastavenou Address na null. Pokud požadavek používá WebProxy instanci v tomto stavu, k odeslání požadavku se nepoužívá žádný proxy server.

Metoda GetDefaultProxy vrátí instanci WebProxy třídy s Address, BypassProxyOnLocala BypassList vlastnosti nastavené na hodnoty používané místním počítačem.

Metoda Select vrátí instanci WebProxy třídy s vlastnostmi nastavenými podle kombinace nastavení internetového a konfiguračního souboru.

Třída WebProxy podporuje automatické zjišťování a spouštění konfiguračních skriptů proxy serveru. Tato funkce se také označuje jako automatické zjišťování webového proxy serveru (WPAD). Při použití automatické konfigurace proxy musí být konfigurační skript, obvykle pojmenovaný Wpad.dat, umístěn, stažen, kompilován a spuštěn. Pokud jsou tyto operace úspěšné, skript vrátí proxy servery, které je možné použít pro požadavek.

Konstruktory

Name	Description
WebProxy()	Inicializuje prázdnou WebProxy instanci třídy.
WebProxy(SerializationInfo, StreamingContext)	Zastaralé. Inicializuje instanci WebProxy třídy pomocí dříve serializovaného obsahu.
WebProxy(String, Boolean, String[], ICredentials)	Inicializuje novou instanci WebProxy třídy pomocí zadaného identifikátoru URI, nastavení obejití, seznamu identifikátorů URI pro obejití a přihlašovacích údajů.
WebProxy(String, Boolean, String[])	Inicializuje novou instanci WebProxy třídy se zadaným identifikátorem URI, nastavením obejití a seznamem identifikátorů URI, které se mají obejít.
WebProxy(String, Boolean)	Inicializuje novou instanci WebProxy třídy se zadaným identifikátorem URI a nastavením obejití.
WebProxy(String, Int32)	Inicializuje novou instanci WebProxy třídy se zadaným hostitelem a číslem portu.
WebProxy(String)	Inicializuje novou instanci WebProxy třídy pomocí zadaného identifikátoru URI.
WebProxy(Uri, Boolean, String[], ICredentials)	Inicializuje novou instanci třídy se zadanou Uri instancíWebProxy, nastavení obejití, seznam identifikátorů URI pro obejití a přihlašovací údaje.
WebProxy(Uri, Boolean, String[])	Inicializuje novou instanci třídy se zadanou Uri instancíWebProxy, vynechat nastavení a seznam identifikátorů URI, které se mají obejít.
WebProxy(Uri, Boolean)	Inicializuje novou instanci WebProxy třídy pomocí Uri instance a nastavení obejití.
WebProxy(Uri)	Inicializuje novou instanci WebProxy třídy ze zadané Uri instance.

Vlastnosti

Name	Description
Address	Získá nebo nastaví adresu proxy serveru.
BypassArrayList	Získá seznam adres, které nepoužívají proxy server.
BypassList	Získá nebo nastaví pole adres, které nepoužívají proxy server.
BypassProxyOnLocal	Získá nebo nastaví hodnotu, která určuje, zda se má obejít proxy server pro místní adresy.
Credentials	Získá nebo nastaví přihlašovací údaje pro odeslání na proxy server pro ověření.
UseDefaultCredentials	Získá nebo nastaví Boolean hodnotu, která určuje, zda DefaultCredentials jsou odeslány s požadavky.

Metody

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetDefaultProxy()	Zastaralé. Přečte nastavení nedynamického proxy serveru v možnostech internetu.
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetObjectData(SerializationInfo, StreamingContext)	Naplní SerializationInfo data, která jsou potřebná k serializaci cílového objektu.
GetProxy(Uri)	Vrátí identifikátor URI xied pro požadavek.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
IsBypassed(Uri)	Určuje, zda se má použít proxy server pro zadaného hostitele.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Vytvoří data serializace a kontext, které systém používá k serializaci objektu WebProxy .