Export (0) Print
Expand All

MethodBuilder::AddDeclarativeSecurity Method

Adds declarative security to this method.

Namespace:  System.Reflection.Emit
Assembly:  mscorlib (in mscorlib.dll)

public:
void AddDeclarativeSecurity(
	SecurityAction action, 
	PermissionSet^ pset
)

Parameters

action
Type: System.Security.Permissions::SecurityAction

The security action to be taken (Demand, Assert, and so on).

pset
Type: System.Security::PermissionSet

The set of permissions the action applies to.

ExceptionCondition
ArgumentOutOfRangeException

The action is invalid (RequestMinimum, RequestOptional, and RequestRefuse are invalid).

InvalidOperationException

The containing type has been created using CreateType.

-or-

The permission set pset contains an action that was added earlier by AddDeclarativeSecurity.

-or-

For the current method, the IsGenericMethod property is true, but the IsGenericMethodDefinition property is false.

ArgumentNullException

pset is nullptr.

AddDeclarativeSecurity can be called several times, with each call specifying a security action (such as Demand, Assert, and Deny) and a set of permissions that the action applies to.

NoteNote

In the .NET Framework versions 1.0, 1.1, and 2.0, the declarative security attributes applied to a method by using the AddDeclarativeSecurity method are stored in the old XML metadata format. See Emitting Declarative Security Attributes.

The code sample below illustrates the contextual use of AddDeclarativeSecurity to require the caller of a method to have unrestricted permissions.

// myModBuilder is an instance of ModuleBuilder. 
// Note that for the use of PermissionSet and SecurityAction, 
// the namespaces System::Security and System::Security::Permissions 
// should be included.

TypeBuilder^ myTypeBuilder = myModBuilder->DefineType( "MyType",
                             TypeAttributes::Public );

array<Type^>^ temp0 = {int::typeid, int::typeid};
MethodBuilder^ myMethod1 = myTypeBuilder->DefineMethod( "MyMethod",
                           MethodAttributes::Public,
                           int::typeid, temp0 );

PermissionSet^ myMethodPermissions = gcnew PermissionSet(
                                     PermissionState::Unrestricted );

myMethod1->AddDeclarativeSecurity( SecurityAction::Demand,
                                   myMethodPermissions );

.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