在C#中，AttributeUsage被用来修饰类、方法、字段等各种对象，通过标记属性的方式为它们添加元数据。AttributeUsage提供了确定被修饰目标的类型，从而避免误用，同时也使代码的可读性更高、维护更方便。本文将深入探讨C#中AttributeUsage的使用方法与技巧。

一、 AttributeUsage简介

AttributeUsage是一个Attribute，在C#中可以用来限定Attribute的作用域。AttributeUsage的方法包括以下几种：

(1) AttributeTargets Enumeration 所指定的对象类型描述了目标元素：

- Assembly：程序集

- Module: 模块

- Class：类

- Struct：结构体

- Enum：枚举

- Constructor：构造函数

- Method：方法

- Property：属性

- Field：字段

- Event：事件

- Interface：接口

- Parameter：参数

- Delegate：委托

(2) ValidOn用于限定Attribute修饰的目标元素；

若AttributeUsage的ValidOn属性是Assembly，那么它只能被用来修饰程序集；若它的ValidOn属性是Class和Method，它只能被用来修饰类和方法。这也说明了AttributeUsage的作用：限定Attribute使用的目标对象范围，防止Attribute被误用。

(3) AllowMultiple用于确定一个Attribute是否可以被多次应用于同一目标元素；

若AllowMultiple被设置成false，那么同种Attribute只能被用于同一目标元素一次。若AllowMultiple被设置成true，那么同种Attribute可以被应用于同一目标元素多次。

(4) Inherited用于确定修饰的Attribute是否可以被继承；

若Inherited被设置成false，那么子类的属性没有从父类属性继承。若Inherited被设置成true，那么子类的属性将会从父类继承。

(5) AttributeUsage(AttributeTargets.All)限定了Attribute可以被用于所有的目标元素。

二、 AttributeUsage的使用方法与技巧

(1) 思考使用场景

在使用C#中AttributeUsage前，你需要思考你需要的效果是什么样的，需要标记的目标对象是哪些。这个过程需要考虑细节，需要站在使用者的角度思考。根据备用的数据，可以分析AttributeUsage来实现目标。

(2) 选择AttributeTargets

根据实际需要，我们需要选择AttributeTargets，以便精确定位目标元素。例如，如果要将Attribute应用于类和属性中，那么AttributeTargets可以为Class和Property。

(3) 指定Inherited的值

在标记一个Attribute时，可以选择Inherited的值。如果类继承了父类，在默认情况下，Attribute是不能被子类继承的。如果想让Attribute可以被子类继承，则需要在AttributeUsage中设置Inherited为true。

(4) 设置AllowMultiple的值

当你需要在一个类中绑定多个Attribute实例时，可以为AllowMultiple属性设置值。AllowMultiple属性默认值是false，即只能绑定具有相同AttributeTypeInfo的一个Attribute实例，如果要可以则需要将其设置为true。

(5) 确定ValidOn属性

根据需要，可以选择Attribute可用于哪些元素。如果需要将Attribute应用于类中，那么ValidOn属性可以设置为类。

(6) 必须派生自Attribute

你的定义必须派生自Attribute类。以CustomAttribute为例：

[AttributeUsage(AttributeTargets.All, AllowMultiple = true)]

public class CustomAttribute : Attribute

{

public string Property1 { get; set; }

public string Property2 { get; set; }

public CustomAttribute(string property1, string property2)

{

Property1 = property1;

Property2 = property2;

}

}

三、 AttributeUsage的注意事项

(1) AttributeUsage不能被继承

AttributeUsage不能被继承，即可以在派生类上重复定义AttributeUsage，但派生的派生类将不会承继它。例如：

[AttributeUsage(AttributeTargets.All)]

public class BaseAttribute : Attribute

{

}

[AttributeUsage(AttributeTargets.All)]

public class DerivedAttribute : BaseAttribute

{

}

[Derived]

public class TargetClass

{

public int TargetProperty { get; set; }

}

输出：

运行时将会忽略在派生类中定义的AttributeUsage。

(2) Attribute只能用于编译期的元素

Attribute只有在编译时才有用，无法应用于运行时或被动态地添加到程序中。例如：

[Custom("custom", "attribute")]

class Target

{

static void Main(string[] args)

{

// ...

}

}

这里的Custom是一个伪代码，运行以下程序将无效。

(3) 命名空间要正确

在使用Attribute时，一定要确保在using中加入它所在的命名空间。例如：

using System;

class Program

{

[Obsolete("Some warning.")]

static void Main(string[] args)

{

// ...

}

}

（4）Attribute参数必须是常量

编译器只允许具有编译期限制的参数用于Attribute。这意味着Attribute参数不能是变量、属性或方法返回值。例如：

class Program

{

[Required("foo")]

static void Main(string[] args)

{

// ...

}

}

将产生Compile Error。

结语

在C#中，AttributeUsage是一个非常有用的类，在为程序添加元数据时起到了很大的作用。使用者只需要根据自己的需要设置AttributeUsage的属性，就可以实现标记目标的需求。

在使用AttributeUsage时，需要注意Inherited属性、AllowMultiple属性、ValidOn属性以及命名空间等细节，以保证程序的正确性。同时也可以通过AttributeUsage来简化代码，提高代码的可读性和可维护性。总之，AttributeUsage是C#编程中值得探索的一大亮点。