0 out of 1 rated this helpful - Rate this topic

ReflectionPermission Class

.NET Framework 4

Controls access to non-public types and members through the System.Reflection APIs. Controls some features of the System.Reflection.Emit APIs.

Inheritance Hierarchy

System.Object
System.Security.CodeAccessPermission
System.Security.Permissions.ReflectionPermission

Namespace: System.Security.Permissions
Assembly: mscorlib (in mscorlib.dll)

Syntax

C++

Copy

[SerializableAttribute]
[ComVisibleAttribute(true)]
public sealed class ReflectionPermission : CodeAccessPermission, 
	IUnrestrictedPermission

The ReflectionPermission type exposes the following members.

Constructors

	Name	Description
	ReflectionPermission(PermissionState)	Initializes a new instance of the ReflectionPermission class with either fully restricted or unrestricted permission as specified.
	ReflectionPermission(ReflectionPermissionFlag)	Initializes a new instance of the ReflectionPermission class with the specified access.

Top

Properties

	Name	Description
	Flags	Gets or sets the type of reflection allowed for the current permission.

Top

Methods

	Name	Description
	Assert	Declares that the calling code can access the resource protected by a permission demand through the code that calls this method, even if callers higher in the stack have not been granted permission to access the resource. Using Assert can create security issues. (Inherited from CodeAccessPermission.)
	Copy	Creates and returns an identical copy of the current permission. (Overrides CodeAccessPermission.Copy().)
	Demand	Forces a SecurityException at run time if all callers higher in the call stack have not been granted the permission specified by the current instance. (Inherited from CodeAccessPermission.)
	Deny	Obsolete. Prevents callers higher in the call stack from using the code that calls this method to access the resource specified by the current instance. (Inherited from CodeAccessPermission.)
	Equals	Determines whether the specified CodeAccessPermission object is equal to the current CodeAccessPermission. (Inherited from CodeAccessPermission.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	FromXml	Reconstructs a permission with a specified state from an XML encoding. (Overrides CodeAccessPermission.FromXml(SecurityElement).)
	GetHashCode	Gets a hash code for the CodeAccessPermission object that is suitable for use in hashing algorithms and data structures such as a hash table. (Inherited from CodeAccessPermission.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	Intersect	Creates and returns a permission that is the intersection of the current permission and the specified permission. (Overrides CodeAccessPermission.Intersect(IPermission).)
	IsSubsetOf	Determines whether the current permission is a subset of the specified permission. (Overrides CodeAccessPermission.IsSubsetOf(IPermission).)
	IsUnrestricted	Returns a value indicating whether the current permission is unrestricted.
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	PermitOnly	Prevents callers higher in the call stack from using the code that calls this method to access all resources except for the resource specified by the current instance. (Inherited from CodeAccessPermission.)
	ToString	Creates and returns a string representation of the current permission object. (Inherited from CodeAccessPermission.)
	ToXml	Creates an XML encoding of the permission and its current state. (Overrides CodeAccessPermission.ToXml().)
	Union	Creates a permission that is the union of the current permission and the specified permission. (Overrides CodeAccessPermission.Union(IPermission).)

Top

Remarks

Without ReflectionPermission, code can use reflection to access only the public members of objects. Code with ReflectionPermission and the appropriate ReflectionPermissionFlag flags can access the protected and private members of objects.

Caution
Because ReflectionPermission can provide access to non-public types and members, we recommend that you do not grant ReflectionPermission to Internet code, except with the ReflectionPermissionFlag.RestrictedMemberAccess flag. RestrictedMemberAccess allows access to non-public members, with the restriction that the grant set of the non-public members must be equal to, or a subset of, the grant set of the code that accesses the non-public members.

Caution

Because ReflectionPermission can provide access to non-public types and members, we recommend that you do not grant ReflectionPermission to Internet code, except with the ReflectionPermissionFlag.RestrictedMemberAccess flag. RestrictedMemberAccess allows access to non-public members, with the restriction that the grant set of the non-public members must be equal to, or a subset of, the grant set of the code that accesses the non-public members.

Certain features of reflection emit, such as emitting debug symbols, require ReflectionPermission with the ReflectionPermissionFlag.ReflectionEmit flag.

For more information, see the ReflectionPermissionFlag enumeration.

Version Information

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.