特性列表 (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 名称作为位置参数,提供其他信息作为变量初始值设定项。