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 길이는 0입니다.

-또는-

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 서비스 팩 1부터 이 멤버는 더 이상 ReflectionPermissionFlag.ReflectionEmit 플래그를 사용하여 ReflectionPermission 필요가 없습니다. (리플렉션 내보내기보안 문제를 참조하세요.) 이 기능을 사용하려면 애플리케이션이 .NET Framework 3.5 이상을 대상으로 해야 합니다.