ModuleBuilder クラス

定義

名前空間:

System.Reflection.Emit

アセンブリ:

System.Reflection.Emit.dll

ソース:

ModuleBuilder.cs

動的アセンブリ内のモジュールを定義して表します。

public ref class ModuleBuilder abstract : System::Reflection::Module

public abstract class ModuleBuilder : System.Reflection.Module

type ModuleBuilder = class
    inherit Module

Public MustInherit Class ModuleBuilder
Inherits Module

継承

Object

Module

ModuleBuilder

例

次のコード サンプルは、ModuleBuilder を使用して動的モジュールを作成する方法を示しています。 ModuleBuilder は、コンストラクターではなく、AssemblyBuilderで DefineDynamicModule を呼び出すことによって作成されることに注意してください。

using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
public ref class CodeGenerator
{
private:
   AssemblyBuilder^ myAssemblyBuilder;

public:
   CodeGenerator()
   {
      // Get the current application domain for the current thread.
      AppDomain^ myCurrentDomain = AppDomain::CurrentDomain;
      AssemblyName^ myAssemblyName = gcnew AssemblyName;
      myAssemblyName->Name = "TempAssembly";

      // Define a dynamic assembly in the current application domain.
      myAssemblyBuilder = myCurrentDomain->DefineDynamicAssembly( myAssemblyName, AssemblyBuilderAccess::Run );

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

      // Define a runtime class with specified name and attributes.
      TypeBuilder^ myTypeBuilder = myModuleBuilder->DefineType( "TempClass", TypeAttributes::Public );

      // Add 'Greeting' field to the class, with the specified attribute and type.
      FieldBuilder^ greetingField = myTypeBuilder->DefineField( "Greeting", String::typeid, FieldAttributes::Public );
      array<Type^>^myMethodArgs = {String::typeid};

      // Add 'MyMethod' method to the class, with the specified attribute and signature.
      MethodBuilder^ myMethod = myTypeBuilder->DefineMethod( "MyMethod", MethodAttributes::Public, CallingConventions::Standard, nullptr, myMethodArgs );
      ILGenerator^ methodIL = myMethod->GetILGenerator();
      methodIL->EmitWriteLine( "In the method..." );
      methodIL->Emit( OpCodes::Ldarg_0 );
      methodIL->Emit( OpCodes::Ldarg_1 );
      methodIL->Emit( OpCodes::Stfld, greetingField );
      methodIL->Emit( OpCodes::Ret );
      myTypeBuilder->CreateType();
   }

   property AssemblyBuilder^ MyAssembly 
   {
      AssemblyBuilder^ get()
      {
         return this->myAssemblyBuilder;
      }
   }
};

int main()
{
   CodeGenerator^ myCodeGenerator = gcnew CodeGenerator;

   // Get the assembly builder for 'myCodeGenerator' object.
   AssemblyBuilder^ myAssemblyBuilder = myCodeGenerator->MyAssembly;

   // Get the module builder for the above assembly builder object .
   ModuleBuilder^ myModuleBuilder = myAssemblyBuilder->GetDynamicModule( "TempModule" );
   Console::WriteLine( "The fully qualified name and path to this module is :{0}", myModuleBuilder->FullyQualifiedName );
   Type^ myType = myModuleBuilder->GetType( "TempClass" );
   MethodInfo^ myMethodInfo = myType->GetMethod( "MyMethod" );

   // Get the token used to identify the method within this module.
   MethodToken myMethodToken = myModuleBuilder->GetMethodToken( myMethodInfo );
   Console::WriteLine( "Token used to identify the method of 'myType'"
   " within the module is {0:x}", myMethodToken.Token );
   array<Object^>^args = {"Hello."};
   Object^ myObject = Activator::CreateInstance( myType, nullptr, nullptr );
   myMethodInfo->Invoke( myObject, args );
}

using System;
using System.Reflection;
using System.Reflection.Emit;
using System.Security.Permissions;

