AssemblyBuilder.DefineDynamicModule メソッド

定義

名前空間:

System.Reflection.Emit

アセンブリ:

System.Reflection.Emit.dll

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

オーバーロード

DefineDynamicModule(String)

このアセンブリの名前付き一時的な動的モジュールを定義します。

DefineDynamicModule(String)

ソース:

AssemblyBuilder.cs

このアセンブリの名前付き一時的な動的モジュールを定義します。

public:
 System::Reflection::Emit::ModuleBuilder ^ DefineDynamicModule(System::String ^ name);

public System.Reflection.Emit.ModuleBuilder DefineDynamicModule (string name);

member this.DefineDynamicModule : string -> System.Reflection.Emit.ModuleBuilder

Public Function DefineDynamicModule (name As String) As ModuleBuilder

パラメーター

name

String

動的モジュールの名前。

戻り値

ModuleBuilder

定義された動的モジュールを表す ModuleBuilder。

例外

ArgumentException

name は空白で始まります。

-又は-

name の長さは 0 です。

-又は-

name の長さがシステム定義の最大長を超えています。

-又は-

.NET Framework のみ: 同じ name を持つモジュールがこのアセンブリで既に定義されています。

ArgumentNullException

name は nullです。

InvalidOperationException

.NET Core と .NET 5 以降のみ: このアセンブリには動的モジュールが既に定義されています。

SecurityException

呼び出し元に必要なアクセス許可がありません。

ExecutionEngineException

既定のシンボル ライターのアセンブリを読み込むことができません。

-又は-

既定のシンボル ライター インターフェイスを実装する型が見つかりません。

例

次のコード例は、DefineDynamicModuleを使用して一時的な動的モジュールを作成する方法を示しています。

AppDomain^ myAppDomain = Thread::GetDomain();
AssemblyName^ myAsmName = gcnew AssemblyName;
myAsmName->Name = "MyAssembly";
AssemblyBuilder^ myAsmBuilder = myAppDomain->DefineDynamicAssembly(
   myAsmName, AssemblyBuilderAccess::Run );

// Create a transient dynamic module. Since no DLL name is specified with
// this constructor, it cannot be saved.
ModuleBuilder^ myModuleBuilder = myAsmBuilder->DefineDynamicModule( "MyModule1" );

AppDomain myAppDomain = Thread.GetDomain();
AssemblyName myAsmName = new AssemblyName();
myAsmName.Name = "MyAssembly";
AssemblyBuilder myAsmBuilder = myAppDomain.DefineDynamicAssembly(
                     myAsmName,
                     AssemblyBuilderAccess.Run);

// Create a transient dynamic module. Since no DLL name is specified with
// this constructor, it can not be saved.
ModuleBuilder myModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule1");

Dim myAppDomain As AppDomain = Thread.GetDomain()
Dim myAsmName As New AssemblyName()
myAsmName.Name = "MyAssembly"
Dim myAsmBuilder As AssemblyBuilder = myAppDomain.DefineDynamicAssembly(myAsmName, _
                      AssemblyBuilderAccess.Run)

' Create a transient dynamic module. Since no DLL name is specified with
' this constructor, it can not be saved. 
Dim myModuleBuilder As ModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule1")

注釈

.NET Core および .NET 5 以降のみ: マルチモジュール アセンブリは、サポートされていません。 1 つのアセンブリで定義できる動的モジュールは 1 つだけです。

.NET Framework のみ: アセンブリ内で同じ名前を持つ複数の動的モジュールを定義するとエラーになります。

定義された動的モジュールは一時的なものです。 親動的アセンブリが RunAndSaveで作成された場合でも、動的モジュールは保存されません。

手記

動的モジュールのデバッグ時に最適化を抑制するには、DefineDynamicModuleを呼び出す前に、動的アセンブリに DebuggableAttribute 属性を適用します。 DisableOptimizations フラグを使用して DebuggableAttribute のインスタンスを作成し、SetCustomAttribute メソッドを使用して適用します。 この属性は動的アセンブリに適用する必要があります。 モジュールに適用しても効果はありません。

手記

.NET Framework 2.0 Service Pack 1 以降では、このメンバーは ReflectionPermissionFlag.ReflectionEmit フラグで ReflectionPermission する必要がなくなりました。 (リフレクション出力のセキュリティの問題 を参照してください)。この機能を使用するには、アプリケーションで .NET Framework 3.5 以降をターゲットにする必要があります。