Duration (Pacific Standard Time):
To (Pacific Standard Time):
  • None
User Action:
  • None
.NET Framework Class Library

CodeAccessSecurityAttribute Class

Specifies the base attribute class for code access security.


Namespace:  System.Security.Permissions
Assembly:  mscorlib (in mscorlib.dll)
<SerializableAttribute> _
<AttributeUsageAttribute(AttributeTargets.Assembly Or AttributeTargets.Class Or AttributeTargets.Struct Or AttributeTargets.Constructor Or AttributeTargets.Method, AllowMultiple := True,  _
	Inherited := False)> _
<ComVisibleAttribute(True)> _
Public MustInherit Class CodeAccessSecurityAttribute _
	Inherits SecurityAttribute

The CodeAccessSecurityAttribute type exposes the following members.

  Name Description
Protected method CodeAccessSecurityAttribute Initializes a new instance of CodeAccessSecurityAttribute with the specified SecurityAction.
  Name Description
Public property Action Gets or sets a security action. (Inherited from SecurityAttribute.)
Public property TypeId When implemented in a derived class, gets a unique identifier for this Attribute. (Inherited from Attribute.)
Public property Unrestricted Gets or sets a value indicating whether full (unrestricted) permission to the resource protected by the attribute is declared. (Inherited from SecurityAttribute.)
  Name Description
Public method CreatePermission When overridden in a derived class, creates a permission object that can then be serialized into binary form and persistently stored along with the SecurityAction in an assembly's metadata. (Inherited from SecurityAttribute.)
Public method Equals Infrastructure. Returns a value that indicates whether this instance is equal to a specified object. (Inherited from Attribute.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Returns the hash code for this instance. (Inherited from Attribute.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method 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.)
Public method Match When overridden in a derived class, returns a value that indicates whether this instance equals a specified object. (Inherited from Attribute.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
  Name Description
Explicit interface implemetation Private method _Attribute.GetIDsOfNames Maps a set of names to a corresponding set of dispatch identifiers. (Inherited from Attribute.)
Explicit interface implemetation Private method _Attribute.GetTypeInfo Retrieves the type information for an object, which can be used to get the type information for an interface. (Inherited from Attribute.)
Explicit interface implemetation Private method _Attribute.GetTypeInfoCount Retrieves the number of type information interfaces that an object provides (either 0 or 1). (Inherited from Attribute.)
Explicit interface implemetation Private method _Attribute.Invoke Provides access to properties and methods exposed by an object. (Inherited from Attribute.)

This attribute class associates a SecurityAction, for example, Demand, with a custom security attribute.

The types that derive from CodeAccessSecurityAttribute are used to help restrict access to resources or securable operations.

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. Use the corresponding permission class derived from CodeAccessPermission for imperative security.

Notes to Inheritors

All permission attributes derived from this class must have only a single constructor that takes a SecurityAction as its only parameter.

The following example shows a permission attribute derived from the CodeAccessSecurityAttribute class.

Imports System
Imports System.IO
Imports System.Runtime.Remoting
Imports System.Security
Imports System.Security.Permissions
Imports System.Reflection
Imports MyPermission
Imports Microsoft.VisualBasic

' Use the command line option '/keyfile' or appropriate project settings to sign this assembly.
<Assembly: System.Security.AllowPartiallyTrustedCallersAttribute()> 
Namespace MyPermissionAttribute

    <AttributeUsage(AttributeTargets.All, AllowMultiple:=True, Inherited:=False)> Public NotInheritable Class NameIdPermissionAttribute
        Inherits CodeAccessSecurityAttribute
        Private m_Name As String = Nothing 
        Private m_unrestricted As Boolean = False 

        Public Sub New(ByVal action As SecurityAction)
        End Sub 'New 

        Public Property Name() As String 
                Return m_name
            End Get 
            Set(ByVal Value As String)
                m_name = Value
            End Set 
        End Property 

        Public Overrides Function CreatePermission() As IPermission
            If m_unrestricted Then 
                Throw New ArgumentException("Unrestricted permissions not allowed in identity permissions.")
                If m_name Is Nothing Then 
                    Return New NameIdPermission(PermissionState.None)
                End If 
                Return New NameIdPermission(m_name)
            End If 
        End Function 'CreatePermission
    End Class ' NameIdPermissionAttribute
End Namespace

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Obsolete (compiler warning) in Windows Phone 8.1

Obsolete (compiler warning) in Windows Phone Silverlight 8.1

Obsolete (compiler warning) in Windows Phone Silverlight 8
Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.