ModuleBuilder.DefineEnum(String, TypeAttributes, Type) Méthode

Définition

Espace de noms:

System.Reflection.Emit

Assembly:

mscorlib.dll

Définit un type d’énumération qui est un type valeur avec un seul champ non statique appelé value__ du type spécifié.

public:
 System::Reflection::Emit::EnumBuilder ^ DefineEnum(System::String ^ name, System::Reflection::TypeAttributes visibility, Type ^ underlyingType);

public System.Reflection.Emit.EnumBuilder DefineEnum(string name, System.Reflection.TypeAttributes visibility, Type underlyingType);

member this.DefineEnum : string * System.Reflection.TypeAttributes * Type -> System.Reflection.Emit.EnumBuilder

Public Function DefineEnum (name As String, visibility As TypeAttributes, underlyingType As Type) As EnumBuilder

Paramètres

name

String

Chemin d’accès complet du type d’énumération. name ne peut pas contenir de valeurs Null incorporées.

visibility

TypeAttributes

Attributs de type pour l’énumération. Les attributs sont tous les bits définis par VisibilityMask.

underlyingType

Type

Type sous-jacent de l’énumération. Il doit s’agir d’un type entier intégré.

Retours

EnumBuilder

Énumération définie.

Exceptions

ArgumentException

Les attributs autres que les attributs de visibilité sont fournis.

-ou-

Une énumération portant le nom donné existe dans l’assembly parent de ce module.

-ou-

Les attributs de visibilité ne correspondent pas à l’étendue de l’énumération. Par exemple, NestedPublic est spécifié pour visibility, mais l’énumération n’est pas un type imbriqué.

ArgumentNullException

name a la valeur null.

Exemples

L’exemple suivant illustre l’utilisation d’une DefineEnum classe d’énumération dans un module dynamique. L’exemple définit une énumération nommée Elevation qui a un type sous-jacent de Int32, et crée deux éléments : Low, avec une valeur 0 et High, avec une valeur de 1. Une fois le type créé, l’assembly est enregistré avec le nom TempAssembly.dll. Vous pouvez utiliser le Ildasm.exe (désassembleur IL) pour examiner le contenu de cet assembly.

Note

Avant le .NET Framework version 2.0, cet exemple de code ne produit pas d’énumération correcte.

using System;
using System.Reflection;
using System.Reflection.Emit;

class Example
{
    public static void Main()
    {
        // Get the current application domain for the current thread.
        AppDomain currentDomain = AppDomain.CurrentDomain;

        // Create a dynamic assembly in the current application domain,
        // and allow it to be executed and saved to disk.
        AssemblyName aName = new AssemblyName("TempAssembly");
        AssemblyBuilder ab = currentDomain.DefineDynamicAssembly(
            aName, AssemblyBuilderAccess.RunAndSave);

        // Define a dynamic module in "TempAssembly" assembly. For a single-
        // module assembly, the module has the same name as the assembly.
        ModuleBuilder mb = ab.DefineDynamicModule(aName.Name, aName.Name + ".dll");

        // Define a public enumeration with the name "Elevation" and an
        // underlying type of Integer.
        EnumBuilder eb = mb.DefineEnum("Elevation", TypeAttributes.Public, typeof(int));

        // Define two members, "High" and "Low".
        eb.DefineLiteral("Low", 0);
        eb.DefineLiteral("High", 1);

        // Create the type and save the assembly.
        Type finished = eb.CreateType();
        ab.Save(aName.Name + ".dll");

        foreach( object o in Enum.GetValues(finished) )
        {
            Console.WriteLine("{0}.{1} = {2}", finished, o, ((int) o));
        }
    }
}

/* This code example produces the following output:

Elevation.Low = 0
Elevation.High = 1
 */

Imports System.Reflection
Imports System.Reflection.Emit

Module Example
   
    Sub Main()
      
        ' Get the current application domain for the current thread.
        Dim currentDomain As AppDomain = AppDomain.CurrentDomain
      
        ' Create a dynamic assembly in the current application domain, 
        ' and allow it to be executed and saved to disk.
        Dim aName As AssemblyName = New AssemblyName("TempAssembly")
        Dim ab As AssemblyBuilder = currentDomain.DefineDynamicAssembly( _ 
            aName, AssemblyBuilderAccess.RunAndSave)
      
        ' Define a dynamic module in "TempAssembly" assembly. For a single-
        ' module assembly, the module has the same name as the assembly.
        Dim mb As ModuleBuilder = _
            ab.DefineDynamicModule(aName.Name, aName.Name & ".dll")
      
        ' Define a public enumeration with the name "Elevation" and an 
        ' underlying type of Integer.
        Dim eb As EnumBuilder = _
            mb.DefineEnum("Elevation", TypeAttributes.Public, GetType(Integer))
      
        ' Define two members, "High" and "Low".
        eb.DefineLiteral("Low", 0)
        eb.DefineLiteral("High", 1)

        ' Create the type and save the assembly.
        Dim finished As Type = eb.CreateType()
        ab.Save(aName.Name & ".dll")

        For Each o As Object In [Enum].GetValues(finished)
            Console.WriteLine("{0}.{1} = {2}", finished, o, CInt(o))
        Next
   End Sub
End Module

' This code example produces the following output:
'
'Elevation.Low = 0
'Elevation.High = 1

Remarques

L’énumération définie est une classe dérivée de Enum. Le value__ champ a Private et SpecialName les attributs définis.

Pour plus d’informations sur les types entiers intégrés qui peuvent être spécifiés en tant que types d’énumérations sous-jacents, consultez Vue d’ensemble de la bibliothèque de classes.

Note

Dans .NET Framework versions 1.0 et 1.1, il est nécessaire de définir des énumérations à l’aide de TypeBuilder, car EnumBuilder émet des énumérations dont les éléments sont de type Int32 au lieu du type d’énumération. Dans .NET Framework version 2.0, EnumBuilder émet des énumérations dont les éléments ont le type correct.