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)	動的アセンブリ内のモジュールを定義および表現します。