Язык программирования C#9 и платформа .NET5

Маркер 
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