Маркер
TypDefName
служит для установления имени заданного типа, которым в рассматриваемом случае является специальное перечисление
CarLibrary.EngineStateEnum
. Маркер метаданных
Extends
применяется при документировании базового типа для заданного типа .NET Core (ссылаемого типа
System.Enum
в этом случае). Каждое поле перечисления помечается с использованием маркера
Field #n
. Ради краткости выше была приведена только часть метаданных.
На заметку! Хотя это выглядит как опечатка, в
TypDefName
отсутствует буква "
е
", которую можно было бы ожидать.
Просмотр (частичных) метаданных для типа Car
Ниже показана часть метаданных класса
Car
, которая иллюстрирует следующие аспекты:
• как поля определяются в терминах метаданных .NET Core;
• как методы документируются посредством метаданных .NET Core;
• как автоматическое свойство представляется в метаданных .NET Core.
// TypeDef #1
// -------------------------------------------------------
// TypDefName: CarLibrary.Car
// Flags : [Public] [AutoLayout] [Class] [Abstract] [AnsiClass] [BeforeFieldInit]
// Extends : [TypeRef] System.Object
// Field #1
// -------------------------------------------------------
// Field Name: <PetName>k__BackingField
// Flags : [Private]
// CallCnvntn: [FIELD]
// Field type: String
...
Method #1
-------------------------------------------------------
MethodName: get_PetName
Flags : [Public] [HideBySig] [ReuseSlot] [SpecialName]
RVA : 0x000020d0
ImplFlags : [IL] [Managed]
CallCnvntn: [DEFAULT]
hasThis
ReturnType: String
No arguments.
...
// Method #2
// -------------------------------------------------------
// MethodName: set_PetName
// Flags : [Public] [HideBySig] [ReuseSlot] [SpecialName]
// RVA : 0x00002058
// ImplFlags : [IL] [Managed]
// CallCnvntn: [DEFAULT]
// hasThis
// ReturnType: Void
// 1 Arguments
// Argument #1: String
// 1 Parameters
// (1) ParamToken : Name : value flags: [none]
...
// Property #1
// -------------------------------------------------------
// Prop.Name : PetName
// Flags : [none]
// CallCnvntn: [PROPERTY]
// hasThis
// ReturnType: String
// No arguments.
// DefltValue:
// Setter : set_PetName
// Getter : get_PetName
// 0 Others
...
Прежде всего, метаданные класса
Car
указывают базовый класс этого типа
(System.Object
) и включают разнообразные флаги, которые описывают то, как тип был сконструирован (например,
[Public]
,
[Abstract]
и т.п.). Описания методов (вроде конструктора
Car
) содержат имя, возвращаемое значение и параметры.
Обратите внимание, что автоматическое свойство дает в результате сгенерированное компилятором закрытое поддерживающее поле (по имени
<PetName>k_BackingField
) и два сгенерированных компилятором метода (в случае свойства для чтения и записи) с именами
get_PetName()
и
set_PetName()
. Наконец, само свойство отображается на внутренние методы получения/установки с применением маркеров
Setter
и
Getter
метаданных .NET Core.
Исследование блока TypeRef
Вспомните, что метаданные сборки будут описывать не только набор внутренних типов (
Car
,
EnginestateEnum
и т.д.), но также любые внешние типы, на которые ссылаются внутренние типы. Например, с учетом того, что в сборке
CarLibrary.dll
определены два перечисления, метаданные типа
System.Enum
будут содержать следующий блок
TypeRef
:
// TypeRef #19
// -------------------------------------------------------
// Token: 0x01000013
// ResolutionScope: 0x23000001
// TypeRefName: System.Enum
Документирование определяемой сборки
В файле
CarLibrary.il
также присутствуют метаданные .NET Core, которые описывают саму сборку с использованием маркера
Assembly
. Ниже представлена часть метаданных манифеста сборки
CarLibrary.dll
:
// Assembly