聊到C#里的自定义属性（Attribute），有个类你迟早会打交道——AttributeUsage。它就像一张“使用说明书”，专门规定你写的那个自定义属性到底能贴在什么上面。换句话说，它决定了属性的适用范围，避免你把它用在不该用的地方。

什么是 AttributeUsage？

属性本身是元数据的一种，用来给类、方法、字段等元素附加额外信息。运行时可以读取这些信息做逻辑判断。

但光有属性还不够，你得告诉编译器：我这个属性是给类用的，还是给方法用的？能不能重复贴？能不能被子类继承？这些规则就全由 AttributeUsage 来定义。

工作原理：目标类型

构造函数接收一个 AttributeTargets 枚举参数，这个枚举用标志位列出了所有允许的目标类型。常见的选项包括：

• 程序集（Assembly）
• 模块（Module）
• 类或结构体（Class）
• 结构体（Struct）
• 枚举（Enum）
• 构造函数（Constructor）
• 方法（Method）——包括属性的访问器和事件订阅者
• 属性（Property）——包括自动属性和索引器
• 字段（Field）
• 事件（Event）
• 接口（Interface）
• 参数（Parameter）
• 委托（Delegate）

组合多个目标

你可以通过按位或运算组合多个目标。比如想同时允许类和方法，就写 AttributeTargets.Class | AttributeTargets.Method。这样一来，一旦有人把属性贴到枚举类型上，编译器立刻报错——清清楚楚，绝不犹豫。

可调参数：Inherited 和 AllowMultiple

除了目标范围，AttributeUsage 还提供了两个可调参数：

• Inherited：默认值是 true，意思是基类上的属性会继承到派生类。
• AllowMultiple：默认值是 false，表示同一个目标上不能重复挂多个相同类型的属性。

如果你需要允许重复应用，比如记录多个日志标签，那就显式设置 AllowMultiple = true。

总结

说到底，AttributeUsage 就是给自定义属性上了一道“规则锁”。没有它，属性的使用范围就模糊不清，很容易误用。有了它，代码的意图一目了然，编译器也能帮我们提前拦住错误。对于提升代码的可读性和可维护性来说，这是一个非常实用的小工具。

《夸克》非常好用的免费AI浏览器

下载APP查看