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

Маркер

служит для установления имени заданного типа, которым в рассматриваемом случае является специальное перечисление . Маркер метаданных применяется при документировании базового типа для заданного типа .NET Core (ссылаемого типа в этом случае). Каждое поле перечисления помечается с использованием маркера . Ради краткости выше была приведена только часть метаданных.

На заметку! Хотя это выглядит как опечатка, в

отсутствует буква "", которую можно было бы ожидать.

Просмотр (частичных) метаданных для типа Car

 Ниже показана часть метаданных класса

, которая иллюстрирует следующие аспекты:

• как поля определяются в терминах метаданных .NET Core;

• как методы документируются посредством метаданных .NET Core;

• как автоматическое свойство представляется в метаданных .NET Core.

Прежде всего, метаданные класса

указывают базовый класс этого типа ) и включают разнообразные флаги, которые описывают то, как тип был сконструирован (например, , и т.п.). Описания методов (вроде конструктора ) содержат имя, возвращаемое значение и параметры.

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

) и два сгенерированных компилятором метода (в случае свойства для чтения и записи) с именами и . Наконец, само свойство отображается на внутренние методы получения/установки с применением маркеров и метаданных .NET Core.

Исследование блока TypeRef

Вспомните, что метаданные сборки будут описывать не только набор внутренних типов (

, и т.д.), но также любые внешние типы, на которые ссылаются внутренние типы. Например, с учетом того, что в сборке определены два перечисления, метаданные типа будут содержать следующий блок :

Документирование определяемой сборки

В файле

также присутствуют метаданные .NET Core, которые описывают саму сборку с использованием маркера . Ниже представлена часть метаданных манифеста сборки :