指定要应用于声明的编程元素的属性。 多个属性用逗号分隔。 下面是一个属性的语法。
语法
[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]
部件
部件 | DESCRIPTION |
---|---|
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 名称,并将其他信息作为变量初始值设定项提供。