ModuleBuilder.DefineEnum メソッド

.NET Framework クラス ライブラリ リファレンス

ModuleBuilder.DefineEnum メソッド

指定した型の value__ という単一の非静的フィールドを持つ値型と共に列挙型を定義します。

名前空間: System.Reflection.Emit
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As ModuleBuilder
Dim name As String
Dim visibility As TypeAttributes
Dim underlyingType As Type
Dim returnValue As EnumBuilder

returnValue = instance.DefineEnum(name, visibility, underlyingType)

C#

public EnumBuilder DefineEnum (
    string name,
    TypeAttributes visibility,
    Type underlyingType
)

C++

public:
EnumBuilder^ DefineEnum (
    String^ name, 
    TypeAttributes visibility, 
    Type^ underlyingType
)

J#

public EnumBuilder DefineEnum (
    String name, 
    TypeAttributes visibility, 
    Type underlyingType
)

JScript

public function DefineEnum (
    name : String, 
    visibility : TypeAttributes, 
    underlyingType : Type
) : EnumBuilder

パラメータ

name

列挙型の完全パス。name には埋め込み null を含めることができません。

visibility

列挙型の型属性。属性は、VisibilityMask で定義された任意のビットです。

underlyingType

列挙型の基になる型。

戻り値
定義された列挙型を返します。

例外

例外の種類	条件
ArgumentException	可視属性以外の属性が指定されています。 または 指定された名前の列挙型 (Enum) が、このモジュールの親アセンブリに存在します。 または 列挙型 (Enum) のスコープに対して可視属性が正しくありません。たとえば、NestedPublic がvisibility として指定されていて、列挙型 (Enum) が入れ子にされた型ではありません。
ArgumentNullException	name が null 参照 (Visual Basic では Nothing) です。

解説

定義された列挙型 (Enum) は Enum の派生クラスです。定義されたフィールドには、Private と SpecialName が設定されています。

使用例

次のコード例は、DefineEnum を使用して、動的モジュールの中に列挙体クラスを実装する方法を示しています。

Visual Basic

Dim currentDomain As AppDomain
Dim myAssemblyName As AssemblyName

' Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain

' Create assembly in current currentDomain
myAssemblyName = New AssemblyName()
myAssemblyName.Name = "TempAssembly"

' Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = currentDomain.DefineDynamicAssembly _ 
                    (myAssemblyName, AssemblyBuilderAccess.Run)

' Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule")

' Define a enumeration type with name 'MyEnum' in the 'TempModule'.
Dim myEnumBuilder As EnumBuilder = myModuleBuilder.DefineEnum
 _ 
                                   ("MyEnum", TypeAttributes.Public,
 GetType(Integer))

' Define the named static fields in the enumeration type 'MyEnum'.
myEnumBuilder.DefineLiteral("MyEnumMember1", 2)
myEnumBuilder.DefineLiteral("MyEnumMember2", 3)
myEnumBuilder.CreateType()

C#

AppDomain currentDomain;
AssemblyName myAssemblyName;

// Get the current application domain for the current thread.
currentDomain = AppDomain.CurrentDomain;

// Create assembly in current currentDomain
myAssemblyName = new AssemblyName();
myAssemblyName.Name = "TempAssembly";

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = 
   currentDomain.DefineDynamicAssembly
               (myAssemblyName, AssemblyBuilderAccess.Run);

// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule");

// Define a enumeration type with name 'MyEnum' in the 'TempModule'.
EnumBuilder myEnumBuilder = myModuleBuilder.DefineEnum("MyEnum",
                     TypeAttributes.Public,typeof(int));

// Define the named static fields in the enumeration type 'MyEnum'.
myEnumBuilder.DefineLiteral("MyEnumMember1",2);
myEnumBuilder.DefineLiteral("MyEnumMember2",3);
myEnumBuilder.CreateType();

C++

AppDomain^ currentDomain;
AssemblyName^ myAssemblyName;

// Get the current application domain for the current thread.
currentDomain = AppDomain::CurrentDomain;

// Create assembly in current currentDomain
myAssemblyName = gcnew AssemblyName;
myAssemblyName->Name = "TempAssembly";

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder =
   currentDomain->DefineDynamicAssembly(
      myAssemblyName, AssemblyBuilderAccess::Run );

// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder->DefineDynamicModule( "TempModule"
 );

// Define a enumeration type with name 'MyEnum' in the 'TempModule'.
EnumBuilder^ myEnumBuilder = myModuleBuilder->DefineEnum( "MyEnum",
   TypeAttributes::Public, int::typeid );

// Define the named static fields in the enumeration type 'MyEnum'.
myEnumBuilder->DefineLiteral( "MyEnumMember1", 2 );
myEnumBuilder->DefineLiteral( "MyEnumMember2", 3 );
myEnumBuilder->CreateType();

J#

AppDomain currentDomain;
AssemblyName myAssemblyName;

// Get the current application domain for the current thread.
currentDomain = AppDomain.get_CurrentDomain();

// Create assembly in current currentDomain
myAssemblyName = new AssemblyName();
myAssemblyName.set_Name("TempAssembly");

// Define a dynamic assembly in the 'currentDomain'.
myAssemblyBuilder = currentDomain.DefineDynamicAssembly(myAssemblyName,
    AssemblyBuilderAccess.Run);

// Define a dynamic module in "TempAssembly" assembly.
myModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule");

// Define a enumeration type with name 'MyEnum' in the 'TempModule'.
EnumBuilder myEnumBuilder = myModuleBuilder.DefineEnum("MyEnum", 
    TypeAttributes.Public, int.class.ToType());

// Define the named static fields in the enumeration type 'MyEnum'.
myEnumBuilder.DefineLiteral("MyEnumMember1", (Int32)2);
myEnumBuilder.DefineLiteral("MyEnumMember2", (Int32)3);
myEnumBuilder.CreateType();

.NET Framework のセキュリティ

• ReflectionPermission  (動的コードを出力するために必要なアクセス許可)ReflectionPermissionFlag.ReflectionEmit (関連する列挙体)

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ModuleBuilder クラス
ModuleBuilder メンバ
System.Reflection.Emit 名前空間