属性列表 (Visual Basic)

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

语法

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]  

部件

部件 DESCRIPTION
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 名称,并将其他信息作为变量初始值设定项提供。

另请参阅