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
)

Parameters

access
Type: System.Net::NetworkAccess

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

uriRegex
Type: System.Text.RegularExpressions::Regex

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

ExceptionCondition
ArgumentNullException

The uriRegex parameter is nullptr.

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 Unrestricted WebPermission 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 = gcnew WebPermission;

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

myWebPermission1->Demand();

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Show:
© 2014 Microsoft