Condividi tramite


TypeAttributes Enumerazione

Definizione

Specifica gli attributi di tipo.

Questa enumerazione supporta una combinazione bit per bit dei rispettivi valori dei membri.

public enum class TypeAttributes
[System.Flags]
public enum TypeAttributes
[System.Flags]
[System.Serializable]
public enum TypeAttributes
[System.Flags]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public enum TypeAttributes
[<System.Flags>]
type TypeAttributes = 
[<System.Flags>]
[<System.Serializable>]
type TypeAttributes = 
[<System.Flags>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type TypeAttributes = 
Public Enum TypeAttributes
Ereditarietà
TypeAttributes
Attributi

Campi

Nome Valore Descrizione
AnsiClass 0

LPTSTR viene interpretato come ANSI.

AutoLayout 0

Specifica che i campi della classe vengono disposti automaticamente da Common Language Runtime.

Class 0

Specifica che il tipo è una classe.

NotPublic 0

Specifica che la classe non è pubblica.

Public 1

Specifica che la classe è pubblica.

NestedPublic 2

Specifica che la classe è annidata con visibilità pubblica.

NestedPrivate 3

Specifica che la classe è annidata con visibilità privata.

NestedFamily 4

Specifica che la classe è annidata con visibilità della famiglia ed è quindi accessibile solo dai metodi all'interno del proprio tipo e da qualsiasi tipo derivato.

NestedAssembly 5

Specifica che la classe è annidata con visibilità dell'assembly ed è quindi accessibile solo dai metodi all'interno dell'assembly.

NestedFamANDAssem 6

Specifica che la classe è annidata con visibilità di assembly e famiglia ed è quindi accessibile solo dai metodi che si trovano nell'intersezione della famiglia e dell'assembly.

NestedFamORAssem 7

Specifica che la classe è annidata con visibilità famiglia o assembly ed è quindi accessibile solo dai metodi che si trovano nell'unione della famiglia e dell'assembly.

VisibilityMask 7

Specifica le informazioni sulla visibilità dei tipi.

SequentialLayout 8

Specifica che i campi della classe sono disposti in sequenza, nell'ordine in cui i campi sono stati generati nei metadati.

ExplicitLayout 16

Specifica che i campi della classe sono disposti in corrispondenza degli offset specificati.

ExtendedLayout 24
LayoutMask 24

Specifica le informazioni sul layout della classe.

ClassSemanticsMask 32

Specifica le informazioni sulla semantica della classe; la classe corrente è contestuale (altrimenti agile).

Interface 32

Specifica che il tipo è un'interfaccia.

Abstract 128

Specifica che il tipo è astratto.

Sealed 256

Specifica che la classe è concreta e non può essere estesa.

SpecialName 1024

Specifica che la classe è speciale in un modo indicato dal nome.

RTSpecialName 2048

Il runtime deve controllare la codifica dei nomi.

Import 4096

Specifica che la classe o l'interfaccia viene importata da un altro modulo.

Serializable 8192

Specifica che la classe può essere serializzata.

WindowsRuntime 16384

Specifica un tipo di Windows Runtime.

UnicodeClass 65536

LPTSTR viene interpretato come UNICODE.

AutoClass 131072

LPTSTR viene interpretato automaticamente.

CustomFormatClass 196608

LPSTR viene interpretato da alcuni mezzi specifici dell'implementazione, che include la possibilità di generare un oggetto NotSupportedException. Non usato nell'implementazione Microsoft di .NET Framework.

StringFormatMask 196608

Consente di recuperare informazioni sulle stringhe per l'interoperabilità nativa.

HasSecurity 262144

Al tipo è associata la sicurezza.

ReservedMask 264192

Attributi riservati per l'uso in fase di esecuzione.

BeforeFieldInit 1048576

Specifica che la chiamata di metodi statici del tipo non forza l'inizializzazione del tipo da parte del sistema.

CustomFormatMask 12582912

Consente di recuperare informazioni di codifica non standard per l'interoperabilità nativa. Il significato dei valori di questi 2 bit non è specificato. Non usato nell'implementazione Microsoft di .NET Framework.

Esempio

Nell'esempio seguente viene recuperato il valore della Attributes proprietà per Type gli oggetti che rappresentano un numero di tipi diversi e quindi determina se sono stati impostati singoli flag di attributo.

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 ((attr & TypeAttributes.Abstract) != 0)
           {
               Console.WriteLine("   ...is abstract");
           }

           if ((attr & TypeAttributes.Sealed) != 0)
           {
               Console.WriteLine("   ...is sealed");
           }
           
           Console.WriteLine();
       }
    }
}
// The example displays the following output:
// Attributes for type Example:
//    ...is public
//    ...is AutoLayout
//    ...is a class
//    ...is abstract

