AssemblyBuilder.DefineDynamicModule Metoda

Definicja

Przestrzeń nazw:

System.Reflection.Emit

Zestaw:

System.Reflection.Emit.dll

Definiuje moduł dynamiczny w tym zestawie.

Przeciążenia

DefineDynamicModule(String)

Definiuje nazwany moduł dynamiczny przejściowy w tym zestawie.

DefineDynamicModule(String)

Źródło:

AssemblyBuilder.cs

Definiuje nazwany moduł dynamiczny przejściowy w tym zestawie.

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

Parametry

name

String

Nazwa modułu dynamicznego.

Zwraca

ModuleBuilder

ModuleBuilder reprezentujący zdefiniowany moduł dynamiczny.

Wyjątki

ArgumentException

name zaczyna się od białych znaków.

-lub-

Długość name wynosi zero.

-lub-

Długość name jest większa niż maksymalna długość zdefiniowana przez system.

-lub-

Tylko program .NET Framework: moduł z tym samym name został już zdefiniowany w tym zestawie.

ArgumentNullException

name jest null.

InvalidOperationException

Tylko platformy .NET Core i .NET 5+: moduł dynamiczny został już zdefiniowany w tym zestawie.

SecurityException

Obiekt wywołujący nie ma wymaganych uprawnień.

ExecutionEngineException

Nie można załadować zestawu domyślnego składnika zapisywania symboli.

-lub-

Nie można odnaleźć typu implementujący domyślny interfejs zapisywania symboli.

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć przejściowy moduł dynamiczny przy użyciu 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")

Uwagi

Tylko platformy .NET Core i .NET 5+: zestawy z wieloma modułami nie są obsługiwane. W zestawie można zdefiniować tylko jeden moduł dynamiczny.

Tylko program .NET Framework: Jest to błąd podczas definiowania wielu modułów dynamicznych o tej samej nazwie w zestawie.

Zdefiniowany moduł dynamiczny jest przejściowy. Moduł dynamiczny nie jest zapisywany, nawet jeśli nadrzędny zestaw dynamiczny został utworzony za pomocą RunAndSave.

Nuta

Aby pominąć optymalizacje podczas debugowania modułów dynamicznych, zastosuj atrybut DebuggableAttribute do zestawu dynamicznego przed wywołaniem DefineDynamicModule. Utwórz wystąpienie DebuggableAttribute z flagą DisableOptimizations i zastosuj je przy użyciu metody SetCustomAttribute. Atrybut należy zastosować do zestawu dynamicznego. Nie ma żadnego wpływu, jeśli zastosowano go do modułu.

Nuta

Począwszy od programu .NET Framework 2.0 z dodatkiem Service Pack 1, ten element członkowski nie wymaga już ReflectionPermission z flagą ReflectionPermissionFlag.ReflectionEmit. (Zobacz problemy z zabezpieczeniami wemisji odbicia). Aby korzystać z tej funkcji, aplikacja powinna być docelowa dla programu .NET Framework 3.5 lub nowszego.