特性列表 (Visual Basic)

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

语法

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]  

组成部分

组成部分 说明
attributemodifier 对于应用于源文件开头的特性来说,是必需的。 可以是程序集模块
attributename 必需。 属性的名称。
attributearguments 可选。 此特性的位置参数列表。 多个参数之间用逗号分隔。
attributeinitializer 可选。 此特性的变量或属性初始值设定项列表。 多个初始值设定项之间以逗号分隔。

注解

可以将一个或多个特性应用于几乎所有编程元素(类型、过程、属性等)。 特性在程序集元数据中显示,可帮助注释代码或指定如何使用特定的编程元素。 你可以应用 Visual Basic 和 .NET Framework 定义的特性,也可以定义自己的特性。

有关何时使用特性的详细信息,请参阅特性概述。 有关特性名称的信息,请参阅声明的元素名称

规则

  • 放置。 你可以将特性应用于大多数声明的编程元素。 若要应用一个或多个特性,请在元素声明的开头放置一个特性块。 特性列表中的每个条目都指定要应用的特性,以及要用于调用该特性的修饰符和参数。

  • 尖括号。 如果提供特性列表,则必须将其括在尖括号(“<”和“>”)中。

  • 声明的一部分。 特性必须是元素声明的一部分,而不是单独的语句。 你可以使用行继续序列(“_”)将声明语句扩展到多个源代码行。

  • 修饰符。 应用于源文件开头的编程元素的每个特性都需要特性修饰符(AssemblyModule)。 应用于非源文件开头的元素的特性不允许使用特性修饰符。

  • 参数。 特性的所有位置参数必须位于任意变量或属性初始值设定项之前。

示例

以下示例将 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 名称作为位置参数,提供其他信息作为变量初始值设定项。

另请参阅