Пользовательские атрибуты в Visual Basic

Обновлен: Ноябрь 2007

Пользовательские атрибуты — это атрибуты, определяемые пользователем для предоставления дополнительной информации об элементах программы. Например, пользователь может создать атрибут безопасности, который определяет разрешения, необходимые для запуска процедуры.

Пользовательские атрибуты определяются в классах атрибутов на основе класса System.Attribute. Сами атрибуты этих классов используют атрибут AttributeUsageAttribute для предоставления информации об использовании атрибута. Определение значения Inherited = True указывающее на то, что атрибут может передаваться производным классам. Задание свойству AllowMultiple значения True позволяет создавать более одного экземпляра атрибута для элемента программы. Перечисление AttributeTargets позволяет определять типы элементов программы, к которым можно применять данный атрибут.

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

<AttributeUsage(AttributeTargets.All, Inherited:=True, AllowMultiple:=False)> _
Class TestAttribute1
    Inherits Attribute
End Class

Можно использовать оператор Or для комбинирования различных элементов из перечисления AttributeTargets, как это сделано в следующем коде:

<AttributeUsage(AttributeTargets.Class Or AttributeTargets.Method)> _
Class TestAttribute2
    Inherits Attribute
End Class

В этом подразделе

• Практическое руководство. Определение пользовательских атрибутов
  Описание создания пользовательских атрибутов с помощью классов атрибутов.

• Практическое руководство. Извлечения настраиваемых атрибутов
  Демонстрация способов извлечения пользовательских атрибутов с помощью GetCustomAttribute или GetCustomAttributes.

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

Связанные подразделы

• Visual Basic и .NET Framework
  Описание роли Visual Basic в .NET Framework.

• Объектно-ориентированное программирование в Visual Basic
  Информация об объектно-ориентированном программировании и его применении.

• Метаданные и компоненты с самоописанием
  Подробная информация о типах метаданных, в том числе об атрибутах, используемых в Visual Studio.