建立自訂屬性

您可以藉由定義屬性類別、直接或間接衍生自 Attribute的屬性類別，以建立自己的自定義屬性，以便快速且輕鬆地識別元數據中的屬性定義。 假設您想要以撰寫型別的程式設計人員名稱標記類型。 您可以定義自訂 Author 屬性類別：

[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct)
]
public class AuthorAttribute : System.Attribute
{
    private string Name;
    public string Version;

    public AuthorAttribute(string name)
    {
        Name = name;
        Version = "1.0";
    }
}

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

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

[Author("P. Ackerman", Version = "1.1")]
class SampleClass
{
    // P. Ackerman's code goes here...
}

AttributeUsage 具有具名參數 ， AllowMultiple您可以使用它進行自訂屬性單一使用或多重使用。 在下列程式代碼範例中，會建立 multiuse 屬性。

[System.AttributeUsage(System.AttributeTargets.Class |
                       System.AttributeTargets.Struct,
                       AllowMultiple = true)  // Multiuse attribute.
]
public class AuthorAttribute : System.Attribute
{
    string Name;
    public string Version;

    public AuthorAttribute(string name)
    {
        Name = name;

        // Default value.
        Version = "1.0";
    }

    public string GetName() => Name;
}

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

[Author("P. Ackerman"), Author("R. Koch", Version = "2.0")]
public class ThirdClass
{
    // ...
}

另請參閱

• System.Reflection
• 撰寫自定義屬性
• AttributeUsage （C#）