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

Статья
03/05/2024

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

Синтаксис

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

Детали

Часть	Description
`attributemodifier`	Требуется для атрибутов, применяемых в начале исходного файла. Может быть сборкой или модулем.
`attributename`	Обязательный. Имя атрибута.
`attributearguments`	Необязательно. Список позиционных аргументов для этого атрибута. Несколько аргументов разделены запятыми.
`attributeinitializer`	Необязательно. Список инициализаторов переменных или свойств для этого атрибута. Несколько инициализаторов разделены запятыми.

Замечания

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

Дополнительные сведения об использовании атрибутов см. в обзоре атрибутов. Сведения об именах атрибутов см. в разделе "Объявленные имена элементов".

Правила

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

Поделиться через