Collapse the table of content
Expand the table of content
Expand Minimize

TypeAttributes Enumeration

Specifies type attributes.

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

Namespace:  System.Reflection
Assemblies:   System.Reflection.Primitives (in System.Reflection.Primitives.dll)
  mscorlib (in mscorlib.dll)

[FlagsAttribute]
public enum TypeAttributes

Member nameDescription
Supported by the XNA FrameworkSupported by Portable Class LibraryAbstractSpecifies that the type is abstract.
Supported by the XNA FrameworkSupported by Portable Class LibraryAnsiClassLPTSTR is interpreted as ANSI.
Supported by the XNA FrameworkSupported by Portable Class LibraryAutoClassLPTSTR is interpreted automatically.
Supported by the XNA FrameworkSupported by Portable Class LibraryAutoLayoutSpecifies that class fields are automatically laid out by the common language runtime.
Supported by the XNA FrameworkSupported by Portable Class LibraryBeforeFieldInitSpecifies that calling static methods of the type does not force the system to initialize the type.
Supported by the XNA FrameworkSupported by Portable Class LibraryClassSpecifies that the type is a class.
Supported by the XNA FrameworkSupported by Portable Class LibraryClassSemanticsMaskSpecifies class semantics information; the current class is contextful (else agile).
Supported by Portable Class LibraryCustomFormatClassLPSTR 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.
Supported by Portable Class LibraryCustomFormatMaskUsed 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.
Supported by the XNA FrameworkSupported by Portable Class LibraryExplicitLayoutSpecifies that class fields are laid out at the specified offsets.
Supported by the XNA FrameworkSupported by Portable Class LibraryHasSecurityType has security associate with it.
Supported by the XNA FrameworkSupported by Portable Class LibraryImportSpecifies that the class or interface is imported from another module.
Supported by the XNA FrameworkSupported by Portable Class LibraryInterfaceSpecifies that the type is an interface.
Supported by the XNA FrameworkSupported by Portable Class LibraryLayoutMaskSpecifies class layout information.
Supported by the XNA FrameworkSupported by Portable Class LibraryNestedAssemblySpecifies that the class is nested with assembly visibility, and is thus accessible only by methods within its assembly.
Supported by the XNA FrameworkSupported by Portable Class LibraryNestedFamANDAssemSpecifies 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.
Supported by the XNA FrameworkSupported by Portable Class LibraryNestedFamilySpecifies that the class is nested with family visibility, and is thus accessible only by methods within its own type and any derived types.
Supported by the XNA FrameworkSupported by Portable Class LibraryNestedFamORAssemSpecifies 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.
Supported by the XNA FrameworkSupported by Portable Class LibraryNestedPrivateSpecifies that the class is nested with private visibility.
Supported by the XNA FrameworkSupported by Portable Class LibraryNestedPublicSpecifies that the class is nested with public visibility.
Supported by the XNA FrameworkSupported by Portable Class LibraryNotPublicSpecifies that the class is not public.
Supported by the XNA FrameworkSupported by Portable Class LibraryPublicSpecifies that the class is public.
Supported by the XNA FrameworkReservedMaskAttributes reserved for runtime use.
Supported by the XNA FrameworkSupported by Portable Class LibraryRTSpecialNameRuntime should check name encoding.
Supported by the XNA FrameworkSupported by Portable Class LibrarySealedSpecifies that the class is concrete and cannot be extended.
Supported by the XNA FrameworkSupported by Portable Class LibrarySequentialLayoutSpecifies that class fields are laid out sequentially, in the order that the fields were emitted to the metadata.
Supported by the XNA FrameworkSupported by Portable Class LibrarySerializableSpecifies that the class can be serialized.
Supported by the XNA FrameworkSupported by Portable Class LibrarySpecialNameSpecifies that the class is special in a way denoted by the name.
Supported by the XNA FrameworkSupported by Portable Class LibraryStringFormatMaskUsed to retrieve string information for native interoperability.
Supported by the XNA FrameworkSupported by Portable Class LibraryUnicodeClassLPTSTR is interpreted as UNICODE.
Supported by the XNA FrameworkSupported by Portable Class LibraryVisibilityMaskSpecifies type visibility information.
WindowsRuntimeSpecifies a Windows Runtime type.

