WebProxy Classe

Definizione

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

Public Class WebProxy
Implements ISerializable, IWebProxy

Public Class WebProxy
Implements ISerializable

Ereditarietà

Object

WebProxy

Attributi

SerializableAttribute

Implementazioni

IWebProxy ISerializable

Esempio

Nell'esempio di codice seguente viene impostata un'istanza HttpClient di con un'istanza WebProxy di . L'istanza HttpClient usa il proxy per connettersi a risorse Internet esterne. Per un esempio che illustra l'uso della funzionalità WPAD, vedere la documentazione per la IWebProxyScript classe .

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

Commenti

La WebProxy classe contiene le impostazioni proxy usate HttpClient dalle istanze per determinare se un proxy Web viene usato per inviare richieste. Le impostazioni proxy Web globali possono essere specificate nei file di configurazione del computer e dell'applicazione e le applicazioni possono usare istanze della WebProxy classe per personalizzare l'uso del proxy Web. La WebProxy classe è l'implementazione di base dell'interfaccia IWebProxy .

Per ottenere istanze della classe proxy Web, è possibile usare uno dei metodi seguenti:

• WebProxy Costruttore.
• Metodo GetDefaultProxy.
• Metodo Select.

Questi metodi forniscono ogni WebProxy istanza di che è possibile personalizzare ulteriormente. La differenza tra di esse è la modalità di inizializzazione dell'istanza prima che venga restituita all'applicazione. Il WebProxy costruttore restituisce un'istanza della WebProxy classe con la Address proprietà impostata su null. Quando una richiesta usa un'istanza WebProxy in questo stato, non viene usato alcun proxy per inviare la richiesta.

Il GetDefaultProxy metodo restituisce un'istanza della WebProxy classe con le Addressproprietà , BypassProxyOnLocale BypassList impostate sui valori utilizzati dal computer locale.

Il Select metodo restituisce un'istanza della WebProxy classe con le relative proprietà impostate in base a una combinazione di impostazioni del file di configurazione e Internet.

La WebProxy classe supporta il rilevamento automatico e l'esecuzione degli script di configurazione del proxy. Questa funzionalità è nota anche come Individuazione automatica proxy Web (WPAD). Quando si usa la configurazione proxy automatica, uno script di configurazione, denominato in genere Wpad.dat, deve trovarsi, scaricare, compilare ed eseguire. Se queste operazioni hanno esito positivo, lo script restituisce i proxy che possono essere usati per una richiesta.