自定义Attribute需继承System.Attribute并用AttributeUsage限定目标(如仅方法),类名建议以Attribute结尾;应用时通过反射读取,缺失时返回null而非异常,性能敏感场景应缓存或配合Source Generator在编译期处理。

怎么定义一个可作用于方法的自定义 Attribute
自定义 Attribute 必须继承 System.Attribute,且推荐显式指定 AttributeUsage 来限定它能修饰的目标(比如只允许用在方法上)。不加这个约束,编译器不会报错,但运行时反射读取时可能拿到意外位置的实例。
常见错误是忘记加 [AttributeUsage(AttributeTargets.Method)],结果特性被误标在类或属性上,后续通过 GetCustomAttribute 查不到——因为根本没允许它出现在方法上。
- 类名建议以
Attribute结尾(如LogExecutionTimeAttribute),C# 允许使用时省略后缀([LogExecutionTime]) - 构造函数参数决定「位置参数」,
public属性决定「命名参数」 - 如果需要在 JIT 或 AOT 编译阶段生效(比如影响 IL 生成),普通
Attribute不行,得用源生成器或ModuleInitializer配合
如何在方法上应用并读取自定义 Attribute
应用很简单:[MyCustomAttr("value", Level = 2)];读取必须靠反射,且注意:只有在目标成员被反射访问时,.NET 才会解析并实例化该特性——不是声明时就创建对象。
典型场景是 AOP 式日志、权限校验、序列化控制。但别在热路径里反复调用 GetCustomAttribute,它有反射开销;建议启动时缓存(比如用 ConcurrentDictionary)。
- 用
typeof(MyClass).GetMethod("MyMethod").GetCustomAttribute获取单个实例() - 用
GetCustomAttributes的第二个参数为(true) true表示查找继承链上的特性 - 若特性类含复杂初始化逻辑(如打开文件、连接数据库),要格外小心——它会在每次反射获取时执行
为什么 GetCustomAttribute 返回 null 而不是抛异常
GetCustomAttribute 设计为“查无此特则返回 null”,这是有意为之:绝大多数使用场景下,缺失特性是合法状态(比如某个方法不需要日志,就不打标签),没必要用异常干扰流程。
千博购物系统.Net能够适合不同类型商品,为您提供了一个完整的在线开店解决方案。千博购物系统.Net除了拥有一般网上商店系统所具有的所有功能,还拥有着其它网店系统没有的许多超强功能。千博购物系统.Net适合中小企业和个人快速构建个性化的网上商店。强劲、安全、稳定、易用、免费是它的主要特性。系统由C#及Access/MS SQL开发,是B/S(浏览器/服务器)结构Asp.Net程序。多种独创的技术使
容易踩的坑是直接对返回值调用方法而不判空,导致 NullReferenceException。更隐蔽的问题是:你写了 [MyAttr],但忘了在类/方法上加 public 访问修饰符,导致反射拿不到该成员——此时 GetMethod 返回 null,再调 GetCustomAttribute 就是空引用。
- 检查目标方法是否为
public,非 public 成员需用BindingFlags.NonPublic | BindingFlags.Instance - 确认程序集已加载,且特性类型未被 Trim(发布时若启用
TrimMode=link,需在.csproj中添加)false - 调试时可用
typeof(MyClass).GetMethods().Select(m => (m.Name, m.GetCustomAttribute快速验证是否被正确识别()))
Attribute 和 Source Generator 怎么配合避免运行时反射
纯 Attribute 只能在运行时通过反射读取,而 Source Generator 能在编译期扫描这些特性,生成额外代码(比如自动注册 Handler、注入拦截逻辑)。这对性能敏感或 AOT 场景很关键。
比如你写了个 [Route("/api/users")],不用等请求进来再反射找路由,Generator 可直接生成 MapGet 调用。但要注意:Generator 看不到私有成员,也无法处理动态构造的类型名(如字符串拼接的类名)。
- Generator 必须引用含特性的程序集,且该程序集不能是
InternalsVisibleTo隐藏的 - 特性类本身需为
public,且所有构造函数和属性也要是public,否则 Generator 读不到值 - 不要在特性中放不可序列化的字段(如委托、Stream),Generator 在编译期无法执行它们
实际项目里最常出问题的,是特性被定义成 internal 却期望在另一个程序集里被反射读到,或者忘了给 AttributeUsage 加 Inherited = true 导致子类方法拿不到父类标记的特性。





