GlobalProxySelection.GetEmptyWebProxy Method


Returns an empty proxy instance.

 static System::Net::IWebProxy ^ GetEmptyWebProxy();
public static System.Net.IWebProxy GetEmptyWebProxy ();
static member GetEmptyWebProxy : unit -> System.Net.IWebProxy
Public Shared Function GetEmptyWebProxy () As IWebProxy


An IWebProxy that contains no information.


The following code example creates a WebRequest instance that does not use a proxy.

#using <System.dll>

using namespace System;
using namespace System::Net;
using namespace System::IO;
int main()
   // Create a request for the Web page at
   WebRequest^ request = WebRequest::Create( L"" );
   // This application doesn't want they proxy to be used so it sets
   // the global proxy to an empy proxy.
   IWebProxy^ myProxy = GlobalProxySelection::GetEmptyWebProxy();
   // Get the response.
   WebResponse^ response = request->GetResponse();
   // Display the response to the console.
   Stream^ stream = response->GetResponseStream();
   StreamReader^ reader = gcnew StreamReader( stream );
   Console::WriteLine( reader->ReadToEnd() );
   // Clean up.
   return 0;
using System;
using System.Net;
using System.IO;
namespace Examples.Http
    public class TestGlobalProxySelection
        public static void Main()
            // Create a request for the Web page at
            WebRequest request = WebRequest.Create("");
            // This application doesn't want the proxy to be used so it sets 
            // the global proxy to an empty proxy.
            IWebProxy myProxy = GlobalProxySelection.GetEmptyWebProxy();
            GlobalProxySelection.Select = myProxy;
            // Get the response.
            WebResponse response = request.GetResponse();
            // Display the response to the console.
            Stream stream = response.GetResponseStream();
            StreamReader reader = new StreamReader(stream);
            // Clean up.


The GetEmptyWebProxy method returns a blank IWebProxy instance to indicate that no proxy is used to access an Internet resource.

Instead of calling the GetEmptyWebProxy method, you can assign null to members such as the WebClient.Proxy property, which specifies the proxy that communicates with remote servers on behalf of the WebClient object.

Applies to