AssemblyBuilder.DefineDynamicModule 方法

定義

命名空間:

System.Reflection.Emit

組件:

System.Reflection.Emit.dll

在此元件中定義動態模組。

多載

DefineDynamicModule(String)

在此元件中定義具名的暫時性動態模組。

DefineDynamicModule(String)

來源:

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 或更新版本為目標。