AssemblyBuilder.DefineDynamicModule Metoda

Definice

Obor názvů:

System.Reflection.Emit

Sestavení:

System.Reflection.Emit.dll

Definuje dynamický modul v tomto sestavení.

Přetížení

DefineDynamicModule(String)

Definuje pojmenovaný přechodný dynamický modul v tomto sestavení.

DefineDynamicModule(String)

Zdroj:

AssemblyBuilder.cs

Definuje pojmenovaný přechodný dynamický modul v tomto sestavení.

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

Název dynamického modulu.

Návraty

ModuleBuilder

ModuleBuilder představující definovaný dynamický modul.

Výjimky

ArgumentException

name začíná prázdným znakem.

-nebo-

Délka name je nula.

-nebo-

Délka name je větší než maximální délka definovaná systémem.

-nebo-

Pouze rozhraní .NET Framework: Modul se stejným name již byl v tomto sestavení definován.

ArgumentNullException

name je null.

InvalidOperationException

Pouze .NET Core a .NET 5+: Dynamický modul již byl v tomto sestavení definován.

SecurityException

Volající nemá požadované oprávnění.

ExecutionEngineException

Sestavení pro výchozí zapisovač symbolů nelze načíst.

-nebo-

Typ, který implementuje výchozí rozhraní pro zápis symbolů, nelze najít.

Příklady

Následující příklad kódu ukazuje, jak vytvořit přechodný dynamický modul pomocí 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")

Poznámky

Pouze .NET Core a .NET 5+: sestavení s více moduly nejsou podporována. V sestavení může být definován pouze jeden dynamický modul.

Pouze rozhraní .NET Framework: Jedná se o chybu při definování více dynamických modulů se stejným názvem v sestavení.

Definovaný dynamický modul je přechodný. Dynamický modul není uložen, i když bylo vytvořeno nadřazené dynamické sestavení s RunAndSave.

Poznámka

Chcete-li potlačit optimalizace při ladění dynamických modulů, před voláním DefineDynamicModulepoužijte atribut DebuggableAttribute na dynamické sestavení . Vytvořte instanci DebuggableAttribute s příznakem DisableOptimizations a použijte ji pomocí metody SetCustomAttribute. Atribut musí být použit pro dynamické sestavení. Nemá žádný vliv, pokud se použije na modul.

Poznámka

Počínaje aktualizací Service Pack 1 rozhraní .NET Framework 2.0 už tento člen nevyžaduje ReflectionPermission s příznakem ReflectionPermissionFlag.ReflectionEmit. (Viz problémy se zabezpečením vgenerování reflexe.) Pokud chcete tuto funkci použít, měla by vaše aplikace cílit na rozhraní .NET Framework 3.5 nebo novější.