AssemblyBuilder.DefineDynamicModule Yöntem

Tanım

Ad Alanı:

System.Reflection.Emit

Bütünleştirilmiş Kod:

System.Reflection.Emit.dll

Bu derlemede dinamik bir modül tanımlar.

Aşırı Yüklemeler

DefineDynamicModule(String)

Bu derlemede adlandırılmış bir geçici dinamik modül tanımlar.

DefineDynamicModule(String)

Kaynak:

AssemblyBuilder.cs

Bu derlemede adlandırılmış bir geçici dinamik modül tanımlar.

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

Parametreler

name

String

Dinamik modülün adı.

Döndürülenler

ModuleBuilder

Tanımlanan dinamik modülü temsil eden bir ModuleBuilder.

Özel durumlar

ArgumentException

name boşlukla başlar.

-veya-

name uzunluğu sıfırdır.

-veya-

name uzunluğu, sistem tarafından tanımlanan uzunluk üst sınırından büyüktür.

-veya-

Yalnızca .NET Framework: Aynı name sahip bir modül bu derlemede zaten tanımlanmıştır.

ArgumentNullException

name null.

InvalidOperationException

Yalnızca .NET Core ve .NET 5+ : Bu derlemede zaten bir dinamik modül tanımlanmıştır.

SecurityException

Çağıranın gerekli izni yok.

ExecutionEngineException

Varsayılan simge yazıcı derlemesi yüklenemiyor.

-veya-

Varsayılan simge yazıcı arabirimini uygulayan tür bulunamıyor.

Örnekler

Aşağıdaki kod örneği, DefineDynamicModulekullanarak geçici bir dinamik modülün nasıl oluşturulacağını gösterir.

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")

Açıklamalar

Yalnızca .NET Core ve .NET 5+ : Çok modüllü derlemelerdesteklenmez. Derlemede yalnızca bir dinamik modül tanımlanabilir.

Yalnızca .NET Framework: Bir derlemede aynı ada sahip birden çok dinamik modül tanımlamak bir hatadır.

Tanımlanan dinamik modül geçicidir. Üst dinamik derleme RunAndSaveile oluşturulmuş olsa bile dinamik modül kaydedilmez.

Not

Dinamik modüllerde hata ayıklama yaparken iyileştirmeleri engellemek için DefineDynamicModuleçağırmadan önce DebuggableAttribute özniteliğini dinamik derlemeye uygulayın. DisableOptimizations bayrağıyla bir DebuggableAttribute örneği oluşturun ve SetCustomAttribute yöntemini kullanarak uygulayın. Özniteliği dinamik derlemeye uygulanmalıdır. Modüle uygulandığında hiçbir etkisi olmaz.

Not

.NET Framework 2.0 Service Pack 1'den başlayarak, bu üye artık ReflectionPermissionFlag.ReflectionEmit bayrağıyla ReflectionPermission gerektirmez. (Bkz. Yansıma YaymaGüvenlik Sorunları.) Bu işlevselliği kullanmak için uygulamanızın .NET Framework 3.5 veya sonraki bir sürümü hedeflemesi gerekir.