SecurityPermissionAttribute Class

Definition

Namespace:

System.Security.Permissions

Assembly:

System.Runtime.dll

Source:

SecurityPermissionAttribute.cs

Caution

Code Access Security is not supported or honored by the runtime.

Allows security actions for SecurityPermission to be applied to code using declarative security. This class cannot be inherited.

public ref class SecurityPermissionAttribute sealed : System::Security::Permissions::CodeAccessSecurityAttribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)]
[System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public sealed class SecurityPermissionAttribute : System.Security.Permissions.CodeAccessSecurityAttribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Class | System.AttributeTargets.Constructor | System.AttributeTargets.Method | System.AttributeTargets.Struct, AllowMultiple=true, Inherited=false)>]
[<System.Obsolete("Code Access Security is not supported or honored by the runtime.", DiagnosticId="SYSLIB0003", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
type SecurityPermissionAttribute = class
    inherit CodeAccessSecurityAttribute

Public NotInheritable Class SecurityPermissionAttribute
Inherits CodeAccessSecurityAttribute

Inheritance

Object

Attribute

SecurityAttribute

CodeAccessSecurityAttribute

SecurityPermissionAttribute

Attributes

AttributeUsageAttribute ObsoleteAttribute

Remarks

Caution

Code Access Security (CAS) has been deprecated across all versions of .NET Framework and .NET. Recent versions of .NET do not honor CAS annotations and produce errors if CAS-related APIs are used. Developers should seek alternative means of accomplishing security tasks.

The scope of the declaration that is allowed depends on the SecurityAction that is used.

The security information declared by a security attribute is stored in the metadata of the attribute target and is accessed by the system at run time. Security attributes are used only for declarative security. For imperative security, use the corresponding permission class.

When you use the SecurityPermissionAttribute class, follow the security action with the permission(s) that are being requested. Each security permission that can be requested, as defined in the SecurityPermissionFlag enumeration, has a corresponding property in the SecurityPermissionAttribute class. For example, to demand the ability to access unmanaged code, follow the demand statement with the property setting that is being requested, as follows: SecurityPermissionAttribute(SecurityAction.Demand, UnmanagedCode=true).

Note

An exception to the equivalence between the SecurityPermissionFlag enumeration and the SecurityPermissionAttribute properties is that the AllFlags enumeration value is represented by the Unrestricted property (inherited from the SecurityAttribute class). To demand all security permissions, specify Unrestricted=true.

Constructors

SecurityPermissionAttribute(SecurityAction)

Initializes a new instance of the SecurityPermissionAttribute class with the specified SecurityAction.

Properties

Action	Gets or sets a security action. (Inherited from SecurityAttribute)
Assertion	Gets or sets a value indicating whether permission to assert that all this code's callers have the requisite permission for the operation is declared.
BindingRedirects	Gets or sets a value that indicates whether code has permission to perform binding redirection in the application configuration file.
ControlAppDomain	Gets or sets a value indicating whether permission to manipulate AppDomain is declared.
ControlDomainPolicy	Gets or sets a value indicating whether permission to alter or manipulate domain security policy is declared.
ControlEvidence	Gets or sets a value indicating whether permission to alter or manipulate evidence is declared.
ControlPolicy	Gets or sets a value indicating whether permission to view and manipulate security policy is declared.
ControlPrincipal	Gets or sets a value indicating whether permission to manipulate the current principal is declared.
ControlThread	Gets or sets a value indicating whether permission to manipulate threads is declared.
Execution	Gets or sets a value indicating whether permission to execute code is declared.
Flags	Gets or sets all permission flags comprising the SecurityPermission permissions.
Infrastructure	Gets or sets a value indicating whether code can plug into the common language runtime infrastructure, such as adding Remoting Context Sinks, Envoy Sinks and Dynamic Sinks.
RemotingConfiguration	Gets or sets a value indicating whether code can configure remoting types and channels.
SerializationFormatter	Gets or sets a value indicating whether code can use a serialization formatter to serialize or deserialize an object.
SkipVerification	Gets or sets a value indicating whether permission to bypass code verification is declared.
TypeId	When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute)
UnmanagedCode	Gets or sets a value indicating whether permission to call unmanaged code is declared.
Unrestricted	Gets or sets a value indicating whether full (unrestricted) permission to the resource protected by the attribute is declared. (Inherited from SecurityAttribute)

Methods

CreatePermission()	Creates and returns a new SecurityPermission.
Equals(Object)	Returns a value that indicates whether this instance is equal to a specified object. (Inherited from Attribute)
GetHashCode()	Returns the hash code for this instance. (Inherited from Attribute)
GetType()	Gets the Type of the current instance. (Inherited from Object)
IsDefaultAttribute()	When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class. (Inherited from Attribute)
Match(Object)	When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ToString()	Returns a string that represents the current object. (Inherited from Object)

See also

• SecurityPermission
• SecurityPermissionFlag
• Extending Metadata Using Attributes