public class CodeGenerator
{
   AssemblyBuilder myAssemblyBuilder;
   public CodeGenerator()
   {
      // Get the current application domain for the current thread.
      AppDomain myCurrentDomain = AppDomain.CurrentDomain;
      AssemblyName myAssemblyName = new AssemblyName();
      myAssemblyName.Name = "TempAssembly";

      // Define a dynamic assembly in the current application domain.
      myAssemblyBuilder = myCurrentDomain.DefineDynamicAssembly
                     (myAssemblyName, AssemblyBuilderAccess.Run);

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

      // Define a runtime class with specified name and attributes.
      TypeBuilder myTypeBuilder = myModuleBuilder.DefineType
                                       ("TempClass",TypeAttributes.Public);

      // Add 'Greeting' field to the class, with the specified attribute and type.
      FieldBuilder greetingField = myTypeBuilder.DefineField("Greeting",
                                                            typeof(String), FieldAttributes.Public);
      Type[] myMethodArgs = { typeof(String) };

      // Add 'MyMethod' method to the class, with the specified attribute and signature.
      MethodBuilder myMethod = myTypeBuilder.DefineMethod("MyMethod",
         MethodAttributes.Public, CallingConventions.Standard, null,myMethodArgs);

      ILGenerator methodIL = myMethod.GetILGenerator();
      methodIL.EmitWriteLine("In the method...");
      methodIL.Emit(OpCodes.Ldarg_0);
      methodIL.Emit(OpCodes.Ldarg_1);
      methodIL.Emit(OpCodes.Stfld, greetingField);
      methodIL.Emit(OpCodes.Ret);
      myTypeBuilder.CreateType();
   }
   public AssemblyBuilder MyAssembly
   {
      get
      {
         return this.myAssemblyBuilder;
      }
   }
}
public class TestClass
{
   public static void Main()
   {
      CodeGenerator myCodeGenerator = new CodeGenerator();
      // Get the assembly builder for 'myCodeGenerator' object.
      AssemblyBuilder myAssemblyBuilder = myCodeGenerator.MyAssembly;
      // Get the module builder for the above assembly builder object .
      ModuleBuilder myModuleBuilder = myAssemblyBuilder.
                                                           GetDynamicModule("TempModule");
      Console.WriteLine("The fully qualified name and path to this "
                               + "module is :" +myModuleBuilder.FullyQualifiedName);
      Type myType = myModuleBuilder.GetType("TempClass");
      MethodInfo myMethodInfo =
                                                myType.GetMethod("MyMethod");
       // Get the token used to identify the method within this module.
      MethodToken myMethodToken =
                        myModuleBuilder.GetMethodToken(myMethodInfo);
      Console.WriteLine("Token used to identify the method of 'myType'"
                    + " within the module is {0:x}",myMethodToken.Token);
     object[] args={"Hello."};
     object myObject = Activator.CreateInstance(myType,null,null);
     myMethodInfo.Invoke(myObject,args);
   }
}

Imports System.Reflection
Imports System.Reflection.Emit
Imports System.Security.Permissions

Public Class CodeGenerator
   Private myAssemblyBuilder As AssemblyBuilder

   Public Sub New()
      ' Get the current application domain for the current thread.
      Dim myCurrentDomain As AppDomain = AppDomain.CurrentDomain
      Dim myAssemblyName As New AssemblyName()
      myAssemblyName.Name = "TempAssembly"

      ' Define a dynamic assembly in the current application domain.
      myAssemblyBuilder = _
               myCurrentDomain.DefineDynamicAssembly(myAssemblyName, AssemblyBuilderAccess.Run)

      ' Define a dynamic module in this assembly.
      Dim myModuleBuilder As ModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule")

      ' Define a runtime class with specified name and attributes.
      Dim myTypeBuilder As TypeBuilder = _
               myModuleBuilder.DefineType("TempClass", TypeAttributes.Public)

      ' Add 'Greeting' field to the class, with the specified attribute and type.
      Dim greetingField As FieldBuilder = _
               myTypeBuilder.DefineField("Greeting", GetType(String), FieldAttributes.Public)
      Dim myMethodArgs As Type() = {GetType(String)}

      ' Add 'MyMethod' method to the class, with the specified attribute and signature.
      Dim myMethod As MethodBuilder = _
               myTypeBuilder.DefineMethod("MyMethod", MethodAttributes.Public, _
               CallingConventions.Standard, Nothing, myMethodArgs)

      Dim methodIL As ILGenerator = myMethod.GetILGenerator()
      methodIL.EmitWriteLine("In the method...")
      methodIL.Emit(OpCodes.Ldarg_0)
      methodIL.Emit(OpCodes.Ldarg_1)
      methodIL.Emit(OpCodes.Stfld, greetingField)
      methodIL.Emit(OpCodes.Ret)
      myTypeBuilder.CreateType()
   End Sub

   Public ReadOnly Property MyAssembly() As AssemblyBuilder
      Get
         Return Me.myAssemblyBuilder
      End Get
   End Property
End Class

