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 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 dal computer locale.
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.
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.
Obsoleti.
Obsoleti.
Legge le opzioni Internet non dinamiche delle impostazioni proxy. |
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. |
Si applica a
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per