Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WebPermission.WebPermission(NetworkAccess, Regex) Constructor

Initializes a new instance of the WebPermission class with the specified access rights for the specified URI regular expression.

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

public WebPermission (
	NetworkAccess access,
	Regex uriRegex
)
public WebPermission (
	NetworkAccess access, 
	Regex uriRegex
)
public function WebPermission (
	access : NetworkAccess, 
	uriRegex : Regex
)
Not applicable.

Parameters

access

A NetworkAccess value that indicates what kind of access to grant to the specified URI. Accept indicates that the application is allowed to accept connections from the Internet on a local resource. Connect indicates that the application is allowed to connect to specific Internet resources.

uriRegex

A regular expression that describes the URI to which access is to be granted.

This constructor initializes a WebPermission and grants its target permission to either make a remote host connection or accept a remote host connection using the URI described by the uriRegex parameter.

NoteNote:

It is recommended that you create uriRegex using the RegexOptions.IgnoreCase, RegexOptions.Compiled, and RegexOptions.Singleline flags.

NoteNote:

A candidate URI string is checked against the list of relevant regular expressions (AcceptList or ConnectList) in two ways. First, the candidate URI string is checked against the appropriate list; then, if there is no match, the candidate URI string is converted into a Uri and checked against the appropriate list.

The following example creates a new instance of WebPermission with connect rights for the specified System.Text.RegularExpressions.Regex.


 // Create an instance of 'Regex' that accepts all  URL's containing the host 
 // fragment 'www.contoso.com'.
 Regex myRegex = new Regex(@"http://www\.contoso\.com/.*");

// Create a WebPermission that gives the permissions to all the hosts containing 
// the same fragment.
WebPermission myWebPermission = new WebPermission(NetworkAccess.Connect,myRegex);
   
// Checks all callers higher in the call stack have been granted the permission.
myWebPermission.Demand();
 

// Create an instance of 'Regex' that accepts all  URL's containing 
// the host fragment 'www.contoso.com'.
Regex myRegex = new Regex("http://www\\.contoso\\.com/.*");
// Create a WebPermission that gives the permissions to all the hosts 
// containing the same fragment.
WebPermission myWebPermission = new WebPermission(NetworkAccess.
    Connect, myRegex);
// Checks all callers higher in the call stack have been granted the 
// permission.
myWebPermission.Demand();

Windows 98, Windows Server 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 Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft