attributeusage是什么？定义与用途

理解C#中的AttributeUsage：属性使用规则说明书

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

属性与AttributeUsage的关系

属性本身是元数据的一种，用来给类、方法、字段等元素附加额外信息，运行时可以读取这些信息做逻辑判断。但光有属性还不够，你得告诉编译器：我这个属性是给类用的，还是给方法用的？能不能重复贴？能不能被子类继承？这些规则就全由AttributeUsage来定义。

AttributeTargets枚举：指定属性目标类型

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

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

组合多个目标：按位或运算

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

Inherited与AllowMultiple：控制继承与重复

除了目标范围，AttributeUsage还提供了两个可调参数：Inherited和AllowMultiple。前者的默认值是true，意思是基类上的属性会继承到派生类；后者的默认值是false，表示同一个目标上不能重复挂多个相同类型的属性。如果你需要允许重复应用，比如记录多个日志标签，那就显式设置AllowMultiple = true。

总结：AttributeUsage提升代码规范性与可维护性

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