Public Class TestClass
   <PermissionSetAttribute(SecurityAction.Demand, Name:="FullTrust")> _
   Public Shared Sub Main()
      Dim myCodeGenerator As New CodeGenerator()
      ' Get the assembly builder for 'myCodeGenerator' object.
      Dim myAssemblyBuilder As AssemblyBuilder = myCodeGenerator.MyAssembly
      ' Get the module builder for the above assembly builder object .
      Dim myModuleBuilder As ModuleBuilder = myAssemblyBuilder.GetDynamicModule("TempModule")
      Console.WriteLine("The fully qualified name and path to this " + _
                        "module is :" + myModuleBuilder.FullyQualifiedName)
      Dim myType As Type = myModuleBuilder.GetType("TempClass")
      Dim myMethodInfo As MethodInfo = myType.GetMethod("MyMethod")
      ' Get the token used to identify the method within this module.
      Dim myMethodToken As MethodToken = myModuleBuilder.GetMethodToken(myMethodInfo)
      Console.WriteLine("Token used to identify the method of 'myType'" + _
                        " within the module is {0:x}", myMethodToken.Token)
      Dim args As Object() = {"Hello."}
      Dim myObject As Object = Activator.CreateInstance(myType, Nothing, Nothing)
      myMethodInfo.Invoke(myObject, args)
   End Sub
End Class

注釈

ModuleBuilderのインスタンスを取得するには、AssemblyBuilder.DefineDynamicModule メソッドを使用します。

コンストラクター

ModuleBuilder()

ModuleBuilder クラスの新しいインスタンスを初期化します。

プロパティ

Assembly	ModuleBuilderのこのインスタンスを定義した動的アセンブリを取得します。
CustomAttributes	このモジュールのカスタム属性を含むコレクションを取得します。 (継承元 Module)
FullyQualifiedName	このモジュールの完全修飾名とパスを表す String を取得します。
MDStreamVersion	メタデータ ストリームのバージョンを取得します。
MetadataToken	メタデータ内の現在の動的モジュールを識別するトークンを取得します。
ModuleHandle	モジュールのハンドルを取得します。 (継承元 Module)
ModuleVersionId	モジュールの 2 つのバージョンを区別するために使用できる汎用一意識別子 (UUID) を取得します。
Name	これがメモリ内モジュールであることを示す文字列。
ScopeName	動的モジュールの名前を表す文字列を取得します。

メソッド

