AssemblyBuilder.DefineDynamicModule Método

Definição

Namespace:

System.Reflection.Emit

Assembly:

System.Reflection.Emit.dll

Define um módulo dinâmico neste assembly.

Sobrecargas

DefineDynamicModule(String)

Define um módulo dinâmico transitório nomeado nesse assembly.

DefineDynamicModule(String)

Origem:

AssemblyBuilder.cs

Define um módulo dinâmico transitório nomeado nesse 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

Parâmetros

name

String

O nome do módulo dinâmico.

Retornos

ModuleBuilder

Um ModuleBuilder que representa o módulo dinâmico definido.

Exceções

ArgumentException

name começa com um espaço em branco.

- ou -

O comprimento de name é zero.

- ou -

O comprimento de name é maior que o comprimento máximo definido pelo sistema.

ArgumentNullException

name é null.

SecurityException

O chamador não tem a permissão necessária.

ExecutionEngineException

Não é possível carregar o assembly para o gravador de símbolo padrão.

- ou -

Não foi possível encontrar o tipo que implementa a interface do gravador de símbolo padrão.

Exemplos

O exemplo de código abaixo demonstra como criar um módulo dinâmico transitório usando 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")

Comentários

É um erro definir vários módulos dinâmicos com o mesmo nome em um assembly.

O módulo dinâmico definido é transitório. O módulo dinâmico não é salvo, mesmo que o assembly dinâmico pai tenha sido criado com RunAndSave.

Observação

Para suprimir otimizações ao depurar módulos dinâmicos, aplique o DebuggableAttribute atributo ao assembly dinâmico antes de chamar DefineDynamicModule. Crie uma instância de DebuggableAttribute com o sinalizador e aplique-a DisableOptimizations usando o SetCustomAttribute método . O atributo deve ser aplicado ao assembly dinâmico. Ele não terá efeito se aplicado ao módulo.

Observação

A partir do .NET Framework 2.0 Service Pack 1, esse membro não requer ReflectionPermission mais com o ReflectionPermissionFlag.ReflectionEmit sinalizador . (Consulte Problemas de segurança na emissão de reflexão.) Para usar essa funcionalidade, seu aplicativo deve ter como destino o .NET Framework 3.5 ou posterior.