WebProxy WebProxy WebProxy WebProxy Class

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à
WebProxyWebProxyWebProxyWebProxy
Attributi
Implementazioni

Esempi

Nell'esempio di codice seguente viene assegnata un' WebProxy istanza di a un' WebRequest istanza di.The following code example assigns a WebProxy instance to a WebRequest instance. L' WebRequest istanza 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 IWebProxyScript relativa alla classe.(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 WebProxy classe contiene le WebRequest impostazioni proxy usate dalle istanze 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 WebProxy usare le istanze della classe 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 WebProxy classe è l'implementazione IWebProxy di base dell'interfaccia.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 WebProxy un'istanza 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 WebProxy costruttore restituisce un'istanza WebProxy della classe con la Address proprietà 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' WebProxy istanza 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 GetDefaultProxy metodo restituisce un'istanza WebProxy della classe con le Addressproprietà, 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 Select metodo restituisce un'istanza WebProxy della classe 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 WebProxy classe 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() WebProxy() WebProxy() WebProxy()

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

WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext) WebProxy(SerializationInfo, StreamingContext) 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) WebProxy(String) WebProxy(String) 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) WebProxy(String, Boolean) WebProxy(String, Boolean) 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[]) WebProxy(String, Boolean, String[]) WebProxy(String, Boolean, String[]) 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) WebProxy(String, Boolean, String[], ICredentials) WebProxy(String, Boolean, String[], ICredentials) 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) WebProxy(String, Int32) WebProxy(String, Int32) 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) WebProxy(Uri) WebProxy(Uri) WebProxy(Uri)

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

WebProxy(Uri, Boolean) WebProxy(Uri, Boolean) WebProxy(Uri, Boolean) 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[]) WebProxy(Uri, Boolean, String[]) WebProxy(Uri, Boolean, String[]) 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) WebProxy(Uri, Boolean, String[], ICredentials) WebProxy(Uri, Boolean, String[], ICredentials) 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 Address Address Address

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

BypassArrayList BypassArrayList BypassArrayList 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 BypassList BypassList 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 BypassProxyOnLocal BypassProxyOnLocal 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 Credentials Credentials 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 UseDefaultCredentials UseDefaultCredentials 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() CreateDefaultProxy() CreateDefaultProxy() CreateDefaultProxy()
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

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

(Inherited from Object)
GetDefaultProxy() GetDefaultProxy() GetDefaultProxy() GetDefaultProxy()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Compila 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) GetProxy(Uri) GetProxy(Uri) GetProxy(Uri)

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

GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IsBypassed(Uri) IsBypassed(Uri) IsBypassed(Uri) IsBypassed(Uri)

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

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
ToString() ToString() ToString() ToString()

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

(Inherited from Object)

Implementazioni dell'interfaccia esplicita

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) 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