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

  • Статья

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

Синтаксис

[ 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 в качестве позиционного аргумента и другие сведения в качестве инициализаторов переменных.

См. также