AssemblyBuilder.DefineDynamicModule Metode

Definisi

Ruang nama:

System.Reflection.Emit

Rakitan:

System.Reflection.Emit.dll

Mendefinisikan modul dinamis dalam rakitan ini.

Overload

DefineDynamicModule(String)

Mendefinisikan modul dinamis sementara bernama dalam rakitan ini.

DefineDynamicModule(String)

Sumber:

AssemblyBuilder.cs

Mendefinisikan modul dinamis sementara bernama dalam rakitan ini.

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

Parameter

name

String

Nama modul dinamis.

Mengembalikan

ModuleBuilder

ModuleBuilder yang mewakili modul dinamis yang ditentukan.

Pengecualian

ArgumentException

name dimulai dengan spasi kosong.

-atau-

Panjang name adalah nol.

-atau-

Panjang name lebih besar dari panjang maksimum yang ditentukan sistem.

-atau-

.NET Framework saja: Modul dengan name yang sama telah ditentukan dalam rakitan ini.

ArgumentNullException

name null.

InvalidOperationException

.NET Core dan .NET 5+ saja: Modul dinamis telah ditentukan dalam rakitan ini.

SecurityException

Pemanggil tidak memiliki izin yang diperlukan.

ExecutionEngineException

Rakitan untuk penulis simbol default tidak dapat dimuat.

-atau-

Tipe yang mengimplementasikan antarmuka penulis simbol default tidak dapat ditemukan.

Contoh

Contoh kode di bawah ini menunjukkan cara membuat modul dinamis sementara menggunakan 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")

Keterangan

Hanya .NET Core dan .NET 5+: rakitan Multi-modul tidak didukung. Hanya satu modul dinamis yang dapat didefinisikan dalam rakitan.

.NET Framework saja: Ini adalah kesalahan untuk menentukan beberapa modul dinamis dengan nama yang sama dalam rakitan.

Modul dinamis yang ditentukan bersifat sementara. Modul dinamis tidak disimpan, bahkan jika rakitan dinamis induk dibuat dengan RunAndSave.

Nota

Untuk menekan pengoptimalan saat men-debug modul dinamis, terapkan atribut DebuggableAttribute ke rakitan dinamis sebelum memanggil DefineDynamicModule. Buat instans DebuggableAttribute dengan bendera DisableOptimizations dan terapkan menggunakan metode SetCustomAttribute. Atribut harus diterapkan ke rakitan dinamis. Ini tidak berpengaruh jika diterapkan ke modul.

Nota

Dimulai dengan .NET Framework 2.0 Service Pack 1, anggota ini tidak lagi memerlukan ReflectionPermission dengan bendera ReflectionPermissionFlag.ReflectionEmit. (Lihat Masalah Keamanan dalam Pantulan.) Untuk menggunakan fungsionalitas ini, aplikasi Anda harus menargetkan .NET Framework 3.5 atau yang lebih baru.