Литмир - Электронная Библиотека
A
A

Маркер

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

318
{"b":"847442","o":1}