Язык программирования C#9 и платформа .NET5 - Троелсен Эндрю

Указание ссылок на внешние сборки в CIL

Скопируйте файлы

и из предыдущего примера в новый каталог проекта. Создайте новый файл проекта по имени , содержимое которого показано ниже:

Затем создайте в текстовом редакторе новый файл по имени

. Первой задачей в проекте CIL является перечисление внешних сборок, которые будут задействованы текущей сборкой. В рассматриваемом примере применяются только типы, находящиеся внутри сборки . В новом файле понадобится указать директиву с уточняющим атрибутом . При добавлении ссылки на сборку со строгим именем, подобную , также должны быть указаны директивы и :

Определение текущей сборки в CIL

 Следующее действие заключается в определении создаваемой сборки с использованием директивы

. В простейшем случае сборка может быть определена за счет указания дружественного имени двоичного файла:

Хотя такой код действительно определяет новую сборку .NET Core, обычно внутрь объявления будут помещаться дополнительные директивы. В рассматриваемом примере определение сборки необходимо снабдить номером версии 1.0.0.0 посредством директивы

(обратите внимание, что числа в номере версии отделяются друг от друга двоеточиями, а не точками, как принято в С#):

Из-за того, что сборка

является однофайловой, ее определение завершается с применением следующей директивы , которая обозначает официальное имя двоичного файла .NET Core, т.е. :

Кроме

и существуют директивы CIL, которые позволяют дополнительно уточнять общую структуру создаваемого двоичного файла .NET Core. В табл. 19.1 перечислены некоторые наиболее распространенные директивы уровня сборки.

Определение пространств имен в CIL

Определив внешний вид и поведение сборки (а также обязательные внешние ссылки), вы можете создать пространство имен .NET Core (

), используя директиву :

Подобно C# определения пространств имен CIL могут быть вложены в другие пространства имен. Хотя здесь нет нужды определять корневое пространство имен, ради интереса посмотрим, как создать корневое пространство имен

:

Как и С#, язык CIL позволяет определить вложенное пространство имен следующим образом:

Определение типов классов в CIL

Пустые пространства имен не особо интересны, поэтому давайте рассмотрим процесс определения типов классов в CIL. Для определения нового типа класса предназначена директива

. Тем не менее, эта простая директива может быть декорирована многочисленными дополнительными атрибутами, уточняющими природу типа. В целях иллюстрации добавим в наше пространство имен открытый класс под названием . Как и в С#, если базовый класс явно не указан, то тип автоматически становится производным от :

При построении типа, производного не от класса

, применяется атрибут . Для ссылки на тип, определенный внутри той же самой сборки, язык CIL требует использования полностью заданного имени (однако если базовый тип находится внутри той же самой сборки, то префикс в виде дружественного имени сборки можно не указывать). Следовательно, демонстрируемая ниже попытка расширения в результате дает ошибку на этапе компиляции: