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 превышает максимальную длину, определенную в системе.

ArgumentNullException

name имеет значение null.

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

Комментарии

Определение нескольких динамических модулей с одинаковым именем в сборке является ошибкой.

Определенный динамический модуль является временным. Динамический модуль не сохраняется, даже если родительская динамическая сборка была создана с RunAndSaveпомощью .

Примечание

Чтобы отключить оптимизацию при отладке динамических модулей, примените DebuggableAttribute атрибут к динамической сборке перед вызовом DefineDynamicModule. Создайте экземпляр DebuggableAttribute с флагом DisableOptimizations и примените его с помощью SetCustomAttribute метода . Атрибут должен применяться к динамической сборке. Она не оказывает влияния при применении к модулю.

Примечание

Начиная с платформа .NET Framework 2.0 с пакетом обновления 1 (SP1), этому члену ReflectionPermissionFlag.ReflectionEmit больше не нужен ReflectionPermission флаг . (См. раздел Проблемы безопасности при отображении отражения.) Чтобы использовать эту функцию, приложение должно быть предназначено для платформа .NET Framework 3.5 или более поздней версии.