AssemblyBuilder.DefineDynamicModule 方法

定义

命名空间:

System.Reflection.Emit

程序集:

System.Reflection.Emit.dll

在此程序集中定义动态模块。

重载

DefineDynamicModule(String)

在此程序集中定义一个命名的暂时性动态模块。

DefineDynamicModule(String)

Source:

AssemblyBuilder.cs

在此程序集中定义一个命名的暂时性动态模块。

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

参数

name

String

动态模块的名称。

返回

ModuleBuilder

表示定义的动态模块的 ModuleBuilder。

例外

ArgumentException

name 以空格开头。

-或-

name 的长度为零。

-或-

name 的长度大于系统定义的最大长度。

-或-

仅限 .NET Framework：此程序集中已定义具有相同 name 的模块。

ArgumentNullException

name null。

InvalidOperationException

仅限 .NET Core 和 .NET 5+ ：此程序集中已定义动态模块。

SecurityException

调用方没有所需的权限。

ExecutionEngineException

无法加载默认符号编写器的程序集。

-或-

找不到实现默认符号编写器接口的类型。

示例

下面的代码示例演示如何使用 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")

注解

仅 .NET Core 和 .NET 5+ ：不支持 多模块程序集。 程序集中只能定义一个动态模块。

仅限 .NET Framework：定义程序集中同名的多个动态模块是错误的。

定义的动态模块是暂时性的。 即使使用 RunAndSave创建父动态程序集，也不会保存动态模块。

注意

若要在调试动态模块时取消优化，在调用 DefineDynamicModule之前，将 DebuggableAttribute 属性应用于动态程序集。 使用 DisableOptimizations 标志创建 DebuggableAttribute 实例，并使用 SetCustomAttribute 方法应用它。 该属性必须应用于动态程序集。 如果应用于模块，则不起作用。

注意

从 .NET Framework 2.0 Service Pack 1 开始，此成员不再需要具有 ReflectionPermissionFlag.ReflectionEmit 标志 ReflectionPermission。 （请参阅反射发出中的 安全问题。若要使用此功能，应用程序应面向 .NET Framework 3.5 或更高版本。