C# Attribute 特性学习

时间 2019-12-13

标签 c# attribute 特性学习栏目 C# 繁體版

原文原文链接

1、特性的概述

公共语言运行库容许您添加相似关键字的描述性声明（称为特性 (Attribute)）来批注编程元素，如类型、字段、方法和属性 (Property)。属性与 Microsoft .NET Framework 文件的元数据一块儿保存，而且可用于向运行库描述代码或影响应用程序的运行时行为。
特性是一个对象，它能够加载到程序集及程序集的对象中，这些对象包括程序集自己、模块、类、接口、结构、构造函数、方法、方法参，方法的返回值等，加载了特性的对象称做特性的目标。特性是为程序添加元数据(描述数据的数据)的一种机制，经过它能够给编译器提供指示或者提供对数据的说明。
为运行库编译代码时，该代码被转换为 Microsoft 中间语言 (MSIL)，并同编译器生成的元数据一块儿被放到可移植可执行 (PE) 文件的内部。属性 (Attribute) 使您得以向元数据中放置额外的描述性信息，并可以使用运行库反射服务提取该信息。
特性是一个对象，它是一个直接或间接继承System.Attribute的类的对象，只是特性类的实例化和应用方式有点特别，下面会详细说来！

2、应用特性

经过从 .NET Framework 导入属性的命名空间来定义新的属性或使用现有属性。例如：
[Obsolete("请使用新的SendMsg(Message msg)重载方法")]
public static void ShowMsg() {
Console.WriteLine("这是旧的SendMsg()方法");
}
Obsolete特性是一个系统特性，标记再也不使用的程序元素。
经过在紧邻代码元素以前放置属性来将该属性应用于代码元素。特性的使用方法：首先是有一对方括号“[]”，在左方括号“[”后紧跟特性的名称，好比Obsolete，随后是一个圆括号“()”。和普通的类不一样，这个圆括号不光能够写入构造函数的参数，还能够给类的属性赋值，在Obsolete的例子中，仅传递了构造函数参数。当特性应用与程序集和模块时，C#容许以指定的前缀来表示特性所应用的目标元素，建议这样来处理，由于显式处理能够消除可能带来的二义性。例如：
namespace Anytao.net {
    [assembly: MyAttribute(1)]          //应用于程序集
    [moduel: MyAttribute(2)]            //应用于模块
    pubic class Attribute_how2do     {         //略     }
}
为属性指定位置参数和命名参数。
位置参数：构造函数的参数。命名参数：属性做为参数。使用构造函数参数，参数的顺序必须同构造函数声明时的顺序相同，全部在特性中也叫位置参数(Positional Parameters)，与此相应，属性参数也叫作命名参数(Named Parameters)。位置参数是必需的，而且必须放在全部命名参数以前；

三编写自定义

建立自定义类，类名以Attribute结尾（全部特性类都是以Attribute结尾，这是约定俗成的，这样符合微软的命名风格，也符合编译器的搜索规则，但不是必须的），间接或者直接继承System.Attribute类。
在咱们的特性类上应用AttributeUsage系统特性，用于指定咱们的自定义特性的应用目标类型。AttributeUsage特性的位置参数有一个是AttributeTargets枚举位标记类型的，经过它来指定咱们的自定义特性的应用目标。另外还有两个命名参数 AllowMultiple 是否能够将特性重复应用到目标上；Inherited 我们自定义的特性类是否能够被继承。
声明类属性，用于存储咱们要添加的元数据。经过构造函数赋值的属性，设为只读（只有get访问器），其它则为读写属性。这里这样作的目的是，在特性使用的时候，构造函数参数也就是位置参数是必需提供的，而命名参数，也就是为读写属性赋值是可选的，你将若是将位置参数设为读写属性，那它也将出如今命名参数中。
声明构造函数，为只读属性赋值。固然你也能够在里面声明一些方法，只是方法在应用特性的时候无法体现。也能够像普通自定义类同样，调用类的方法。

4、自定义特性范例

假设咱们有这样一个很常见的需求：咱们在建立或者更新一个类文件时，须要说明这个类是何时、由谁建立的，在之后的更新中还要说明在何时由谁更新的，能够记录也能够不记录更新的内容，以往你会怎么作呢？是否是像这样在类的上面给类添加注释：

//更新：Joey, 2013-07-23

//更新：Joey, 2013-07-23，修改bug

//建立：zoe, 2013-07-15

public class DemoClass{

　　// Class Body

}

这样的的确确是能够记录下来，可是若是有一天咱们想将这些记录保存到数据库中做以备份呢？你是否是要一个一个地去查看源文件，找出这些注释，再一条条插入数据库中呢？经过上面特性的定义，咱们知道特性能够用于给类型添加元数据，这些元数据能够用于描述类型。那么在此处，特性应该会派上用场。那么在本例中，元数据应该是：注释类型(“更新”或者“建立”)，修改人，日期，备注信息(无关紧要)。实现代码以下：

 1 namespace Common.Library.ChangeRecord
 2 {
 3     /// <summary>
 4     /// desc:记录 修改记录 的特性
 5     /// </summary>
 6     [AttributeUsage((AttributeTargets)6140, AllowMultiple = true, Inherited = false)]
 7     public class RecordAttribute : Attribute
 8     {
 9         private RecordType recordType;      // 记录类型：更新/建立
10         private string author;          // 做者
11         private DateTime date;          // 更新/建立 日期
12         private string mark;         // 备注
13  
14         // 构造函数，构造函数的参数在特性中也称为“位置参数”。
15         public RecordAttribute(RecordType recordType, string author, string date)
16         {
17             this.recordType = recordType;
18             this.author = author;
19             this.date = Convert.ToDateTime(date);
20         }
21  
22         // 对于位置参数，一般只提供get访问器
23         public RecordType RecordType { get { return recordType; } }
24         public string Author { get { return author; } }
25         public DateTime Date { get { return date; } }
26  
27         // 构建一个属性，在特性中也叫“命名参数”
28         public string Mark
29         {
30             get { return mark; }
31             set { mark = value; }
32         }
33     }
34     /// <summary>
35     /// 记录类型 枚举
36     /// </summary>
37     public enum RecordType
38     {
39         Add,
40         Modify
41     }
42 }

View Code

NOTE：注意构造函数的参数 date，必须为一个常量、Type类型、或者是常量数组，因此不能直接传递DateTime类型。

这个类看上去和普通的类没有和大区别，显然不能它由于名字后面跟了个Attribute就摇身一变成了特性。它知足了，咱们前面所说的自定义特性的要求，继承了System.Attribute类、用AttributeUsage特性限制了应用的目标、有属性和构造函数等。

下面是应用特性：

 1 namespace Common.Library
 2 {
 3     [Record(RecordType.Add, "Joey", "2013-07-23")]
 4     [Record(RecordType.Modify, "Joey", "2013-07-23", Mark = "测试")]
 5     [Record(RecordType.Modify, "Joey", "2013-07-24", Mark = "修改bug")]
 6     public class TestAttribute
 7     {
 8         [Record(RecordType.Add, "Joey", "2013-07-23", Mark = "测试特性附加到方法上")]
 9         [Record(RecordType.Add, "Shovy", "2013-07-25", Mark = "修改此方法")]
10         public void MyMethod()
11         {
12         }
13  
14         [Record(RecordType.Add, "Joey", "2013-07-23", Mark = "方法2")]
15         [Record(RecordType.Add, "Zoe", "2013-07-25", Mark = "修改方法2")]
16         public void Method2()
17         {
18         }
19     }
20 }

View Code

这样一个自定义特性就写好了，也应用到目标元素上了。前面咱们说了特性是给目标类型添加描述性的元数据，它不会影响代码的运行。上面代码编译后，咱们特性所添加的信息已经做为元数据添加到了程序集中。能够经过IL DASM看到：

5、使用反射查看自定义特性

特性通常是和反射结合使用的，你只附加了特性你不去获取它，也没有任何意义。而获取类型上的特性信息，是经过反射来实现的。在这以前咱们有必要先了解下System.Attribute这个特性基类。

System.Attribute:

protected Attribute(): 保护的构造器，只能被Attribute的派生类调用。
三个静态方法： static Attribute GetCustomAttribute():这个方法有8种重载的版本，它被用来取出施加在类成员上指定类型的Attribute。 static Attribute[] GetCustomAttributes(): 这个方法有16种重载版本，用来取出施加在类成员上指定类型的Attribute数组。 static bool IsDefined():由八种重载版本，看是否指定类型的定制attribute被施加到类的成员上面。
实例方法： bool IsDefaultAttribute(): 若是Attribute的值是默认的值，那么返回true。 bool Match():代表这个Attribute实例是否等于一个指定的对象。
公共属性： TypeId: 获得一个惟一的标识，这个标识被用来区分同一个Attribute的不一样实例。咱们简单地介绍了Attribute类的方法和属性，还有一些是从object继承来的。这里就不列出来了。

下面的代码是检测上面咱们自定义的特性的应用：

 1 namespace ConsoleApp
 2 {
 3     class Program
 4     {
 5         static void Main(string[] args)
 6         {
 7             TestAttribute testClass = new TestAttribute();
 8             Type type = testClass.GetType(); //获取要得到自定义特性的类型的Type对象
 9             Attribute[] myAttributes = Attribute.GetCustomAttributes(type);//获取类型上添加的自定义特性
10             Console.WriteLine("类型{0}上应用的Record特性：", type.ToString());
11             Console.WriteLine();
12             foreach (Attribute item in myAttributes)
13             {
14                 if (item.GetType() == typeof(RecordAttribute)) //只打印咱自定义的特性
15                 {
16                     RecordAttribute attr = (RecordAttribute)item;
17                     Console.WriteLine("  类型：{0}，更改人：{1}，更改时间：{2}，备注：{3}", attr.RecordType, attr.Author, attr.Date.ToString("yyyy-MM-dd"), attr.Mark);
18                 }
19             }
20             Console.WriteLine();
21             Console.WriteLine("类型{0}的方法上应用的Record特性：", type.ToString());
22             Console.WriteLine();
23             foreach (MethodInfo mInfo in type.GetMethods()) //遍历该类型的全部方法
24             {
25                 if (Attribute.IsDefined(mInfo, typeof(RecordAttribute))) //只有在方法上附加了属性，才遍历
26                 {
27                     Console.WriteLine("  类型{0}的{1}方法上的Record特性", type.ToString(), mInfo.ToString());
28                     Console.WriteLine();
29                     foreach (Attribute item in Attribute.GetCustomAttributes(mInfo)) //遍历方法上的 特性
30                     {
31                         if (item.GetType() == typeof(RecordAttribute))
32                         {
33                             RecordAttribute attr = (RecordAttribute)item;
34                             Console.WriteLine("    类型：{0}，更改人：{1}，更改时间：{2}，备注：{3}", attr.RecordType, attr.Author, attr.Date.ToString("yyyy-MM-dd"), attr.Mark);
35                         }
36                     }
37                     Console.WriteLine();
38                 }
39             }
40         }
41     }}

View Code

运行效果以下图所示：

获取自定义特性的方法二：

首先基于类型(本例中是DemoClass)获取一个Type对象，而后调用Type对象的GetCustomAttributes()方法，获取应用于该类型上的特性。
当指定GetCustomAttributes(Type attributeType, bool inherit) 中的第一个参数attributeType时，
将只返回指定类型的特性，不然将返回所有特性；第二个参数指定是否搜索该成员的继承链以查找这些属性。

代码以下：

 1 namespace ConsoleApp
 2 {
 3     class Program
 4     {
 5         static void Main(string[] args)
 6         {
 7             TestAttribute testClass = new TestAttribute();
 8             Type type = testClass.GetType();
 9             object[] records = type.GetCustomAttributes(typeof(RecordAttribute), false); //获取类型上的特性
10             Console.WriteLine("类型{0}上应用的Record特性：", type.ToString());
11             Console.WriteLine();
12             foreach (RecordAttribute record in records)
13             {
14                 Console.WriteLine("  类型：{0}，更改人：{1}，更改时间：{2}，备注：{3}", record.RecordType, record.Author, record.Date.ToString("yyyy-MM-dd"), record.Mark);
15             }
16             Console.WriteLine();
17             Console.WriteLine("类型{0}的方法上应用的Record特性：", type.ToString());
18             Console.WriteLine();
19             foreach (MethodInfo mInfo in type.GetMethods()) //遍历该类型的全部方法
20             {
21                 if (Attribute.IsDefined(mInfo, typeof(RecordAttribute))) //只有在方法上附加了属性，才遍历
22                 {
23                     Console.WriteLine("  类型{0}的{1}方法上的Record特性", type.ToString(), mInfo.ToString());
24                     Console.WriteLine();
25                     foreach (RecordAttribute record in mInfo.GetCustomAttributes(typeof(RecordAttribute), false)) //遍历方法上的 特性
26                     {
27                         Console.WriteLine("    类型：{0}，更改人：{1}，更改时间：{2}，备注：{3}", record.RecordType, record.Author, record.Date.ToString("yyyy-MM-dd"), record.Mark);
28                     }
29                     Console.WriteLine();
30                 }
31             }
32         }
33     }
34 }

View Code

两种方法运行的结果是同样的，如上图。这两种方法的区别在与，第一种方法是用的Atrribute基类的静态方法获取对应类型的自定义特性的集合。而第二种方案是使用的Type类型的方法获取的。
demo下载:点击这里下载代码
资料：

http://www.cnblogs.com/JimmyZhang/archive/2008/01/27/1055254.htmlhtml

Attribute在.net编程中的应用（一）

Attribute在.net编程中的应用（二）

Attribute在.net编程中的应用（三）

Attribute在.net编程中的应用（四）

Attribute在.net编程中的应用（五）

C# Attribute 特性 学习

C# Attribute 特性学习