WebProxy Classe

Definizione

Contiene le impostazioni proxy HTTP per la classe WebRequest.Contains HTTP proxy settings for the WebRequest class.

public ref class WebProxy : System::Runtime::Serialization::ISerializable
[System.Serializable]
public class WebProxy : System.Runtime.Serialization.ISerializable
type WebProxy = class
    interface ISerializable
    interface IWebProxy
Public Class WebProxy
Implements ISerializable
Ereditarietà
WebProxy
Attributi
Implementazioni

Esempi

Nell'esempio di codice seguente viene assegnata un'istanza di WebProxy a un'istanza di WebRequest.The following code example assigns a WebProxy instance to a WebRequest instance. L'istanza WebRequest usa il proxy per connettersi a risorse Internet esterne.The WebRequest instance uses the proxy to connect to external Internet resources. Per un esempio in cui viene illustrato l'utilizzo della funzionalità WPAD, vedere la documentazione relativa alla classe IWebProxyScript.(For an example that demonstrates using the WPAD feature, see the documentation for the IWebProxyScript class.)

WebProxy^ proxyObject = gcnew WebProxy( "http://proxyserver:80/",true );
WebRequest^ req = WebRequest::Create( "http://www.contoso.com" );
req->Proxy = proxyObject;
WebProxy proxyObject = new WebProxy("http://proxyserver:80/",true);
WebRequest req = WebRequest.Create("http://www.contoso.com");
req.Proxy = proxyObject;

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)
Dim req As WebRequest = WebRequest.Create("http://www.contoso.com")
req.Proxy = proxyObject

Commenti

La classe WebProxy contiene le impostazioni proxy usate dalle istanze WebRequest per determinare se un proxy Web viene usato per inviare richieste.The WebProxy class contains the proxy settings that WebRequest instances use to determine whether a Web proxy is used to send requests. È possibile specificare le impostazioni proxy Web globali nei file di configurazione del computer e dell'applicazione e le applicazioni possono usare le istanze della classe WebProxy per personalizzare l'uso del proxy Web.Global Web proxy settings can be specified in machine and application configuration files, and applications can use instances of the WebProxy class to customize Web proxy use. La classe WebProxy è l'implementazione di base dell'interfaccia IWebProxy.The WebProxy class is the base implementation of the IWebProxy interface.

Per ottenere istanze della classe proxy Web, è possibile usare uno dei metodi seguenti:To obtain instances of the Web proxy class, you can use any of the following methods:

Ognuno di questi metodi fornisce un'istanza di WebProxy che è possibile personalizzare ulteriormente. la differenza tra di essi è il modo in cui l'istanza viene inizializzata prima che venga restituita all'applicazione.These methods each supply a WebProxy instance that you can further customize; the difference between them is how the instance is initialized before it is returned to your application. Il costruttore WebProxy restituisce un'istanza della classe WebProxy con la proprietà Address impostata su null.The WebProxy constructor returns an instance of the WebProxy class with the Address property set to null. Quando una richiesta usa un'istanza di WebProxy in questo stato, non viene usato alcun proxy per inviare la richiesta.When a request uses a WebProxy instance in this state, no proxy is used to send the request.

Il metodo GetDefaultProxy restituisce un'istanza della classe WebProxy con le proprietà Address, BypassProxyOnLocale BypassList impostate sui valori utilizzati da Internet Explorer 5,5 e versioni successive.The GetDefaultProxy method returns an instance of the WebProxy class with the Address, BypassProxyOnLocal, and BypassList properties set to the values used by Internet Explorer 5.5 and later.

Il metodo Select restituisce un'istanza della classe WebProxy con le proprietà it impostate in base a una combinazione di impostazioni del file di configurazione e di Internet Explorer.The Select method returns an instance of the WebProxy class with it properties set according to a combination of Internet Explorer and configuration file settings.

