特性列表 (Visual Basic)

项目
08/12/2011

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

[ 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 名称作为一个定位参数，并提供其他信息作为变量初始值设定项。