Export (0) Print
Expand All

WebPermission.AddPermission Method (NetworkAccess, Regex)

Adds the specified URI with the specified access rights to the current WebPermission.

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

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

Parameters

access

A NetworkAccess that specifies the access rights that are granted to the URI.

uriRegex

A regular expression that describes the set of URIs to which access rights are granted.

Exception typeCondition

ArgumentNullException

The uriRegex parameter is a null reference (Nothing in Visual Basic).

If you have specified None as the PermissionState, use AddPermission to allow the use of uriRegex in the target class. Specify Accept as the access parameter to add the URI specified by the uriRegex parameter to the list of URI accept strings, or specify Connect as the access parameter to add the URI to the list of URI connect strings.

NoteNote:

Calling AddPermission on an UnrestrictedWebPermission instance will have no effect as permission is granted to all URIs.

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 uses AddPermission to give access rights for the specified URI.

// Create a WebPermission.
WebPermission myWebPermission1 = new WebPermission();

// Allow Connect access to the specified URLs.
myWebPermission1.AddPermission(NetworkAccess.Connect,new Regex("http://www\\.contoso\\.com/.*", 
  RegexOptions.Compiled | RegexOptions.IgnoreCase | RegexOptions.Singleline));
 
myWebPermission1.Demand();


// Create a WebPermission.
WebPermission myWebPermission1 = new WebPermission();
// Allow Connect access to the specified URLs.
myWebPermission1.AddPermission(NetworkAccess.Connect,
    new Regex("http://www\\.contoso\\.com/.*", RegexOptions.Compiled 
    | RegexOptions.IgnoreCase | RegexOptions.Singleline));

myWebPermission1.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

Community Additions

ADD
Show:
© 2014 Microsoft