Some of the members of the TypeAttributes enumeration are masks that represent a set of mutually exclusive attributes. For example, the TypeAttributes.VisibilityMask member includes the TypeAttributes.NotPublic, TypeAttributes.Public, TypeAttributes.NestedPublic, TypeAttributes.NestedPrivate, TypeAttributes.NestedFamily, TypeAttributes.NestedAssembly, TypeAttributes.NestedFamANDAssem, and TypeAttributes.NestedFamORAssem members, Because each attribute set includes a member whose underlying value is zero, you should first And the value of the mask with the specific TypeAttributes value retrieved from a property such as Type.Attributes. The following table lists the masks and the individual members that they include:

Mask

Includes

VisibilityMask

NotPublic
Public
NestedPublic
NestedPrivate
NestedFamily
NestedAssembly
NestedFamANDAssem
NestedFamORAssem

LayoutMask

AutoLayout
SequentialLayout
ExplicitLayout

ClassSemanticsMask

Class
Interface

StringFormatMask

AnsiClass
UnicodeClass
AutoClass
CustomFormatClass

CustomFormatMask

No members.

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

The following example retrieves the value of the Attributes property for Type objects that represent a number of different types, and then determines whether individual attribute flags have been set.

using System;
using System.Reflection;

internal struct S
{
    public int X;
}

public abstract class Example
{
    protected sealed class NestedClass {}

    public interface INested {}

    public static void Main()
    {
        // Create an array of types.
        Type[] types = { typeof(Example), typeof(NestedClass),
                         typeof(INested), typeof(S) };

        foreach (var t in types) {
           Console.WriteLine("Attributes for type {0}:", t.Name);

           TypeAttributes attr = t.Attributes;

           // To test for visibility attributes, you must use the visibility mask.
           TypeAttributes visibility = attr & TypeAttributes.VisibilityMask;
           switch (visibility)
           {
               case TypeAttributes.NotPublic:
                   Console.WriteLine("   ...is not public");
                   break;
               case TypeAttributes.Public:
                   Console.WriteLine("   ...is public");
                   break;
               case TypeAttributes.NestedPublic:
                   Console.WriteLine("   ...is nested and public");
                   break;
               case TypeAttributes.NestedPrivate:
                   Console.WriteLine("   ...is nested and private");
                   break;
               case TypeAttributes.NestedFamANDAssem:
                   Console.WriteLine("   ...is nested, and inheritable only within the assembly" +
                      "\n         (cannot be declared in C#)");
                   break;
               case TypeAttributes.NestedAssembly:
                   Console.WriteLine("   ...is nested and internal");
                   break;
               case TypeAttributes.NestedFamily:
                   Console.WriteLine("   ...is nested and protected");
                   break;
               case TypeAttributes.NestedFamORAssem:
                   Console.WriteLine("   ...is nested and protected internal");
                   break;
           }

           ' Use the layout mask to test for layout attributes.
           TypeAttributes layout = attr & TypeAttributes.LayoutMask;
           switch (layout)
           {
               case TypeAttributes.AutoLayout:
                   Console.WriteLine("   ...is AutoLayout");
                   break;
               case TypeAttributes.SequentialLayout:
                   Console.WriteLine("   ...is SequentialLayout");
                   break;
               case TypeAttributes.ExplicitLayout:
                   Console.WriteLine("   ...is ExplicitLayout");
                   break;
           }

           ' Use the class semantics mask to test for class semantics attributes.
           TypeAttributes classSemantics = attr & TypeAttributes.ClassSemanticsMask;
           switch (classSemantics)
           {
               case TypeAttributes.Class:
                   if (t.IsValueType)
                   {
                       Console.WriteLine("   ...is a value type");
                   }
                   else
                   {
                       Console.WriteLine("   ...is a class");
                   }
                   break;
               case TypeAttributes.Interface:
                   Console.WriteLine("   ...is an interface");
                   break;
           }

           if (0!=(attr & TypeAttributes.Abstract))
           {
               Console.WriteLine("   ...is abstract");
           }

           if (0!=(attr & TypeAttributes.Sealed))
           {
               Console.WriteLine("   ...is sealed");
           }
           Console.WriteLine();
       }
    }
}
// The example displays 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

.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

XNA Framework

Supported in: 3.0, 2.0, 1.0

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Portable Class Library

Supported in: Portable Class Library
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2015 Microsoft