屬性概觀 (Visual Basic)

  • 發行項

屬性提供一種功能強大的方法，可將中繼資料或宣告資訊關聯至程式碼 (組建、型別、方法、屬性等)。 將屬性關聯至程式實體之後，就能在執行階段使用稱為「反映」的技術來查詢該屬性。 如需詳細資訊，請參閱反映 (Visual Basic)。

屬性 (Attribute) 包含下列屬性 (Property)：

  • 屬性會將中繼資料新增至您的程式。 「中繼資料」是在程式中定義的型別相關資訊。 所有的 .NET 組件都包含一組指定的中繼資料，來描述組件中所定義的型別和型別成員。 您可以新增自訂屬性來指定所需的任何其他資訊。 如需詳細資訊，請參閱建立自訂屬性 (Visual Basic)。

  • 您可以將一或多個屬性 (Attribute) 套用至整個組件、模組或較小的程式元素，例如類別和屬性 (Property)。

  • 屬性 (Attribute) 可以利用與方法與屬性 (Property) 相同的方式來接受引數。

  • 您的程式可以使用反映，來檢查自己的中繼資料或其他程式的中繼資料。 如需詳細資訊，請參閱使用反映存取屬性 (Visual Basic)。

使用屬性

屬性可以放置於大多數的任意宣告中，但特定的屬性可能會限制它適用的宣告型別。 在 Visual Basic 中，屬性會以角括弧括住 (<>)。 它必須出現在同一行中要套用它的元素正前方。

在此範例中，會使用 SerializableAttribute 屬性來將特定的特性套用至類別：

<System.Serializable()> Public Class SampleClass
    ' Objects of this type can be serialized.
End Class

具有 DllImportAttribute 屬性的方法宣告如下：

Imports System.Runtime.InteropServices

<System.Runtime.InteropServices.DllImport("user32.dll")>
Sub SampleMethod()
End Sub

一個宣告中可以放置一個以上的屬性：

Imports System.Runtime.InteropServices

Sub MethodA(<[In](), Out()> ByVal x As Double)
End Sub
Sub MethodB(<Out(), [In]()> ByVal x As Double)
End Sub

可以針對特定實體多次指定某些屬性。 ConditionalAttribute 就是這種多次使用屬性的一個例子：

<Conditional("DEBUG"), Conditional("TEST1")>
Sub TraceMethod()
End Sub

注意

依照慣例，所有的屬性名稱都會以 "Attribute" 這個字結尾，以便與 .NET Framework 中的其他項目有所區別。 不過，您在程式碼中使用屬性時，不需要指定屬性的後置詞。 例如，[DllImport] 相當於 [DllImportAttribute]，但 DllImportAttribute 是屬性在 .NET Framework 中的實際名稱。

屬性參數

許多屬性的參數可以是位置、未命名或具名的參數。 任何位置參數都必須以特定順序指定，而且不能省略；具名參數是選擇性且可依任何順序指定。 位置參數會先指定。 例如，這三個屬性是相等的：

<DllImport("user32.dll")>
<DllImport("user32.dll", SetLastError:=False, ExactSpelling:=False)>
<DllImport("user32.dll", ExactSpelling:=False, SetLastError:=False)>

第一個參數 (DLL 名稱) 是位置參數，一律會先出現；其他的則為具名參數。 在此案例中，這兩個具名參數預設為 false，因此可以省略。 請參閱個別屬性的文件，以取得預設參數值的詳細資訊。

屬性目標

屬性的「目標」是要套用該屬性的實體。 例如，屬性可套用至類別、特定的方法或整個組件。 根據預設，屬性會套用到位於它正後方的元素。 但是，舉例來說，您也可以明確地識別是否要將屬性套用到方法、它的參數或它的傳回值。

若要明確地識別屬性目標，請使用下列語法：

<target : attribute-list>

下表顯示可能的 target 值清單。

目標值 適用於
assembly 整個組件
module 目前的組件模組 (這與 Visual Basic 模組不同)

下列範例示範如何將屬性套用到組件和模組。 如需詳細資訊，請參閱通用屬性 (Visual Basic)。

Imports System.Reflection
<Assembly: AssemblyTitleAttribute("Production assembly 4"),
Module: CLSCompliant(True)>

屬性的常見用法

下列清單包含一些程式碼中常見的屬性用法：

  • 在 Web 服務中使用 WebMethod 屬性標示方法，以表示此方法應該可以透過 SOAP 通訊協定來呼叫。 如需詳細資訊，請參閱WebMethodAttribute。

  • 描述在與原生程式碼交互作用時，如何封送處理方法參數。 如需詳細資訊，請參閱MarshalAsAttribute。

  • 描述適用於類別、方法和介面的 COM 屬性。

  • 使用 DllImportAttribute 類別呼叫 Unmanaged 程式碼。

  • 針對標題、版本、描述或商標等方面來描述您的組件。

  • 描述要將類別的哪些成員序列化以取得持續性。

  • 描述如何基於 XML 序列化目的，在類別成員與 XML 節點之間進行對應。

  • 描述方法的安全性需求。

  • 指定用來強制執行安全性的特性。

  • 控制由 Just-In-Time (JIT) 編譯器所進行的最佳化，讓程式碼保持易於偵錯。

  • 取得有關方法之呼叫端的資訊。

如需詳細資訊，請參閱

另請參閱