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

В идеальном случае к настоящему моменту вы уже должны понимать перечисленные ниже ключевые моменты, касающиеся атрибутов .NET Core:

• атрибуты представляют собой классы, производные от

;

• атрибуты дают в результате встроенные метаданные;

• атрибуты в основном бесполезны до тех пор, пока другой агент не проведет в их отношении рефлексию;

• атрибуты в языке C# применяются с использованием квадратных скобок.

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

Построение специальных атрибутов

Первый шаг при построении специального атрибута предусматривает создание нового класса, производного от

. Не отклоняясь от автомобильной темы, повсеместно встречающейся в книге, создайте новый проект типа Class Library (Библиотека классов) на C# под названием . В этой сборке будет определено несколько классов для представления транспортных средств, каждый из которых описан с использованием специального атрибута по имени :

Как видите, класс

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

На заметку! По причинам, связанным с безопасностью, установившейся практикой в .NET Core считается проектирование всех специальных атрибутов как запечатанных. На самом деле среды Visual Studio и Visual Studio Code предлагают фрагмент кода под названием

, который позволяет сгенерировать в окне редактора кода новый класс, производный от . Для раскрытия любого фрагмента кода необходимо набрать его имя и нажать клавишу <ТаЬ> (один раз в Visual Studio Code и два раза в Visual Studio).

Применение специальных атрибутов

С учетом того, что класс

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

(window.adrunTag = window.adrunTag || []).push({v: 1, el: 'adrun-4-390', c: 4, b: 390})

Синтаксис именованных свойств

Обратите внимание, что классу

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

По контрасту для типов

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