在Visual C＃中定义和使用自己的特性

　自定义特性vs.类的属性

　　在特性和类的属性之间存在着明显相似的地方。这给我们何时，何处应该使用自定义特性带来了困惑。开发者们通常引用一个类的属性，并把属性的值作为自己“特性”，那么属性和特性之间真正的区别在哪里呢？

　　当你定义特性的时候，它和属性没有根本的区别，使用时,可以以相同的方式把它附加到程序集不同的类型上，而不仅仅在类上使用。Table2列举了可以应用特性的所有程序集类型。

　　Table 2:可以应用特性的所有程序集类型。

Type

Assembly

Class

Delegate

Enum

Event

Interface

Method

Module

Parameter

Constructor

Field

Property

ReturnValue

Structure

　　让我们从清单中挑选一个作为例子。你可以在参数上应用特性，这看起来很微小，好像是在给参数添加属性？其实，这是一个新颖的，非常不错的主意，因为你不会用类的属性做这件事。这里也突出了特性和属性之间很大的不同之处，因为属性仅仅是类的一个成员而已。它们不能与一个参数，或者清单中列举的其他类型关联起来，当然，这要把类排除在外。

　　在另外的方面，类的属性被限制在运行的环境下，而特性却没有被限制。通过定义，一个属性就依赖于特定的类，这个属性仅仅可以通过类的实例访问，或者通过该类派生类的实例访问。另一方面，特性却可以应用到任何地方。在assembly类型上应用特性，以检验是否与自定义特性中的相匹配，这对于assembly类型来说，是最适合的了。在下一部分，我将更多的讨论自定义特性类中的ValidOn属性。在面向组件的开发中，这是非常有用的，因为特性的这个特征将更加促进松耦合。

　　特性和属性之间另外的一个不同的地方将涉及到它们各自存储的值。属性成员的值是一个实例化的值，在运行时，是可以被改变的。而特性的值，是在设计时（在源代码里）设定，然后直接把这些特性的值编译成元数据保存到程序集里。之后，你将不能改变这些特性的值。实际上，你已经把这些特性的值，变成硬编码的、只读的数据。

　　考虑一下，你应用特性的时候。举个例子，在一个类定义的时候，给其附加了一个特性，那么该类的每一个实例都会拥有相同的分配给此特性值，而不论你实例化该类的多少个实例。你不能把特性附加到一个类的实例上，你只可以在类型/类的定义上应用特性。

　　创建一个自定义特性类

　　现在，综合以上的描述，我们将演示一个更实际的实现过程。让我们创建一个自定义特性类。该特性会保存一些关于代码修改的跟踪信息，在源代码里，这些都将作为注释。在这个例子里，我们将仅仅记录一些条目：缺陷id，开发者id，修改的日期，导致缺陷的原因，以及有关修正的注释。为了保持例子足够的简单，我们将关注于如何创建一个自定义特性类（DefectTrackAttribute），而该特性类仅被用于类和方法上。

　　DefectTrackAttribute定义的代码如下：

using System; namespace MyAttributeClasses { [AttributeUsage(AttributeTargets.Class|AttributeTargets.Method,AllowMultiple = true)] public class DefectTrackAttribute :Attribute { private string cDefectID ; private DateTime dModificationDate ; private string cDeveloperID ; private string cDefectOrigin ; private string cFixComment ; public DefectTrackAttribute () { } public DefectTrackAttribute( string lcDefectID, string lcModificationDate, string lcDeveloperID ) { this.cDefectID = lcDefectID ; this.dModificationDate = System.DateTime.Parse( lcModificationDate ) ; this.cDeveloperID = lcDeveloperID ; } public string DefectID { get { return cDefectID ; } } public string ModificationDate { get { return dModificationDate.ToShortDateString() ; } } public string DeveloperID { get { return cDeveloperID ; } } public string Origin { get { return cDefectOrigin ; } set { cDefectOrigin = value ; } } public string FixComment { get { return cFixComment ; } set { cFixComment = value ; } } } }

　　如果你之前没有接触过特性，那么你将对下面的代码有点陌生。

[AttributeUsage(AttributeTargets.Class|AttributeTargets.Method,AllowMultiple = true)]

　　这一行代码，把特性[AttributeUsage]附加到特性类的定义上。方括号的语法表明一个特性的构造器被调用。所以，特性类也可以拥有它们自己的特性，这看起来可能有点混淆，但是随着我给你展示可以用特性类来做些什么，你对它的认识，将会越来越清晰。

　　[AttributeUsage]特性具有一个定位参数和两个命名参数。定位参数指定了特性类将被用于何种类型，定位参数的值是枚举AttributeTargets的组合。在我的例子里，我仅仅把特性类应用在类和方法上，所以通过组合两个AttributeTargets的值的满足了我的要求。

　　[AttributeUsage]特性的第一个命名参数是AllowMultiple，该参数指定了是否可以在同一个类型上应用多次（你所定义的）特性类。默认值是false，即不允许应用多次。但是，根据这个例子的实际情况，你将会在某一类型上不止一次的应用特性（DefectTrackAttribute），所以应该使用[AttributeUsage]的命名参数AllowMultiple，并将其设置为true。这是因为，一个特定的类和方法在其生命周期里会经历多次修订，所以你需要使用[DefectTrackAttribute]特性记录每一次变化。

　　[AttributeUsage]特性的第二个命名参数是Inherited，它指定了派生类（使用此特性类的子类）是否继承此特性。我使用了此参数的默认的值false。因为我使用的是默认值，所以也就不需要指定该命名参数。为什么不需要继承呢？我想获取源代码的修改信息是跟每一个具体的类和方法有关的。如果把Inherited设为true，那么开发者将会混淆一个类的[DefectTrackAttribute]特性，无法辨别[DefectTrackAttribute]特性是它自己的还是从父类继承的。

　　上面的代码展示了特性类（DefectTrackAttribute）的定义。它继承于System.Attribute，事实上，所有的特性均直接或间接的继承于System.Attribute。

　　上面的代码里，还定义了特性的5个私有的字段，这些字段均用于保存与特性相关的值。

　　在我们特性类中第一个方法是构造器，它是带有3个参数的签名。构造器的参数对于特性类而言，就是这个特性的定位参数，这些参数是强制性的。如果你愿意，你可以重载构造器，使其可以拥有更多的有关定位参数配置的选择。

　　我们的特性类中剩下的部分就是一些公有属性的声明，这些属性与类中的私有字段相对应。当你查阅元数据的时候，你可以使用这些属性访问该特性的值。需要说明的是，对应定位参数的属性没有set语句，只有get语句。这就导致了这些属性是只读的，这也与它们是定位参数而不是命名参数的含义相一致。