Системы. Рефлексия ion. Класс Emit.TypeBuilder

В этой статье приводятся дополнительные замечания к справочной документации по этому API.

TypeBuilder — корневой класс, используемый для управления созданием динамических классов в среде выполнения. Он предоставляет набор подпрограмм, которые используются для определения классов, добавления методов и полей и создания класса внутри модуля. Новое TypeBuilder можно создать из динамического модуля, вызвав ModuleBuilder.DefineType метод, который возвращает TypeBuilder объект.

Рефлексия ion emit предоставляет следующие параметры для определения типов:

• Определите класс или интерфейс с заданным именем.
• Определите класс или интерфейс с заданным именем и атрибутами.
• Определите класс с заданным именем, атрибутами и базовым классом.
• Определите класс с заданным именем, атрибутами, базовым классом и набором интерфейсов, реализуемых классом.
• Определите класс с заданным именем, атрибутами, базовым классом и размером упаковки.
• Определите класс с заданным именем, атрибутами, базовым классом и размером класса в целом.
• Определите класс с заданным именем, атрибутами, базовым классом, размером упаковки и размером класса в целом.

Чтобы создать тип массива, тип указателя или по ссылке для неполного типа, представленного TypeBuilder объектом, используйте MakeArrayType метод, MakePointerType метод, метод или MakeByRefType метод соответственно.

Перед использованием TypeBuilder.CreateType типа необходимо вызвать метод. CreateType завершает создание типа. После вызова CreateType вызывающий объект может создать экземпляр типа с помощью Activator.CreateInstance метода и вызвать члены типа с помощью Type.InvokeMember метода. Это ошибка вызова методов, которые изменяют реализацию типа после вызова CreateType . Например, среда CLR создает исключение, если вызывающий пытается добавить в тип новые члены.

Инициализатор класса создается с помощью TypeBuilder.DefineTypeInitializer метода. DefineTypeInitializer возвращает ConstructorBuilder объект.

Вложенные типы определяются путем вызова одного из TypeBuilder.DefineNestedType методов.

Атрибуты

Класс TypeBuilder использует TypeAttributes перечисление для дальнейшего указания характеристик создаваемого типа:

• Интерфейсы задаются с помощью TypeAttributes.Interface атрибутов и TypeAttributes.Abstract атрибутов.
• Конкретные классы (классы, которые не могут быть расширены) задаются с помощью атрибута TypeAttributes.Sealed .
• Несколько атрибутов определяют видимость типов. См. описание перечисления TypeAttributes .
• Если TypeAttributes.SequentialLayout задано, загрузчик класса размещает поля в том порядке, в который они считываются из метаданных. Загрузчик класса учитывает указанный размер упаковки, но игнорирует любые указанные смещения полей. Метаданные сохраняют порядок создания определений полей. Даже при слиянии метаданные не будут переупорядочены определения полей. Загрузчик будет учитывать указанные смещения полей, только если TypeAttributes.ExplicitLayout задано.

Известные проблемы

• Рефлексия ion выдает не проверяет, реализован ли не абстрактный класс, реализующий интерфейс, реализовал все методы, объявленные в интерфейсе. Однако если класс не реализует все методы, объявленные в интерфейсе, среда выполнения не загружает класс.
• Несмотря TypeBuilder на то, что Typeнекоторые абстрактные методы, определенные в Type классе, не полностью реализуются в TypeBuilder классе. Вызовы этих TypeBuilder методов вызывают NotSupportedException исключение. Требуемые функциональные возможности можно получить, извлекая созданный тип с помощью Type.GetType или Assembly.GetType отражая полученный тип.