Генерирование компоновочного блока и набора модулей

Метод начинается с указания минимального набора характеристик компоновочного блока, для чего используются типы AssemblyName и Version (определенные в пространстве имен System.Reflection). Затем с помощью метода уровня экземпляра AppDomain.DеfineDynamicAssembly() вы получаете тип AssemblyBuilder (напомним, что вызывающая сторона передаст в метод CreateMyAsm() ссылку на AppDomain).

// Установка общих характеристик компоновочного блока

// и получение доступа к типу AssemblyBuilder.

public static void CreateMyAsm(AppDomain currAppDomain) {

 AssemblyName assemblyName = new AssemblyName();

 assemblyName.Name = "MyAssembly";

 assemblyName.Version = new Version("1.0.0.0");

 // Создание нового компоновочного блока в текущем AppDomain.

 AssemblyBuilder assembly = currAppDomain.DefineDynamicAssembly(assemblyName, AssemblyBuilderAccess.Save);

 …

}

Как видите, при вызове AppDomain.DefineDynamicAssembly() вы должны указать режим доступа к компоновочному блоку. Этот режим может задаваться любым из значений, указанных в табл. 15.10.

Таблица 15.10. Значения перечня AssemblyBuilderAccess 

Значение	Описание
ReflectionOnly	Динамический компоновочный блок может только отображаться
Run	Динамический компоновочный блок может выполняться в памяти, но не сохраняться на диск
RunAndSave	Динамический компоновочный блок может выполняться в памяти и сохраниться на диск
Save	Динамический компоновочный блок может сохраняться на диск, но не выполняться в памяти

Следующей задачей является определение набора модулей для нового компоновочного блока. Поскольку данный компоновочный блок является одномодульным, вы должны определить только один модуль. Если с помощью метода DefineDynamicModule() требуется построить многомодульный компоновочный блок, вы должны указать необязательный второй параметр, задающий имя данного модуля (например, myMod.dotnetmodule). Однако при создании одномодульного компоновочного блока имя модуля будет идентично имени самого компоновочного блока. Так или иначе, после завершения работы метода DefineDynamicModule() вы получите ссылку на действительный тип ModuleBuilder.

// Одномодульный компоновочный блок.

ModuleBuilder module = assembly .DefineDynamicModule("MyAssembly", "MyAssembly.dll");

Роль типа ModuleBuilder

Тип ModuleBuilder является ключевым типом для процесса построения динамических компоновочных блоков. В соответствии с возможными ожиданиями, ModuleBuilder предлагает целый ряд членов, позволяющих определить множество типов, содержащихся в данном модуле (классы, интерфейсы, структуры и т.д.), а также множество встроенных ресурсов (таблицы строк, изображения и т.д.; формат ресурсов .NET будет рассмотрен в главе 20). Некоторые из методов, относящихся к созданию инфраструктуры модуля, описаны в табл. 15.11 (каждый из этих методов возвращает тип, представляющий тот тип, который вы собирались сконструировать).

Таблица 15.11. Подборка членов типа ModuleBuilder

Метод	Описание
DefineEnum()	Используется для генерирования определения перечня .NET
DefineResource()	Определяет управляемый встроенный ресурс, который должен храниться в данном модуле
DefineType()	Конструирует TypeBuilder, который позволяет определять типы значений, интерфейсы и типы класса (в том числе и делегаты)

Ключевым членом класса ModuleBuilder, о котором следует знать, является DefineType(). Вдобавок к указанию имени типа (в виде простой строки), вы должны использовать перечень System.Reflection.TypeAttributes, чтобы непосредственно описать формат типа. Основные члены перечня TypeAttributes представлены в табл. 15.12.

Таблица 15.12. Подборка элементов перечня TypeAttributes 

Член	Описание
Abstract	Указывает абстрактный тип
Class	Указывает тип класса
Interface	Указывает тип интерфейса
NestedAssembly	Указывает, что класс вложен в область видимости компоновочного блока и поэтому доступен только для методов соответствующего компоновочного блока
NestedFamAndAssem	Указывает, что класс вложен в область видимости семейства и компоновочного блока и поэтому доступен только для методов, принадлежащих пересечению соответствующего семейства и компоновочного блока
NestedFamily	Указывает, что класс вложен в область видимости семейства и поэтому доступен только для методов соответствующего типа и его подтипов
NestedFamORAssem	Указывает, что класс вложен в область видимости семейства или компоновочного блока и поэтому доступен только для методов, принадлежащих объединению соответствующего семейства и компоновочного блока
NestedPrivate	Указывает вложенный класс с приватной областью видимости
NestedPublic	Указывает вложенный класс с общедоступной областью видимости
NotPublic	Указывает класс, не являющийся открытым
Public	Указывает открытый класс
Sealed	Указывает изолированный класс, который не может быть расширен
Serializable	Указывает класс, допускающий сериализацию