Язык программирования 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
(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})// (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
