AssemblyBuilder.DefineDynamicModule Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Define um módulo dinâmico neste assembly.
Sobrecargas
DefineDynamicModule(String) |
Define um módulo dinâmico transitório nomeado nesse assembly. |
DefineDynamicModule(String, Boolean) |
Define o módulo dinâmico transitório nomeado neste assembly e especifica se as informações de símbolo devem ser emitidas. |
DefineDynamicModule(String, String) |
Define um módulo dinâmico persistente com o nome fornecido que será salvo no arquivo especificado. Nenhuma informação de símbolo é emitida. |
DefineDynamicModule(String, String, Boolean) |
Define um módulo dinâmico persistente, especificando o nome do módulo, o nome do arquivo no qual o módulo será salvo e se as informações de símbolo deverão ser emitidas usando o gravador de símbolo padrão. |
DefineDynamicModule(String)
- Origem:
- AssemblyBuilder.cs
- Origem:
- AssemblyBuilder.cs
- 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
Um ModuleBuilder que representa o módulo dinâmico definido.
Exceções
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.
name
é null
.
O chamador não tem a permissão necessária.
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. Create uma instância do DebuggableAttribute com o sinalizador e aplique-o 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.
Aplica-se a
DefineDynamicModule(String, Boolean)
Define o módulo dinâmico transitório nomeado neste assembly e especifica se as informações de símbolo devem ser emitidas.
public:
System::Reflection::Emit::ModuleBuilder ^ DefineDynamicModule(System::String ^ name, bool emitSymbolInfo);
public System.Reflection.Emit.ModuleBuilder DefineDynamicModule (string name, bool emitSymbolInfo);
member this.DefineDynamicModule : string * bool -> System.Reflection.Emit.ModuleBuilder
Public Function DefineDynamicModule (name As String, emitSymbolInfo As Boolean) As ModuleBuilder
Parâmetros
- name
- String
O nome do módulo dinâmico.
- emitSymbolInfo
- Boolean
true
se as informações de símbolo devem ser emitidas; caso contrário, false
.
Retornos
Um ModuleBuilder que representa o módulo dinâmico definido.
Exceções
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.
name
é null
.
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.
O chamador não tem a permissão necessária.
Exemplos
O exemplo de código abaixo demonstra como criar um módulo dinâmico transitório usando DefineDynamicModule
, suprimindo informações de símbolo.
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 can not be saved. By specifying the second parameter
// of the constructor as false, we can suppress the emission of symbol info.
ModuleBuilder^ myModuleBuilder = myAsmBuilder->DefineDynamicModule(
"MyModule2", false );
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. By specifying the second parameter
// of the constructor as false, we can suppress the emission of symbol info.
ModuleBuilder myModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule2",
false);
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. By specifying the second parameter
' of the constructor as false, we can suppress the emission of symbol info.
Dim myModuleBuilder As ModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule2", _
False)
Comentários
É um erro definir vários módulos dinâmicos com o mesmo nome em um assembly.
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. Create uma instância do DebuggableAttribute com o sinalizador e aplique-o 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.
Aplica-se a
DefineDynamicModule(String, String)
Define um módulo dinâmico persistente com o nome fornecido que será salvo no arquivo especificado. Nenhuma informação de símbolo é emitida.
public:
System::Reflection::Emit::ModuleBuilder ^ DefineDynamicModule(System::String ^ name, System::String ^ fileName);
public System.Reflection.Emit.ModuleBuilder DefineDynamicModule (string name, string fileName);
member this.DefineDynamicModule : string * string -> System.Reflection.Emit.ModuleBuilder
Public Function DefineDynamicModule (name As String, fileName As String) As ModuleBuilder
Parâmetros
- name
- String
O nome do módulo dinâmico.
- fileName
- String
O nome do arquivo no qual o módulo dinâmico deve ser salvo.
Retornos
Um objeto ModuleBuilder que representa o módulo dinâmico definido.
Exceções
name
ou fileName
é null
.
O comprimento de name
ou fileName
é zero.
- ou -
O comprimento de name
é maior que o comprimento máximo definido pelo sistema.
- ou -
fileName
contém uma especificação de caminho (um componente de diretório, por exemplo).
- ou -
Há um conflito com o nome de outro arquivo que pertence a este assembly.
Este assembly foi salvo anteriormente.
Este assembly foi chamado em um assembly dinâmico com o atributo Run.
O chamador não tem a permissão necessária.
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 persistente usando DefineDynamicModule
.
AppDomain^ myAppDomain = Thread::GetDomain();
AssemblyName^ myAsmName = gcnew AssemblyName;
myAsmName->Name = "MyAssembly";
AssemblyBuilder^ myAsmBuilder = myAppDomain->DefineDynamicAssembly(
myAsmName, AssemblyBuilderAccess::Run );
// Create a dynamic module that can be saved as the specified DLL name.
ModuleBuilder^ myModuleBuilder = myAsmBuilder->DefineDynamicModule(
"MyModule3", "MyModule3.dll" );
AppDomain myAppDomain = Thread.GetDomain();
AssemblyName myAsmName = new AssemblyName();
myAsmName.Name = "MyAssembly";
AssemblyBuilder myAsmBuilder = myAppDomain.DefineDynamicAssembly(
myAsmName,
AssemblyBuilderAccess.Run);
// Create a dynamic module that can be saved as the specified DLL name.
ModuleBuilder myModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule3",
"MyModule3.dll");
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 dynamic module that can be saved as the specified DLL name.
Dim myModuleBuilder As ModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule3", _
"MyModule3.dll")
Comentários
Para definir um módulo dinâmico persistente, esse assembly precisa ser criado com o SaveRunAndSave atributo ou .
Se você quiser que o módulo contenha o manifesto do assembly, name
deve ser o mesmo que o nome do assembly (ou seja, a AssemblyName.Name propriedade do AssemblyName usado para criar o assembly dinâmico) e fileName
deve ser o mesmo que o nome de arquivo especificado ao salvar o assembly.
Em um assembly com apenas um módulo, esse módulo deve conter o manifesto do assembly.
Observação
Para suprimir otimizações ao depurar módulos dinâmicos, aplique o DebuggableAttribute atributo ao assembly dinâmico antes de chamar DefineDynamicModule. Create uma instância do DebuggableAttribute com o sinalizador e aplique-o 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.
Aplica-se a
DefineDynamicModule(String, String, Boolean)
Define um módulo dinâmico persistente, especificando o nome do módulo, o nome do arquivo no qual o módulo será salvo e se as informações de símbolo deverão ser emitidas usando o gravador de símbolo padrão.
public:
System::Reflection::Emit::ModuleBuilder ^ DefineDynamicModule(System::String ^ name, System::String ^ fileName, bool emitSymbolInfo);
public System.Reflection.Emit.ModuleBuilder DefineDynamicModule (string name, string fileName, bool emitSymbolInfo);
member this.DefineDynamicModule : string * string * bool -> System.Reflection.Emit.ModuleBuilder
Public Function DefineDynamicModule (name As String, fileName As String, emitSymbolInfo As Boolean) As ModuleBuilder
Parâmetros
- name
- String
O nome do módulo dinâmico.
- fileName
- String
O nome do arquivo no qual o módulo dinâmico deve ser salvo.
- emitSymbolInfo
- Boolean
Se true
, as informações simbólicas serão gravadas usando o gravador de símbolo padrão.
Retornos
Um objeto ModuleBuilder que representa o módulo dinâmico definido.
Exceções
name
ou fileName
é null
.
O comprimento de name
ou fileName
é zero.
- ou -
O comprimento de name
é maior que o comprimento máximo definido pelo sistema.
- ou -
fileName
contém uma especificação de caminho (um componente de diretório, por exemplo).
- ou -
Há um conflito com o nome de outro arquivo que pertence a este assembly.
Este assembly foi salvo anteriormente.
Este assembly foi chamado em um assembly dinâmico com o atributo Run.
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.
O chamador não tem a permissão necessária.
Exemplos
O exemplo de código abaixo demonstra como criar um módulo dinâmico persistente com emissão de símbolo usando DefineDynamicModule
.
AppDomain^ myAppDomain = Thread::GetDomain();
AssemblyName^ myAsmName = gcnew AssemblyName;
myAsmName->Name = "MyAssembly";
AssemblyBuilder^ myAsmBuilder = myAppDomain->DefineDynamicAssembly(
myAsmName, AssemblyBuilderAccess::Run );
// Create a dynamic module that can be saved as the specified DLL name. By
// specifying the third parameter as true, we can allow the emission of symbol info.
ModuleBuilder^ myModuleBuilder = myAsmBuilder->DefineDynamicModule(
"MyModule4", "MyModule4.dll", true );
AppDomain myAppDomain = Thread.GetDomain();
AssemblyName myAsmName = new AssemblyName();
myAsmName.Name = "MyAssembly";
AssemblyBuilder myAsmBuilder = myAppDomain.DefineDynamicAssembly(
myAsmName,
AssemblyBuilderAccess.Run);
// Create a dynamic module that can be saved as the specified DLL name. By
// specifying the third parameter as true, we can allow the emission of symbol info.
ModuleBuilder myModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule4",
"MyModule4.dll",
true);
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 dynamic module that can be saved as the specified DLL name. By
' specifying the third parameter as true, we can allow the emission of symbol info.
Dim myModuleBuilder As ModuleBuilder = myAsmBuilder.DefineDynamicModule("MyModule4", _
"MyModule4.dll", _
True)
Comentários
Para definir um módulo dinâmico persistente, esse assembly precisa ser criado com o SaveRunAndSave atributo ou .
Se você quiser que o módulo contenha o manifesto do assembly, name
deve ser o mesmo que o nome do assembly (ou seja, a AssemblyName.Name propriedade do AssemblyName usado para criar o assembly dinâmico) e fileName
deve ser o mesmo que o nome de arquivo especificado ao salvar o assembly.
Em um assembly com apenas um módulo, esse módulo deve conter o manifesto do assembly.
Observação
Para suprimir otimizações ao depurar módulos dinâmicos, aplique o DebuggableAttribute atributo ao assembly dinâmico antes de chamar DefineDynamicModule. Create uma instância do DebuggableAttribute com o sinalizador e aplique-o 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.
Aplica-se a
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de