CreateGlobalFunctions()	この動的モジュールのグローバル関数定義とグローバル データ定義を完了します。
CreateGlobalFunctionsCore()	派生クラスでオーバーライドされると、この動的モジュールのグローバル関数定義とグローバル データ定義が完了します。
DefineEnum(String, TypeAttributes, Type)	指定した型の value__ と呼ばれる単一の非静的フィールドを持つ値型である列挙型を定義します。
DefineEnumCore(String, TypeAttributes, Type)	派生クラスでオーバーライドされた場合、指定した型のvalue__と呼ばれる単一の非静的フィールドを持つ値型である列挙型を定義します。
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[])	指定した名前、属性、呼び出し規則、戻り値の型、およびパラメーター型を持つグローバル メソッドを定義します。
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])	指定した名前、属性、呼び出し規則、戻り値の型、戻り値の型のカスタム修飾子、パラメーター型、およびパラメーター型のカスタム修飾子を持つグローバル メソッドを定義します。
DefineGlobalMethod(String, MethodAttributes, Type, Type[])	指定した名前、属性、戻り値の型、およびパラメーター型を持つグローバル メソッドを定義します。
DefineGlobalMethodCore(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])	派生クラスでオーバーライドされると、指定した名前、属性、呼び出し規則、戻り値の型、戻り値の型のカスタム修飾子、パラメーター型、およびパラメーター型のカスタム修飾子を持つグローバル メソッドを定義します。
DefineInitializedData(String, Byte[], FieldAttributes)	ポータブル実行可能ファイル (PE) ファイルの .sdata セクションで初期化されたデータ フィールドを定義します。
DefineInitializedDataCore(String, Byte[], FieldAttributes)	派生クラスでオーバーライドされると、ポータブル実行可能ファイル (PE) ファイルの .sdata セクションで初期化されたデータ フィールドを定義します。
DefinePInvokeMethod(String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	指定した名前、メソッドが定義されている DLL の名前、メソッドの属性、メソッドの呼び出し規則、メソッドの戻り値の型、メソッドのパラメーターの型、および PInvoke フラグを使用して、PInvoke メソッドを定義します。
DefinePInvokeMethod(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	指定した名前、メソッドが定義されている DLL の名前、メソッドの属性、メソッドの呼び出し規則、メソッドの戻り値の型、メソッドのパラメーターの型、および PInvoke フラグを使用して、PInvoke メソッドを定義します。
DefinePInvokeMethodCore(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	派生クラスでオーバーライドされると、PInvoke メソッドを定義します。
DefineType(String)	このモジュールで指定した名前を持つプライベート型の TypeBuilder を構築します。
DefineType(String, TypeAttributes)	型名と型属性を指定して TypeBuilder を構築します。
DefineType(String, TypeAttributes, Type)	指定 TypeBuilder 型名、その属性、および定義された型が拡張する型を構築します。
DefineType(String, TypeAttributes, Type, Int32)	型名、属性、定義された型が拡張される型、および型の合計サイズを指定して、TypeBuilder を構築します。
DefineType(String, TypeAttributes, Type, PackingSize)	型名、属性、定義された型が拡張される型、および型のパッキング サイズを指定して、TypeBuilder を構築します。
DefineType(String, TypeAttributes, Type, PackingSize, Int32)	型名、属性、定義された型が拡張される型、定義された型のパッキング サイズ、および定義された型の合計サイズを指定して、TypeBuilder を構築します。
DefineType(String, TypeAttributes, Type, Type[])	型名、属性、定義された型が拡張される型、および定義された型が実装するインターフェイスを指定して、TypeBuilder を構築します。
DefineTypeCore(String, TypeAttributes, Type, Type[], PackingSize, Int32)	派生クラスでオーバーライドされると、TypeBuilderを構築します。
DefineUninitializedData(String, Int32, FieldAttributes)	ポータブル実行可能ファイル (PE) ファイルの .sdata セクションに初期化されていないデータ フィールドを定義します。
DefineUninitializedDataCore(String, Int32, FieldAttributes)	派生クラスでオーバーライドされると、ポータブル実行可能ファイル (PE) ファイルの .sdata セクションで初期化されていないデータ フィールドを定義します。
Equals(Object)	このインスタンスが指定したオブジェクトと等しいかどうかを示す値を返します。
FindTypes(TypeFilter, Object)	指定されたフィルター条件とフィルター条件で受け入れられるクラスの配列を返します。 (継承元 Module)
GetArrayMethod(Type, String, CallingConventions, Type, Type[])	配列クラスの名前付きメソッドを返します。
GetArrayMethodCore(Type, String, CallingConventions, Type, Type[])	派生クラスでオーバーライドされると、配列クラスの名前付きメソッドを返します。
GetCustomAttributes(Boolean)	現在の ModuleBuilderに適用されているすべてのカスタム属性を返します。
GetCustomAttributes(Type, Boolean)	現在の ModuleBuilderに適用され、指定した属性型から派生したすべてのカスタム属性を返します。
GetCustomAttributesData()	現在の ModuleBuilderに適用されている属性に関する情報 CustomAttributeData 返します。
GetField(String)	指定した名前のフィールドを返します。 (継承元 Module)
GetField(String, BindingFlags)	指定した名前とバインド属性を持つ、ポータブル実行可能ファイル (PE) ファイルの .sdata 領域で定義されているモジュール レベルのフィールドを返します。
GetFieldMetadataToken(FieldInfo)	派生クラスでオーバーライドされると、Module を基準にして、指定された FieldInfo のメタデータ トークンを返します。
GetFields()	モジュールで定義されているグローバル フィールドを返します。 (継承元 Module)
GetFields(BindingFlags)	指定したバインド フラグに一致するポータブル実行可能 (PE) ファイルの .sdata 領域で定義されているすべてのフィールドを返します。
GetHashCode()	このインスタンスのハッシュ コードを返します。
GetMethod(String)	指定した名前のメソッドを返します。 (継承元 Module)
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	指定した名前、バインディング情報、呼び出し規則、およびパラメーターの型と修飾子を持つメソッドを返します。 (継承元 Module)
GetMethod(String, Type[])	指定した名前とパラメーター型を持つメソッドを返します。 (継承元 Module)
GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	指定した条件に一致するモジュール レベルのメソッドを返します。
GetMethodMetadataToken(ConstructorInfo)	派生クラスでオーバーライドされると、Module を基準にして、指定された ConstructorInfo のメタデータ トークンを返します。
GetMethodMetadataToken(MethodInfo)	派生クラスでオーバーライドされると、Module を基準にして、指定された MethodInfo のメタデータ トークンを返します。
GetMethods()	モジュールで定義されているグローバル メソッドを返します。 (継承元 Module)
GetMethods(BindingFlags)	現在の ModuleBuilderのモジュール レベルで定義され、指定されたバインド フラグに一致するすべてのメソッドを返します。
GetObjectData(SerializationInfo, StreamingContext)	古い. シリアル化されたオブジェクトの ISerializable 実装を提供します。 (継承元 Module)
GetPEKind(PortableExecutableKinds, ImageFileMachine)	モジュール内のコードの性質と、モジュールの対象となるプラットフォームを示す値のペアを取得します。
GetSignatureMetadataToken(SignatureHelper)	派生クラスでオーバーライドされると、Module を基準にして、指定された SignatureHelper のメタデータ トークンを返します。
GetSignerCertificate()	このモジュールが属するアセンブリの Authenticode 署名に含まれる証明書に対応する X509Certificate オブジェクトを返します。 アセンブリが Authenticode 署名されていない場合は、null が返されます。 (継承元 Module)
GetStringMetadataToken(String)	派生クラスでオーバーライドされた場合は、Module を基準にして、指定された String 定数のメタデータ トークンを返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
GetType(String)	モジュールで定義されている名前付き型を取得します。
GetType(String, Boolean)	必要に応じて型名の大文字と小文字を区別しないで、モジュールで定義されている名前付き型を取得します。
GetType(String, Boolean, Boolean)	必要に応じて型名の大文字と小文字を区別しないで、モジュールで定義されている名前付き型を取得します。 必要に応じて、型が見つからない場合に例外をスローします。
GetTypeMetadataToken(Type)	派生クラスでオーバーライドされると、Module を基準にして、指定された Type のメタデータ トークンを返します。
GetTypes()	このモジュール内で定義されているすべてのクラスを返します。
IsDefined(Type, Boolean)	指定した属性型がこのモジュールに適用されているかどうかを示す値を返します。
IsResource()	オブジェクトがリソースであるかどうかを示す値を取得します。
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
ResolveField(Int32)	指定したメタデータ トークンによって識別されるフィールドを返します。 (継承元 Module)
ResolveField(Int32, Type[], Type[])	指定したジェネリック型パラメーターによって定義されたコンテキストで、指定したメタデータ トークンによって識別されるフィールドを返します。
ResolveMember(Int32)	指定したメタデータ トークンによって識別される型またはメンバーを返します。 (継承元 Module)
ResolveMember(Int32, Type[], Type[])	指定したジェネリック型パラメーターによって定義されたコンテキストで、指定したメタデータ トークンによって識別される型またはメンバーを返します。
ResolveMethod(Int32)	指定したメタデータ トークンによって識別されるメソッドまたはコンストラクターを返します。 (継承元 Module)
ResolveMethod(Int32, Type[], Type[])	指定したジェネリック型パラメーターによって定義されたコンテキストで、指定したメタデータ トークンによって識別されるメソッドまたはコンストラクターを返します。
ResolveSignature(Int32)	メタデータ トークンによって識別される署名 BLOB を返します。
ResolveString(Int32)	指定したメタデータ トークンによって識別される文字列を返します。
ResolveType(Int32)	指定したメタデータ トークンによって識別される型を返します。 (継承元 Module)
ResolveType(Int32, Type[], Type[])	指定したジェネリック型パラメーターによって定義されたコンテキストで、指定したメタデータ トークンによって識別される型を返します。
SetCustomAttribute(ConstructorInfo, Byte[])	属性を表す指定されたバイナリ ラージ オブジェクト (BLOB) を使用して、このモジュールにカスタム属性を適用します。
SetCustomAttribute(CustomAttributeBuilder)	カスタム属性ビルダーを使用して、このモジュールにカスタム属性を適用します。
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	派生クラスでオーバーライドされた場合は、このアセンブリにカスタム属性を設定します。
ToString()	モジュールの名前を返します。 (継承元 Module)

拡張メソッド

GetCustomAttribute(Module, Type)	指定したモジュールに適用される、指定した型のカスタム属性を取得します。
GetCustomAttribute<T>(Module)	指定したモジュールに適用される、指定した型のカスタム属性を取得します。
GetCustomAttributes(Module)	指定したモジュールに適用されるカスタム属性のコレクションを取得します。
GetCustomAttributes(Module, Type)	指定したモジュールに適用される、指定した型のカスタム属性のコレクションを取得します。
GetCustomAttributes<T>(Module)	指定したモジュールに適用される、指定した型のカスタム属性のコレクションを取得します。
IsDefined(Module, Type)	指定した型のカスタム属性が指定したモジュールに適用されるかどうかを示します。
GetModuleVersionId(Module)	動的アセンブリ内のモジュールを定義して表します。
HasModuleVersionId(Module)	動的アセンブリ内のモジュールを定義して表します。