WebProxy Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Contiene le impostazioni proxy HTTP per la classe HttpClient.
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à
-
WebProxy
- Attributi
- Implementazioni
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://video2.skills-academy.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://video2.skills-academy.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://video2.skills-academy.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.
Obsoleti.
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. |