共用方式為

建立自訂屬性 (Visual Basic)

  • 發行項

您可以建立自己的自訂屬性，方法是定義屬性類別，這是直接或間接衍生自 Attribute 的類別，它能快速且簡單地在中繼資料中識別屬性定義。 假設您想要用撰寫類型的程式設計人員姓名來標記類型。 您可能會定義自訂的 Author 屬性類別：

<System.AttributeUsage(System.AttributeTargets.Class Or
                       System.AttributeTargets.Struct)>
Public Class Author
    Inherits System.Attribute
    Private name As String
    Public version As Double
    Sub New(ByVal authorName As String)
        name = authorName
        version = 1.0
    End Sub
End Class

類別名稱是屬性的名稱，亦即 Author。 它衍生自 System.Attribute，因此它是自訂屬性類別。 建構函式的參數是自訂屬性的位置參數。 在此範例中，name 是位置參數。 任何公用讀寫欄位或屬性都是具名參數。 在此情況下，version 是唯一的具名參數。 請注意，使用了 AttributeUsage 屬性讓 Author 屬性只有對類別和 Structure 宣告有效。

您可以如下所示使用這個新屬性︰

<Author("P. Ackerman", Version:=1.1)>
Class SampleClass
    ' P. Ackerman's code goes here...
End Class

AttributeUsage 有一個具名參數 AllowMultiple，您可以用它讓自訂屬性僅單次使用或是多次使用。 在下列程式碼範例中，建立了多次使用的屬性。

' multiuse attribute
<System.AttributeUsage(System.AttributeTargets.Class Or
                       System.AttributeTargets.Struct,
                       AllowMultiple:=True)>
Public Class Author
    Inherits System.Attribute

在下列程式碼範例中，相同類型的多個屬性會套用至類別。

<Author("P. Ackerman", Version:=1.1),
Author("R. Koch", Version:=1.2)>
Class SampleClass
    ' P. Ackerman's code goes here...
    ' R. Koch's code goes here...
End Class

注意

如果您的屬性類別包含屬性，則該屬性必須是讀寫。

另請參閱