您现在的位置：程式碼之家 >> 編程語言 > >> .NET 網頁程式設計 >> C# >> 關於C#

[你必須知道的 .NET] 第三回：特性與屬性的歷史糾葛、定義、規則與實戰應用

編輯：關於C#

名詞釐清：Attribute ≠ Property

中文慣稱	英文	本質	用途
特性	Attribute	繼承 `System.Attribute` 的類別，編譯期嵌入中繼資料	序列化控制、編譯器指令、設計模式標記、運行期反射讀取
屬性	Property	類別成員，封裝 `get/set` 存取器	資料封裝、繫結、驗證、介面契約

MSDN 早期將 Attribute 譯為「屬性」造成混淆，現建議統稱 Attribute 為「特性」。

Attribute 通用規則

適用目標：assembly、module、type、property、event、field、method、param、return
語法：[AttributeName]、[AttributeName(...)]、[Attr1, Attr2]、[Attr1(), Attr2()]
前綴消除歧義：[assembly: MyAttr]、[module: MyAttr]、[type: MyAttr]、[method: MyAttr]、[property: MyAttr]、[event: MyAttr]、[field: MyAttr]、[param: MyAttr]、[return: MyAttr]
實例化時機：編譯期，非運行期
命名慣例：類別名以 Attribute 結尾（如 ObsoleteAttribute），使用時可省略
繼承規則：AttributeUsage(Inherited=true) 控制衍生類別是否繼承
多重套用：AllowMultiple=true
所有非抽象 Attribute 必須 public

內建經典 Attribute

Attribute	用途	關鍵屬性
`AttributeUsage`	控制自訂 Attribute 套用規則	`ValidOn`、`AllowMultiple`、`Inherited`
`Flags`	列舉視為位元旗標	`ToString()` 輸出 "A, B" 而非數值
`DllImport`	呼叫非託管 DLL	`EntryPoint`、`CallingConvention`、`CharSet`
`Serializable`	標記型別可序列化	配合 `ISerializable` 自訂
`Conditional`	條件編譯方法呼叫	`DEBUG`、`TRACE` 等符號控制
`Obsolete`	標記過時成員	`Message`、`IsError`
`Description`/`Category`/`DefaultValue`/`Browsable`	設計工具屬性格柵顯示控制	屬性視窗分組、預設值、可見性

自訂 Attribute 完整範例


[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = true, AllowMultiple = true)]
public class TestAttribute : Attribute {
    public string Message { get; }
    public TestAttribute(string msg) => Message = msg;
    public void RunTest() => Console.WriteLine($"TestAttribute: {Message}");
}

// 套用
[Test("驗證邏輯")]
public class MyClass {
    [Test("前置條件")]
    public void DoWork() { }
}

// 反射讀取
var attr = (TestAttribute)Attribute.GetCustomAttribute(typeof(MyClass), typeof(TestAttribute));
attr?.RunTest();

var method = typeof(MyClass).GetMethod("DoWork");
var attrs = method.GetCustomAttributes();
foreach (var a in attrs) a.RunTest();