C# 如何自定义特性(Attribute) - 元数据编程的强大功能

自定义特性是C#中继承Attribute类、用AttributeUsage声明使用范围的元数据机制，通过构造函数参数（位置参数）和属性（命名参数）传递配置，需反射读取并谨慎用于解耦配置与行为。

自定义特性（Attribute）是 C# 中实现元数据编程的核心机制，它让你能在代码中声明式地附加额外信息，并在运行时通过反射读取和使用这些信息。关键不在于“加标签”，而在于“让标签可被识别、可被提取、可被逻辑驱动”。

定义一个自定义特性类

自定义特性本质是一个继承自 Attribute 的类。它支持构造函数参数和命名参数（属性），但必须显式标记 [AttributeUsage] 来说明它能用在哪些程序元素上（如类、方法、属性等）。

• 用 [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)] 控制使用范围、是否允许多次使用、是否继承
• 构造函数参数对应“位置参数”，用于必填信息；public set 访问器的属性对应“命名参数”，用于可选配置
• 避免在特性中放复杂逻辑或副作用——它只是数据容器，不是执行单元

在代码中应用自定义特性

语法和内置特性一样，写在目标元素上方，括号内传入参数即可。支持位置参数（按构造函数顺序）、命名参数（PropertyName = value），也可混合使用。

• 例如：[ApiVersion(2, Description = "v2 接口", IsDeprecated = true)] public class UserController { ... }
• 多个同类型特性需开启 AllowMultiple = true，否则编译报错
• 特性不会影响编译结果或运行行为——除非你主动用反射去读它

在运行时读取并使用特性信息

靠反射（Reflection）获取：调用 GetCustomAttribute() 或 GetCustomAttributes() 方法，从类型、方法、属性等成员对象上提取实例。

标签： 特性 c# 处理器 工具 路由