屬性清單 (Visual Basic)

發行項
08/12/2011

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

[ attributemodifier ] attributename [ ( attributearguments | attributeinitializer ) ]

組件

attributemodifier
對套用於原始程式檔 (Source File) 開頭處的屬性為必要項。可以是 Assembly (Visual Basic) 或 Module。
attributename
必要項。屬性 (Attribute) 名稱。
attributearguments
選擇項。這個屬性 (Attribute) 的位置引數清單。以逗號 ( , ) 分隔多個引數。
attributeinitializer
選擇項。這個屬性 (Attribute) 的變數或屬性 (Property) 初始設定式清單。初始設定式之間會以逗號來分隔。

備註

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

如需何時使用屬性的詳細資訊，請參閱屬性 (C# 和 Visual Basic)。如需屬性名稱的詳細資訊，請參閱宣告項目名稱 (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 名稱做為位置性引數，而將其他資訊做為變數初始設定式。