AssemblyBuilder.DefineDynamicModule Méthode

Définition

Espace de noms:

System.Reflection.Emit

Assembly:

System.Reflection.Emit.dll

Définit un module dynamique dans cet assembly.

Surcharges

DefineDynamicModule(String)

Définit un module dynamique temporaire nommé dans cet assembly.

DefineDynamicModule(String)

Source:

AssemblyBuilder.cs

Définit un module dynamique temporaire nommé dans cet assembly.

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

Paramètres

name

String

Nom du module dynamique.

Retours

ModuleBuilder

Un ModuleBuilder représentant le module dynamique défini.

Exceptions

ArgumentException

name commence par un espace blanc.

-ou-

La longueur de name est égale à zéro.

-ou-

La longueur de name est supérieure à la longueur maximale définie par le système.

-ou-

.NET Framework uniquement : un module avec le même name a déjà été défini dans cet assembly.

ArgumentNullException

name est null.

InvalidOperationException

.NET Core et .NET 5+ uniquement : un module dynamique a déjà été défini dans cet assembly.

SecurityException

L’appelant n’a pas l’autorisation requise.

ExecutionEngineException

Impossible de charger l’assembly pour l’enregistreur de symboles par défaut.

-ou-

Le type qui implémente l’interface d’enregistreur de symboles par défaut est introuvable.

Exemples

L’exemple de code ci-dessous montre comment créer un module dynamique temporaire à l’aide de 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")

Remarques

.NET Core et .NET 5+ uniquement : assemblys multimodèles ne sont pas pris en charge. Un seul module dynamique peut être défini dans un assembly.

.NET Framework uniquement : il s’agit d’une erreur de définition de plusieurs modules dynamiques portant le même nom dans un assembly.

Le module dynamique défini est temporaire. Le module dynamique n’est pas enregistré, même si l’assembly dynamique parent a été créé avec RunAndSave.

Note

Pour supprimer les optimisations lors du débogage de modules dynamiques, appliquez l’attribut DebuggableAttribute à l’assembly dynamique avant d’appeler DefineDynamicModule. Créez une instance de DebuggableAttribute avec l’indicateur de DisableOptimizations et appliquez-la à l’aide de la méthode SetCustomAttribute. L’attribut doit être appliqué à l’assembly dynamique. Elle n’a aucun effet si elle est appliquée au module.

Note

À compter de .NET Framework 2.0 Service Pack 1, ce membre n’a plus besoin de ReflectionPermission avec l’indicateur de ReflectionPermissionFlag.ReflectionEmit. (Consultez problèmes de sécurité dans l’émission de réflexion.) Pour utiliser cette fonctionnalité, votre application doit cibler .NET Framework 3.5 ou version ultérieure.