WebProxy Osztály

Definíció

Névtér:

System.Net

Szerelvény:

System.dll

HTTP-proxybeállításokat tartalmaz az HttpClient osztályhoz.

public ref class WebProxy : System::Runtime::Serialization::ISerializable

[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable

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

Public Class WebProxy
Implements ISerializable

Öröklődés

Object

WebProxy

Attribútumok

SerializableAttribute

Megvalósítás

IWebProxy ISerializable

Példák

Az alábbi példakód egy példányt HttpClient állít be egy példányhoz WebProxy . A HttpClient példány a proxy használatával csatlakozik külső internetes erőforrásokhoz. (A WPAD-funkció használatát bemutató példáért tekintse meg az osztály dokumentációját IWebProxyScript .)

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

Megjegyzések

Az WebProxy osztály tartalmazza a példányok által a kérelmek küldéséhez használt proxybeállításokat HttpClient . A globális webproxy-beállítások megadhatók a gép- és alkalmazáskonfigurációs fájlokban, és az alkalmazások az osztály példányait használhatják a WebProxy webproxy használatának testreszabásához. Az WebProxy osztály az interfész alap implementációja IWebProxy .

A webes proxyosztály példányainak lekéréséhez az alábbi módszerek bármelyikét használhatja:

• A WebProxy konstruktor.
• A GetDefaultProxy módszer.
• A Select módszer.

Ezek a metódusok mindegyike egy olyan példányt WebProxy ad meg, amelyet tovább testre szabhat; a különbség köztük az, hogy a példány inicializálása hogyan történik, mielőtt visszakerül az alkalmazáshoz. A WebProxy konstruktor az WebProxy osztály egy példányát adja vissza, amelynek tulajdonsága a Address következő.null Ha egy kérés ebben az állapotban egy példányt WebProxy használ, a rendszer nem használ proxyt a kérés elküldéséhez.

A GetDefaultProxy metódus az WebProxy osztály egy példányát adja vissza a Addresshelyi számítógép által használt értékekre beállított , BypassProxyOnLocalés BypassList tulajdonságokkal.

A Select metódus az osztály egy példányát adja vissza, amelynek tulajdonságai az WebProxy internet- és konfigurációs fájlbeállítások kombinációjának megfelelően vannak beállítva.

Az WebProxy osztály támogatja a proxykonfigurációs szkriptek automatikus észlelését és végrehajtását. Ezt a funkciót webproxy automatikus felderítésnek (WPAD) is nevezik. Az automatikus proxykonfiguráció használatakor egy általában Wpad.dat nevű konfigurációs szkriptet kell elhelyezni, letölteni, lefordítani és futtatni. Ha ezek a műveletek sikeresek, a szkript visszaadja a kérelmekhez használható proxykat.

Konstruktorok

Name	Description
WebProxy()	Inicializálja az osztály egy üres példányát WebProxy .
WebProxy(SerializationInfo, StreamingContext)	Inicializálja az osztály egy példányát korábban WebProxy szerializált tartalommal.
WebProxy(String, Boolean, String[], ICredentials)	Inicializálja az osztály új példányát a WebProxy megadott URI-val, megkerülési beállítással, megkerülendő URI-k listájával és hitelesítő adataival.
WebProxy(String, Boolean, String[])	Inicializálja az osztály új példányát a WebProxy megadott URI-val, megkerülési beállítással és megkerülendő URI-k listájával.
WebProxy(String, Boolean)	Inicializálja az osztály új példányát a WebProxy megadott URI-val és megkerülési beállítással.
WebProxy(String, Int32)	Inicializálja az osztály új példányát a WebProxy megadott gazdagéppel és portszámmal.
WebProxy(String)	Inicializálja az osztály új példányát a WebProxy megadott URI-val.
WebProxy(Uri, Boolean, String[], ICredentials)	Inicializálja az WebProxy osztály új példányát a megadott Uri példánnyal, a megkerülési beállítással, az megkerülendő URI-k listájával és a hitelesítő adatokkal.
WebProxy(Uri, Boolean, String[])	Inicializálja az WebProxy osztály új példányát a megadott Uri példánnyal, a megkerülési beállítással és az megkerülendő URI-k listájával.
WebProxy(Uri, Boolean)	Inicializálja az osztály új példányát a WebProxy példánysal, és megkerüli a Uri beállítást.
WebProxy(Uri)	Inicializálja az WebProxy osztály új példányát a megadott Uri példányból.

Tulajdonságok

Name	Description
Address	Lekéri vagy beállítja a proxykiszolgáló címét.
BypassArrayList	Lekéri a proxykiszolgálót nem használó címek listáját.
BypassList	Olyan címtömböt kap vagy állít be, amely nem használja a proxykiszolgálót.
BypassProxyOnLocal	Lekéri vagy beállít egy értéket, amely jelzi, hogy a helyi címek proxykiszolgálójának megkerülése szükséges-e.
Credentials	Lekéri vagy beállítja a hitelesítő adatokat, hogy hitelesítés céljából elküldje a proxykiszolgálónak.
UseDefaultCredentials	Lekéri vagy beállítja Boolean azt az értéket, amely meghatározza, hogy a rendszer kérésekkel küldi-e el azokat DefaultCredentials .

Metódusok

Name	Description
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetDefaultProxy()	Elavult. Beolvassa az internetbeállítások nemdinamikus proxybeállításait.
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetObjectData(SerializationInfo, StreamingContext)	Feltölti SerializationInfo a célobjektum szerializálásához szükséges adatokat.
GetProxy(Uri)	A kérelemhez megadott URI-t adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
IsBypassed(Uri)	Azt jelzi, hogy a proxykiszolgálót használja-e a megadott gazdagéphez.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Explicit interfész-implementációk

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	Létrehozza az objektum szerializálásához WebProxy a rendszer által használt szerializálási adatokat és környezetet.