共用方式為


屬性清單

更新:2007 年 11 月

指定要套用至已宣告程式設計項目的屬性 (Attribute);多個屬性之間會以逗號分隔。下列是其中一個屬性的語法。

 [ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

組件

  • attributemodifier
    對套用於原始程式檔 (Source File) 開頭處的屬性為必要項。可以是 AssemblyModule

  • attributename
    必要項。屬性 (Attribute) 名稱。

  • attributearguments
    選擇項。這個屬性 (Attribute) 的位置引數清單。引數之間會以逗號來分隔。

  • attributeinitializer
    選擇項。這個屬性 (Attribute) 的變數或屬性 (Property) 初始設定式清單。初始設定式之間會以逗號來分隔。

備註

一個或多個屬性 (Attribute) 套用幾乎可以套用到任何程式設計項目 (型別、程序、屬性 (Property) 等)。屬性會出現在組件的中繼資料 (Metadata) 中,且可協助您加上程式碼的附註,或指定如何使用特定程式設計項目。您可套用 Visual Basic 和 .NET Framework 所提供的屬性,且可定義自己的屬性。

如需何時使用屬性的詳細資訊,請參閱 Visual Basic 中的屬性屬性的常見用法。如需屬性名稱的詳細資訊,請參閱宣告項目名稱

規則

  • 位置:可將屬性套用至大部分已宣告的程式設計項目。若要套用一或多個屬性,則可在項目宣告開頭處放置「屬性區塊」。屬性清單中的每個項目都會指定您想套用的屬性,以及要用於這個屬性引動的修飾詞 (Modifier) 和引數。

  • 角括弧:如果提供屬性清單,則必須將它封入角括弧 ("<" 和 ">") 中。

  • 宣告的一部分:屬性必須是項目宣告的一部分,而非個別的陳述式 (Statement)。您可使用行接續字元 (Line-Continuation) 序列 (" _"),將宣告陳述式 (Declaration Statement) 擴充成多個原始程式碼行。

  • 修飾詞:對於套用至原始程式檔開頭處之程式設計項目的每個屬性而言,屬性修飾詞 (Assembly 或 Module) 是必要項。對於套用至不在原始程式檔開頭處之項目的屬性而言,則不允許有屬性修飾詞。

  • 引數:屬性 (Attribute) 的所有位置性引數必須在任何變數或屬性 (Property) 初始設定式之前。

範例

下列範例會將 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 表示屬性化程序代表 Unmanaged 動態連結程式庫 (DLL) 的進入點 (Entry Point)。屬性會提供 DLL 名稱做為位置性引數,而將其他資訊做為變數初始設定式。

請參閱

工作

HOW TO:在程式碼中中斷和合併陳述式

概念

屬性的常見用法

屬性的應用

參考

Assembly

Module (Visual Basic)

其他資源

Visual Basic 中的屬性