This documentation is archived and is not being maintained.

WebProxy Constructor (String, Boolean, String[], ICredentials)

Initializes a new instance of the WebProxy class with the specified URI, bypass setting, list of URIs to bypass, and credentials.

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

public:
WebProxy (
	String^ Address, 
	bool BypassOnLocal, 
	array<String^>^ BypassList, 
	ICredentials^ Credentials
)
public WebProxy (
	String Address, 
	boolean BypassOnLocal, 
	String[] BypassList, 
	ICredentials Credentials
)
public function WebProxy (
	Address : String, 
	BypassOnLocal : boolean, 
	BypassList : String[], 
	Credentials : ICredentials
)

Parameters

Address

The URI of the proxy server.

BypassOnLocal

true to bypass the proxy for local addresses; otherwise, false.

BypassList

An array of regular expression strings that contains the URIs of the servers to bypass.

Credentials

An ICredentials instance to submit to the proxy server for authentication.

Exception typeCondition

UriFormatException

Address is an invalid URI.

The WebProxy instance is initialized with the Address property set to a Uri instance that contains Address, the BypassProxyOnLocal property set to BypassOnLocal, the BypassList property set to BypassList, and the Credentials property set to Credentials.

The following code example demonstrates calling this constructor.

WebProxy^ CreateProxyWithCredentials( bool bypassLocal )
{
   // Do not use the proxy server for Contoso.com URIs.
   array<String^>^ bypassList = {";*.Contoso.com"};
   return gcnew WebProxy( "http://contoso",
      bypassLocal,
      bypassList,
      CredentialCache::DefaultCredentials );
}

public static WebProxy CreateProxyWithCredentials(boolean bypassLocal)
{
    // Do not use the proxy server for Contoso.com URIs.
    String bypassList[] = new String[] { ";*.Contoso.com" };
    return new WebProxy("http://contoso", bypassLocal, bypassList, 
        CredentialCache.get_DefaultCredentials());
} //CreateProxyWithCredentials

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0, 1.1, 1.0
Show: