自定义Attribute是C#中通过继承Attribute类并用AttributeUsage控制适用范围,实现元数据标注与运行时反射的关键机制;支持构造函数传参、属性赋值,并可通过反射读取以驱动权限控制、版本路由等自动化逻辑。
自定义 Attribute 是 C# 中实现元数据标注和运行时反射的关键能力,它让代码具备“自我描述”能力,常用于权限控制、序列化配置、日志记录、API 文档生成等场景。核心在于继承 Attribute 类,并合理使用 AttributeUsage 控制其适用范围。
一、定义一个基础自定义特性
只需新建一个类,继承 Attribute,并用 [AttributeUsage] 明确它能标记哪些程序元素(如类、方法、属性等):
- [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)] —— 表示该特性可应用于类或方法,不允许重复添加,且子类可继承
- 构造函数通常用于必填参数(位置参数),属性用于可选参数(命名参数)
示例:
[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method)]
public class ApiVersionAttribute : Attribute
{
public ApiVersionAttribute(string version) => Version = version;
public string Version { get; }
public bool IsDeprecated { get; set; } = false;
}
二、在代码中应用特性
直接写在目标成员上方,支持位置参数(构造函数传入)和命名参数(属性赋值):
- [ApiVersion(“v2.1”)] → 调用带参构造
- [ApiVersion(“v3.0”, IsDeprecated = true)] → 构造 + 属性赋值
- 可同时标注多个不同特性,也可(若 AllowMultiple=true)重复标注同一特性
例如: