定义/控制自定义属性的使用

AttributeUsage类是一个预定义的属性类,以帮助我们控制自定义属性的使用.也就是我们可以定义自定义属性类的属性.这个类描述了如何使用自定义的属性类.AttributeUsage有三个数据属性可用以修饰我们的自定义的属性.

ValidOn 定义了自定义属性在哪些程序实体上可被使用.这个可使用实体列表可通过 AttributeTargets枚举类型的OR操作进行设置

AllowMutiple 定义了是否可在同一个程序实体上同时使用多个属性进行修饰

Inherited 定义了自定义的修饰是否可由被修饰类的派生类继承

　　让我们做点具体的吧。我们将会用一个AttributeUsage属性修饰我们的属性类，以控制其作用范围：

using System;
[AttributeUsage(AttributeTargets.Class), AllowMultiple = false, Inherited = false ]
public class HelpAttribute : Attribute
{
    public HelpAttribute(String Description_in)
    {
        this.description = Description_in;
    }
    protected String description;
    public String Description
    {
        get 
        {
            return this.description;
        }            
    }    
}

　　先看看AttributeTargets.Class，说明了我们的Help属性只能用以修饰类，下面的这段代码将会导致一个编译错误(“属性Help不能用在这样的声明上，它只能用在类的声明上”)，因为我们用Help属性去修饰方法AnyMethod()了：

[Help("this is a do-nothing class")]
public class AnyClass
{
    [Help("this is a do-nothing method")]    //error
    public void AnyMethod()
    {
    }
}

编译错误：

AnyClass.cs: Attribute ''Help'' is not valid on this declaration type. 
It is valid on ''class'' declarations only.

　　当然我们可以AttributeTargets.All来允许Help属性修饰任何类型的程序实体。AttributeTargets可能的值包括：

Assembly,
Module,
Class,
Struct,
Enum,
Constructor,
Method,
Property,
Field,
Event,
Interface,
Parameter,
Delegate,
All = Assembly | Module | Class | Struct | Enum | Constructor | Method | Property | Field | Event | Interface | Parameter | Delegate,
ClassMembers = Class | Struct | Enum | Constructor | Method | Property | Field | Event | Delegate | Interface )

　　接下来，该看看AllowMultiple = false这句了：它确定了不能象下面这样，在同一实体上同时使用多个同种属性进行修饰：

[Help("this is a do-nothing class")]
[Help("it contains a do-nothing method")]
public class AnyClass
{
    [Help("this is a do-nothing method")]        //这也是错误的，因为Help属性只能修饰类
    public void AnyMethod()
    {
    }
}

编译错误：

      AnyClass.cs: Duplicate ''Help'' attribute

　　我们再来谈谈AttributeUsage的最后一个数据属性Inherited：定义了自定义属性的修饰是否可由被修饰类的派生类继承。基于下示代码表示的继承关系，让我们看看会发生什么吧：

[Help("BaseClass")] 
public class Base
{
}

public class Derive :  Base
{
}

我们选择了AttributeUsage的四种组合：

[AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false ]
[AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = false ]
[AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = true ]
[AttributeUsage(AttributeTargets.Class, AllowMultiple = true, Inherited = true ]

对应上述组合的结果：

如果我们查询(稍后我们会看见如何在运行时查询一个类的属性信息。)这个Derive类的Help属性时，会因其未从基类继承该属性而一无所获。
因为同样的原因，得到与结果一同样的结果。
为了解释这后面的两种情况，我们把同样的属性也用在这个Derive派生类上，代码修改如下：

[Help("BaseClass")] 
public class Base
{
}

[Help("DeriveClass")] 
public class Derive :  Base
{
}

我们的查询会同时得到其类Base与派生类Dervie的Help属性信息，因为继承与多重修饰均被允许。

注意：
　　AttributeUsage只能用于System.Attribute的派生类，且该派生类的AllowMultiple与Inherited都为false。