Список атрибутов (Visual Basic)

Статья
08/11/2011

Указывает атрибуты, применяемые к объявленному программному элементу. Несколько атрибутов разделяются запятыми. Далее представлен синтаксис для одного атрибута.

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Части

attributemodifier
Обязательный для атрибутов, примененных в начале исходного файла. Может быть Assembly (Visual Basic) или Модуль.
attributename
Обязательный. Имя атрибута.
attributearguments
Необязательный. Список позиционных аргументов для этого атрибута. Несколько аргументов разделяются запятыми.
attributeinitializer
Необязательный. Список инициализаторов переменных или свойств для данного атрибута. Несколько инициализаторов разделяются запятыми.

Заметки

Можно применить один или несколько атрибутов практически к любому элементу программирования (типы, процедуры, свойства и т. д.). Атрибуты отображаются в метаданных сборки, и они могут помочь комментировать код или указать способ использования конкретного элемента программирования. Можно применить атрибуты, определенные в Visual Basic и .NET Framework, и можно определить собственные атрибуты.

Дополнительные сведения по использованию атрибутов содержатся в разделе Атрибуты (C# и Visual Basic). Дополнительная информация об именах атрибутов содержится в разделе Имена объявленных типов (Visual Basic).

Правила

Размещение. Атрибуты можно применять к большинству объявленных элементов программирования. Чтобы применить один или несколько атрибутов, поместите блок атрибутов в начале объявления элемента. Каждая запись в списке атрибутов задает атрибут, который предполагается применять, и модификатор и аргументы, которые будут использованы для вызова этого атрибута.
Угловые скобки. Если используется список атрибутов, то его необходимо заключить в угловые скобки ("<" и ">").
Часть объявления. Атрибут должен быть частью объявления элемента, а не отдельным оператором. Для расширения оператора объявления на несколько строк исходного кода можно использовать последовательность продолжения строки (" _").
Модификаторы. Модификатор атрибута (Assembly или Module) необходим для каждого атрибута, примененного к элементу программирования в начале исходного файла. Модификаторы атрибутов не допускаются для атрибутов, примененных к элементам, которые находятся не в начале исходного файла.
Аргументы. Любые позиционные аргументы для атрибута должны предшествовать инициализаторам любых переменных или свойств.

Пример

В следующем примере атрибут DllImportAttribute применяется к определению процедуры Function.

<DllImportAttribute("kernel32.dll", EntryPoint:="MoveFileW",
    SetLastError:=True, CharSet:=CharSet.Unicode,
    ExactSpelling:=True,
    CallingConvention:=CallingConvention.StdCall)>
Public Shared Function moveFile(ByVal src As String,
  ByVal dst As String) As Boolean
    ' This function copies a file from the path src to the path dst.
    ' Leave this function empty. The DLLImport attribute forces calls
    ' to moveFile to be forwarded to MoveFileW in KERNEL32.DLL.
End Function

DllImportAttribute указывает, что процедура, для которой указан атрибут, представляет точку входа в неуправляемую динамически подключаемую библиотеку (DLL). Атрибут предоставляет имя DLL как позиционный аргумент, а другие сведения — как инициализаторы переменных.