La classe WebProxy contiene le impostazioni proxy utilizzate dalle istanze di WebRequest per determinare se per l'invio delle richieste è utilizzato un proxy Web. Le impostazioni globali del proxy Web possono essere specificate nei file di configurazione del computer e dell'applicazione e le applicazioni possono utilizzare le istanze della classe WebProxy per personalizzare l'utilizzo del proxy Web. La classe WebProxy rappresenta l'implementazione di base dell'interfaccia IWebProxy.

Per ottenere istanze della classe del proxy Web, è possibile utilizzare uno qualsiasi dei metodi indicati di seguito:

• Costruttore WebProxy.

• Metodo GetDefaultProxy.

• Metodo Select.

Ciascuno di questi metodi fornisce un'istanza di WebProxy che può essere ulteriormente personalizzata; la differenza tra le istanze sta nel modo in cui vengono inizializzate prima di essere restituite all'applicazione. Il costruttore WebProxy restituisce un'istanza della classe WebProxy con la proprietà Address impostata su nullNothingnullptrriferimento null (Nothing in Visual Basic). Quando per una richiesta si utilizza un'istanza di WebProxy in questo stato, per l'invio della richiesta non viene utilizzato alcun proxy.

Il metodo GetDefaultProxy restituisce un'istanza della classe WebProxy con le proprietà Address, BypassProxyOnLocal e BypassList impostate sui valori utilizzati da Internet Explorer 5.5 e versioni successive.

Il metodo Select restituisce un'istanza della classeWebProxy con le proprietà impostate in base a una combinazione delle impostazioni di Internet Explorer e di quelle dei file di configurazione.

La classe WebProxy supporta il rilevamento e l'esecuzione automatici di script di configurazione proxy. Tale funzionalità è anche nota come WPAD (Web Proxy Auto-Discovery). Quando si utilizza la configurazione automatica del proxy, è necessario individuare uno script di configurazione, in genere denominato Wpad.dat, effettuarne il download, compilarlo ed eseguirlo. Se I'esito di queste operazioni è positivo, lo script restituisce i proxy che è possibile utilizzare per una richiesta.

Nell'esempio di codice riportato di seguito, viene assegnata un'istanza di WebProxy a un'istanza di WebRequest. L'istanza di WebRequest utilizzerà il proxy per connettersi a risorse Internet esterne. Per un esempio dell'utilizzo della funzionalità WPAD, vedere la documentazione relativa alla classe IWebProxyScript.

Dim proxyObject As New WebProxy("http://proxyserver:80/", True)
Dim req As WebRequest = 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;

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.set_Proxy(proxyObject);

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

.NET Compact Framework

Riferimenti