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 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 = 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 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 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 di script di configurazione proxy. Questa funzionalità è nota anche come Rilevamento automatico proxy Web (WPAD). Quando si usa la configurazione proxy automatica, 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 delle opzioni Internet.
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.