// Attributes for type NestedClass:
//    ...is nested and protected
//    ...is AutoLayout
//    ...is a class
//    ...is sealed

// Attributes for type INested:
//    ...is nested and public
//    ...is AutoLayout
//    ...is an interface
//    ...is abstract

// Attributes for type S:
//    ...is not public
//    ...is SequentialLayout
//    ...is a value type
//    ...is sealed
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

    Public Shared Sub Main()
        ' Create an array of types.
        Dim types() As Type = { GetType(Example), GetType(NestedClass),
                                GetType(INested), GetType(S) }

        For Each t In types
           Console.WriteLine("Attributes for type {0}:", t.Name)

           Dim attr As TypeAttributes = t.Attributes

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

           ' Use the layout mask to test for layout attributes.
           Dim layout As TypeAttributes = attr And TypeAttributes.LayoutMask
           Select Case layout
               Case TypeAttributes.AutoLayout:
                   Console.WriteLine("   ...is AutoLayout")
               Case TypeAttributes.SequentialLayout:
                   Console.WriteLine("   ...is SequentialLayout")
               Case TypeAttributes.ExplicitLayout:
                   Console.WriteLine("   ...is ExplicitLayout")
           End Select

           ' Use the class semantics mask to test for class semantics attributes.
           Dim classSemantics As TypeAttributes = attr And TypeAttributes.ClassSemanticsMask
           Select Case classSemantics
               Case TypeAttributes.Class:
                   If t.IsValueType Then
                       Console.WriteLine("   ...is a value type")
                   Else
                       Console.WriteLine("   ...is a class")
                   End If
               Case TypeAttributes.Interface:
                   Console.WriteLine("   ...is an interface")
           End Select

           If 0 <> (attr And TypeAttributes.Abstract) Then _
               Console.WriteLine("   ...is MustInherit")

           If 0 <> (attr And TypeAttributes.Sealed) Then _
               Console.WriteLine("   ...is NotInheritable")
           Console.WriteLine()
       Next
    End Sub
End Class
' 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

Commenti

Alcuni membri dell'enumerazione TypeAttributes sono maschere che rappresentano un set di attributi che si escludono a vicenda. Ad esempio, il VisibilityMask membro include i NotPublicmembri , NestedPublicPublic, NestedPrivate, NestedFamilyNestedAssemblyNestedFamANDAssem, e .NestedFamORAssem Poiché ogni set di attributi include un membro il cui valore sottostante è zero, è necessario innanzitutto And il valore della maschera con il valore specifico System.Reflection.TypeAttributes recuperato da una proprietà, ad Type.Attributesesempio . Nella tabella seguente sono elencate le maschere e i singoli membri inclusi:

Maschera Includes
VisibilityMask NotPublic
Pubblico
NestedPublic
NestedPrivate
NestedFamily
NestedAssembly
NestedFamANDAssem
NestedFamORAssem
LayoutMask Autolayout
SequentialLayout
ExplicitLayout
ClassSemanticsMask Classe
Interfaccia
StringFormatMask AnsiClass
UnicodeClass
AutoClass
CustomFormatClass
CustomFormatMask Nessun membro.

I membri di questa classe enumeratore corrispondono all'enumeratore CorTypeAttr come definito nel file corhdr.h.

Si applica a