特性列表 (Visual Basic)

  • 项目

指定要应用于声明的编程元素的特性。 用逗号分隔多个属性。 以下是某一特性的语法。

语法

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

组成部分

组成部分 说明
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 名称作为位置参数，提供其他信息作为变量初始值设定项。

另请参阅