TypeAttributes Enumeration
TOC
Collapse the table of content
Expand the table of content

TypeAttributes Enumeration

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Specifies type attributes.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

'Declaration
<FlagsAttribute> _
Public Enumeration TypeAttributes

Member nameDescription
AbstractSpecifies that the type is abstract.
AnsiClassLPTSTR is interpreted as ANSI.
AutoClassLPTSTR is interpreted automatically.
AutoLayoutSpecifies that class fields are automatically laid out by the common language runtime.
BeforeFieldInitSpecifies that calling static methods of the type does not force the system to initialize the type.
ClassSpecifies that the type is a class.
ClassSemanticsMaskSpecifies class semantics information; the current class is contextful (else agile).
CustomFormatClassLPSTR is interpreted by some implementation-specific means, which includes the possibility of throwing a NotSupportedException. Not used in the Microsoft implementation of the .NET Framework.
CustomFormatMaskUsed to retrieve non-standard encoding information for native interop. The meaning of the values of these 2 bits is unspecified. Not used in the Microsoft implementation of the .NET Framework.
ExplicitLayoutSpecifies that class fields are laid out at the specified offsets.
HasSecurityType has security associate with it.
ImportSpecifies that the class or interface is imported from another module.
InterfaceSpecifies that the type is an interface.
LayoutMaskSpecifies class layout information.
NestedAssemblySpecifies that the class is nested with assembly visibility, and is thus accessible only by methods within its assembly.
NestedFamANDAssemSpecifies that the class is nested with assembly and family visibility, and is thus accessible only by methods lying in the intersection of its family and assembly.
NestedFamilySpecifies that the class is nested with family visibility, and is thus accessible only by methods within its own type and any subtypes.
NestedFamORAssemSpecifies that the class is nested with family or assembly visibility, and is thus accessible only by methods lying in the union of its family and assembly.
NestedPrivateSpecifies that the class is nested with private visibility.
NestedPublicSpecifies that the class is nested with public visibility.
NotPublicSpecifies that the class is not public.
PublicSpecifies that the class is public.
ReservedMaskAttributes reserved for runtime use.
RTSpecialNameRuntime should check name encoding.
SealedSpecifies that the class is concrete and cannot be extended.
SequentialLayoutSpecifies that class fields are laid out sequentially, in the order that the fields were emitted to the metadata.
SerializableSpecifies that the class can be serialized.
SpecialNameSpecifies that the class is special in a way denoted by the name.
StringFormatMaskUsed to retrieve string information for native interoperability.
UnicodeClassLPTSTR is interpreted as UNICODE.
VisibilityMaskSpecifies type visibility information.
WindowsRuntimeSpecifies a Windows Runtime type.

The members of this enumerator class match the CorTypeAttr enumerator as defined in the corhdr.h file.

The following example shows the use of type attributes. The fact that there is a member in each of several groupings that has the value zero means that you must use masks before testing for those members.

For most purposes, properties like Type.IsClass, Type.IsAutoLayout, and Type.IsSpecialName are easier to use than type attributes.


Imports System.Reflection

Friend Structure S
    Public X As Integer
End Structure

Public MustInherit Class Example

    Protected NotInheritable Class NestedClass
    End Class

    Public Interface INested
    End Interface

    Private Shared outputBlock As System.Windows.Controls.TextBlock

    Public Shared Sub Demo(ByVal outputBlock As System.Windows.Controls.TextBlock)

        Example.outputBlock = outputBlock

        DisplayAttributes(GetType(Example))
        DisplayAttributes(GetType(NestedClass))
        DisplayAttributes(GetType(INested))
        DisplayAttributes(GetType(S))

    End Sub

    Private Shared Sub DisplayAttributes(ByVal t As Type)

        outputBlock.Text &= "Attributes for type " & t.Name & ":" & vbLf

        Dim attr As TypeAttributes = t.Attributes

        ' To test for visibility attributes, you must use the visibility
        ' mask.
        Dim visibility As TypeAttributes = attr And TypeAttributes.VisibilityMask
        Select Case visibility
            Case TypeAttributes.NotPublic:
                outputBlock.Text &= "   ...is not Public" & vbLf
            Case TypeAttributes.Public:
                outputBlock.Text &= "   ...is Public" & vbLf
            Case TypeAttributes.NestedPublic:
                outputBlock.Text &= "   ...is nested and Public" & vbLf
            Case TypeAttributes.NestedPrivate:
                outputBlock.Text &= "   ...is nested and Private" & vbLf
            Case TypeAttributes.NestedFamANDAssem:
                outputBlock.Text &= "   ...is nested, and inheritable only within the assembly" & _
                   vbLf & "         (cannot be declared in Visual Basic)" & vbLf
            Case TypeAttributes.NestedAssembly:
                outputBlock.Text &= "   ...is nested and Friend" & vbLf
            Case TypeAttributes.NestedFamily:
                outputBlock.Text &= "   ...is nested and Protected" & vbLf
            Case TypeAttributes.NestedFamORAssem:
                outputBlock.Text &= "   ...is nested and Protected Friend" & vbLf
        End Select

        Dim layout As TypeAttributes = attr And TypeAttributes.LayoutMask
        Select Case layout
            Case TypeAttributes.AutoLayout:
                outputBlock.Text &= "   ...is AutoLayout" & vbLf
            Case TypeAttributes.SequentialLayout:
                outputBlock.Text &= "   ...is SequentialLayout" & vbLf
            Case TypeAttributes.ExplicitLayout:
                outputBlock.Text &= "   ...is ExplicitLayout" & vbLf
        End Select

        Dim classSemantics As TypeAttributes = attr And TypeAttributes.ClassSemanticsMask
        Select Case classSemantics
            Case TypeAttributes.Class:
                If t.IsValueType Then
                    outputBlock.Text &= "   ...is a value type" & vbLf
                Else
                    outputBlock.Text &= "   ...is a class" & vbLf
                End If
            Case TypeAttributes.Interface:
                outputBlock.Text &= "   ...is an interface" & vbLf
        End Select

        If 0 <> (attr And TypeAttributes.Abstract) Then _
            outputBlock.Text &= "   ...is MustInherit" & vbLf

        If 0 <> (attr And TypeAttributes.Sealed) Then _
            outputBlock.Text &= "   ...is NotInheritable" & vbLf
   End Sub 
End Class 

' This example produces the following output:
'
'Attributes for type Example:
'    ...is Public
'    ...is AutoLayout
'    ...is a class
'    ...is MustInherit
'Attributes for type NestedClass:
'    ...is nested and Protected
'    ...is AutoLayout
'    ...is a class
'    ...is NotInheritable
'Attributes for type INested:
'    ...is nested and Public
'    ...is AutoLayout
'    ...is an interface
'    ...is MustInherit
'Attributes for type S:
'    ...is not Public
'    ...is SequentialLayout
'    ...is a value type
'    ...is NotInheritable


Windows Phone OS

Supported in: 8.1, 8.0, 7.1, 7.0

Windows Phone

Show:
© 2017 Microsoft