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

Документирование ссылаемых сборок

В дополнение к маркеру

и набору блоков и в метаданных .NET Core также применяются маркеры для документирования каждой внешней сборки. С учетом того, что каждая сборка .NET Core ссылается на библиотеку базовых классов , вы обнаружите для сборки , как показано в следующем фрагменте:

Документирование строковых литералов

Последний полезный аспект, относящийся к метаданным .NET Core, связан с тем, что все строковые литералы в кодовой базе документируются внутри маркера

:

На заметку! Всегда помните о том, что все строки явным образом документируются в метаданных сборки, как продемонстрировано в представленном выше листинге метаданных. Это может привести к крупным последствиям в плане безопасности, если вы применяете строковые литералы для хранения паролей, номеров кредитных карт или другой конфиденциальной информации.

У вас может возникнуть вопрос о том, каким образом задействовать такую информацию в разрабатываемых приложениях (в лучшем сценарии) или зачем вообще заботиться о метаданных (в худшем сценарии). Чтобы получить ответ, необходимо ознакомиться со службами рефлексии .NET Core. Следует отметить, что полезность рассматриваемых далее тем может стать ясной только ближе к концу главы, а потому наберитесь терпения.

На заметку! В разделе

вы также найдете несколько маркеров , которые документируют атрибуты, применяемые внутри кодовой базы. Роль атрибутов .NET Core обсуждается позже в главе.

Понятие рефлексии

В мире .NET Core рефлексией называется процесс обнаружения типов во время выполнения. Службы рефлексии дают возможность получать программно ту же самую информацию о метаданных, которую генерирует утилита

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

Как и любое другое пространство имен,

(из сборки ) содержит набор связанных типов. В табл. 17.1 описаны основные члены , которые необходимо знать.

Чтобы понять, каким образом задействовать пространство имен

для программного чтения метаданных .NET Core, сначала следует ознакомиться с классом .

Класс System.Туре

В классе

определены члены, которые могут применяться для исследования метаданных типа, большое количество которых возвращают типы из пространства имен . Например, метод возвращает массив объектов , метод — массив объектов и т.д. Полный перечень членов, доступных в , довольно велик, но в табл. 17.2 приведен список избранных членов, поддерживаемых (за исчерпывающими сведениями обращайтесь в документацию по .NET Core).

Получение информации о типе с помощью System.Object.GetType()

Экземпляр класса

можно получать разнообразными способами. Тем не менее, есть одна вещь, которую делать невозможно — создавать объект напрямую, используя ключевое слово , т.к. является абстрактным классом. Касательно первого способа вспомните, что в классе определен метод , который возвращает экземпляр класса , представляющий метаданные текущего объекта: