WebProxy Classe

Definizione

Spazio dei nomi:

System.Net

Assembly:

System.Net.WebProxy.dll

Origine:

WebProxy.cs

Contiene le impostazioni proxy HTTP per la classe HttpClient.

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

Ereditarietà

Object

WebProxy

Implementazioni

IWebProxy ISerializable

Esempio

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

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

Commenti

La WebProxy classe contiene le impostazioni proxy usate HttpClient dalle istanze per determinare se viene usato un proxy Web 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 classe per personalizzare l'uso del WebProxy 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 un'istanza WebProxy 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 WebProxy della 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 WebProxy della classe con le Addressproprietà , BypassProxyOnLocale BypassList impostate sui valori usati da Internet Explorer 5.5 e versioni successive.

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

La WebProxy classe supporta il rilevamento automatico e l'esecuzione degli script di configurazione proxy. Questa funzionalità è nota anche come Rilevamento automatico proxy Web (WPAD). Quando si usa la configurazione automatica del proxy, uno script di configurazione, in genere denominato 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.

Costruttori

WebProxy()	Inizializza un'istanza vuota della classe WebProxy.
WebProxy(SerializationInfo, StreamingContext)	Obsoleti. Inizializza un'istanza della classe WebProxy tramite il contenuto serializzato in precedenza.
WebProxy(String)	Inizializza una nuova istanza della classe WebProxy con l'URI specificato.
WebProxy(String, Boolean)	Inizializza una nuova istanza della classe WebProxy con l'URI e l'impostazione di bypass specificati.
WebProxy(String, Boolean, String[])	Inizializza una nuova istanza della classe WebProxy con l'URI, l'impostazione di bypass e un elenco di URI di cui eseguire il bypass specificati.
WebProxy(String, Boolean, String[], ICredentials)	Inizializza una nuova istanza della classe WebProxy con l'URI specificato, l'impostazione di bypass, l'elenco di URI di cui eseguire il bypass e le credenziali.
WebProxy(String, Int32)	Inizializza una nuova istanza della classe WebProxy con il numero di porta e l'host specificati.
WebProxy(Uri)	Inizializza una nuova istanza della classe WebProxy dall'istanza Uri specificata.
WebProxy(Uri, Boolean)	Inizializza una nuova istanza della classe WebProxy con l'istanza di Uri e l'impostazione di bypass.
WebProxy(Uri, Boolean, String[])	Inizializza una nuova istanza della classe WebProxy con l'istanza di Uri, l'impostazione di bypass e un elenco di URI di cui eseguire il bypass specificati.
WebProxy(Uri, Boolean, String[], ICredentials)	Inizializza una nuova istanza della classe WebProxy con l'istanza di Uri, l'impostazione di bypass, l'elenco di URI di cui eseguire il bypass specificati e le credenziali.

Proprietà

Address	Recupera o imposta l'indirizzo del server proxy.
BypassArrayList	Recupera un elenco di indirizzi che non utilizzano il server proxy.
BypassList	Recupera o imposta una matrice di indirizzi che non utilizzano il server proxy.
BypassProxyOnLocal	Ottiene o imposta un valore che indica se ignorare il server proxy per indirizzi locali.
Credentials	Ottiene o imposta le credenziali da inviare al server proxy per l'autenticazione.
UseDefaultCredentials	Ottiene o imposta un valore Boolean che controlla se insieme alle richieste viene inviata la proprietà DefaultCredentials.

Metodi

Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetDefaultProxy()	Obsoleti. Legge le impostazioni proxy non dinamiche di Internet Explorer.
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)	Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.
GetProxy(Uri)	Restituisce l'URI con proxy per una richiesta.
GetType()	Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
IsBypassed(Uri)	Indica se utilizzare il server proxy per l'host specificato.
MemberwiseClone()	Crea una copia superficiale dell'oggetto Object corrente. (Ereditato da Object)
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Crea i dati e il contesto di serializzazione utilizzati dal sistema per serializzare un oggetto WebProxy.