La classe WebProxy supporta il rilevamento automatico e l'esecuzione di script di configurazione del proxy.The WebProxy class supports automatic detection and execution of proxy configuration scripts. Questa funzionalità è nota anche come Rilevamento automatico proxy Web (WPAD).This feature is also known as Web Proxy Auto-Discovery (WPAD). Quando si usa la configurazione automatica del proxy, è necessario trovare, scaricare, compilare ed eseguire uno script di configurazione, in genere denominato wpad. dat.When using automatic proxy configuration, a configuration script, typically named Wpad.dat, must be located, downloaded, compiled, and run. Se queste operazioni hanno esito positivo, lo script restituisce i proxy che possono essere usati per una richiesta.If these operations are successful, the script returns the proxies that can be used for a request.

Costruttori

WebProxy()

Inizializza un'istanza vuota della classe WebProxy.Initializes an empty instance of the WebProxy class.

WebProxy(SerializationInfo, StreamingContext)

Inizializza un'istanza della classe WebProxy tramite il contenuto serializzato in precedenza.Initializes an instance of the WebProxy class using previously serialized content.

WebProxy(String)

Inizializza una nuova istanza della classe WebProxy con l'URI specificato.Initializes a new instance of the WebProxy class with the specified URI.

WebProxy(String, Boolean)

Inizializza una nuova istanza della classe WebProxy con l'URI e l'impostazione di bypass specificati.Initializes a new instance of the WebProxy class with the specified URI and bypass setting.

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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, and list of URIs to bypass.

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.Initializes a new instance of the WebProxy class with the specified URI, bypass setting, list of URIs to bypass, and credentials.

WebProxy(String, Int32)

Inizializza una nuova istanza della classe WebProxy con il numero di porta e l'host specificati.Initializes a new instance of the WebProxy class with the specified host and port number.

WebProxy(Uri)

Inizializza una nuova istanza della classe WebProxy dall'istanza Uri specificata.Initializes a new instance of the WebProxy class from the specified Uri instance.

WebProxy(Uri, Boolean)

Inizializza una nuova istanza della classe WebProxy con l'istanza di Uri e l'impostazione di bypass.Initializes a new instance of the WebProxy class with the Uri instance and bypass setting.

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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, and list of URIs to bypass.

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.Initializes a new instance of the WebProxy class with the specified Uri instance, bypass setting, list of URIs to bypass, and credentials.

Proprietà

Address

Recupera o imposta l'indirizzo del server proxy.Gets or sets the address of the proxy server.

BypassArrayList

Recupera un elenco di indirizzi che non utilizzano il server proxy.Gets a list of addresses that do not use the proxy server.

BypassList

Recupera o imposta una matrice di indirizzi che non utilizzano il server proxy.Gets or sets an array of addresses that do not use the proxy server.

BypassProxyOnLocal

Ottiene o imposta un valore che indica se ignorare il server proxy per gli indirizzi locali.Gets or sets a value that indicates whether to bypass the proxy server for local addresses.

Credentials

Ottiene o imposta le credenziali da inviare al server proxy per l'autenticazione.Gets or sets the credentials to submit to the proxy server for authentication.

UseDefaultCredentials

Ottiene o imposta un valore Boolean che controlla se insieme alle richieste viene inviata la proprietà DefaultCredentials.Gets or sets a Boolean value that controls whether the DefaultCredentials are sent with requests.

Metodi

CreateDefaultProxy()
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
GetDefaultProxy()

Legge le impostazioni proxy non dinamiche di Internet Explorer.Reads the Internet Explorer nondynamic proxy settings.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetObjectData(SerializationInfo, StreamingContext)

Popola un oggetto SerializationInfo con i dati necessari per serializzare l'oggetto di destinazione.Populates a SerializationInfo with the data that is needed to serialize the target object.

GetProxy(Uri)

Restituisce l'URI con proxy per una richiesta.Returns the proxied URI for a request.

GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsBypassed(Uri)

Indica se utilizzare il server proxy per l'host specificato.Indicates whether to use the proxy server for the specified host.

MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(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.Creates the serialization data and context that are used by the system to serialize a WebProxy object.

Si applica a