This documentation is archived and is not being maintained.

WebProxy::GetDefaultProxy Method

Note: This API is now obsolete.

Reads the Internet Explorer nondynamic proxy settings.

Namespace:  System.Net
Assembly:  System (in System.dll)

[ObsoleteAttribute(L"This method has been deprecated. Please use the proxy selected for you by default.")]
static WebProxy^ GetDefaultProxy()

Return Value

Type: System.Net::WebProxy
A WebProxy instance that contains the nondynamic proxy settings from Internet Explorer 5.5 and later.

The GetDefaultProxy method reads the nondynamic proxy settings stored by Internet Explorer 5.5 and later, and creates a WebProxy instance with those settings.

The GetDefaultProxy method does not pick up any dynamic settings that are generated from scripts run by Internet Explorer, from automatic configuration entries, or from DHCP or DNS lookups.

Applications should use the WebRequest::DefaultWebProxy property and the WebRequest::GetSystemWebProxy method instead of the GetDefaultProxy method.

The following code example demonstrates calling this method.

void CheckDefaultProxyForRequest( Uri^ resource )
   WebProxy^ proxy = (WebProxy^)( WebProxy::GetDefaultProxy() );

   // See what proxy is used for resource.
   Uri^ resourceProxy = proxy->GetProxy( resource );

   // Test to see whether a proxy was selected.
   if ( resourceProxy == resource )
      Console::WriteLine( "No proxy for {0}", resource );
      Console::WriteLine( "Proxy for {0} is {1}", resource, 
         resourceProxy );

.NET Framework

Supported in: 1.1, 1.0
Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5
Obsolete (compiler warning) in 3.5 SP1
Obsolete (compiler warning) in 3.0
Obsolete (compiler warning) in 3.0 SP1
Obsolete (compiler warning) in 3.0 SP2
Obsolete (compiler warning) in 2.0
Obsolete (compiler warning) in 2.0 SP1
Obsolete (compiler warning) in 2.0 SP2

.NET Framework Client Profile

Obsolete (compiler warning) in 4
Obsolete (compiler warning) in 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.