特性列表 (Visual Basic)
指定要应用于已声明的编程元素的特性。多个特性以逗号分隔。以下是一个特性的语法。
[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]
部件
attributemodifier
对于用于源文件起始处的特性,为必选项。可以为 程序集 (Visual Basic) 或 Module。attributename
必选。特性名。attributearguments
可选。该特性的定位参数列表。多个参数以逗号分隔。attributeinitializer
可选。该特性的变量或属性初始值设定项列表。多个初始值设定项以逗号分隔。
备注
可以将一个或多个特性应用于几乎任何一个编程元素(类型、过程、属性等)。特性显示在程序集的元数据中,它们可以帮助您批注代码或指定如何使用特定的编程元素。您可以应用 Visual Basic 和 .NET Framework 定义的特性,也可以定义您自己的特性。
有关何时使用特性的更多信息,请参见特性(C# 和 Visual Basic)。有关特性名称的信息,请参见 已声明的元素名称 (Visual Basic)。
规则
**位置。**可以将特性应用于大多数已声明的编程元素。若要应用一个或多个特性,请在元素声明的起始处放置“属性块”。特性列表中的每一项均指定一个您要应用的特性,以及用于该特性调用的修饰符和参数。
**尖括号。**如果您提供了特性列表,必须将其置于尖括号内(“<”和“>”)。
**声明的一部分。**特性必须为元素声明的一部分,而不是独立的语句。您可以使用行继续序列 (" _") 将声明语句扩展到多个源代码行。
**修饰符。**在应用于源文件起始处的编程元素的每个特性中,必须使用特性修饰符(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 名称作为一个定位参数,并提供其他信息作为变量初始值设定项。