Attribute是一种可由用户自有定义的修饰符(Modifier),可以用来修饰各种需要被修饰的目标,修饰符(比如private、public、static、override、virtual等等)是C#语言本身的关键字。
简单地说,Attribute就是一种“附着物”——就像牡蛎吸附在船底或礁石上一样。
这些附着物的作用是为它们的附着体追加上一些额外的信息(这些信息保存在附着物的体内)——比如“这个类是我写的”或者“这个函数以前出过问题”等等。
Attribute的作用是为元数据添加内容。
元数据可以被工具支持,比如:编译器用元数据来辅助编译,调试器用元数据来调试程序。
注释是对程序源代码的一种说明,主要目的是给人看的,在程序被编译的时候会被编译器所丢弃,因此,它丝毫不会影响到程序的执行。
Attribute是程序代码的一部分,它不但不会被编译器丢弃,而且还会被编译器编译进程序集(Assembly)的元数据(Metadata)里。在程序运行的时候,你随时可以从元数据中提取提取出这些附加信息,并以之决策程序的运行。
在项目中,某个类由两个程序员(小张和小李)共同维护。这个类起到了“工具包”(Utilities)的作用,里面包含几十个静态方法,就像.Net Framework中的Math类一样。这些静态方法,一半是小张写的、一半是小李写的;在项目的测试中,有一些静态方法曾经出过bug,后来又被修正。
我们可以把这些方法分成这样几类:
我们分类的目的主要是在测试的时候可以按照不同的类别进行测试、获取不同的效果。比如:统计两个人的工作量或者对曾经出过bug的方法进行回归测试。
public static void Li_Buged_FuncA(){ }
public static void Li_NoBug_FuncB(){ }
public static void Zhang_Buged_FuncC(){ }
public static void Zhang_NoBug_FuncD(){ }
//或
//Created by Li,Buged
public static void FuncA(){ }
//Created by Li,NoBug
public static void FuncB(){ }
//Created by Zhang,Buged
public static void FuncC(){ }
//Created by Zhang,NoBug
public static void FuncD(){ }
#define Buged //C#的宏定义必须在所有代码之前。当前只让Buged宏有效
//#define NoBug
//#define Li
//#define Zhang
using System;
using System.Diagnostics;//注意:ConditionalAttribute特性包含在此命名空间中
namespace AttributeTest
{
class Program
{
static void Main(string[] args)
{
ToolKit.FuncA();
ToolKit.FuncB();
ToolKit.FuncC();
ToolKit.FuncD();
Console.ReadKey();
}
}
public class ToolKit
{
[ConditionalAttribute("Li")]//Attribute名称的长记法
[ConditionalAttribute("Buged")]
public static void FuncA()
{
Console.WriteLine("Created by Li, Buged");
}
[Conditional("Li")]//Attribute名称的短记法
[Conditional("NoBug")]
public static void FuncB()
{
Console.WriteLine("Created by Li, NoBug");
}
[Conditional("Zhang")]
[Conditional("Buged")]
public static void FuncC()
{
Console.WriteLine("Created by Zhang, Buged");
}
[Conditional("Zhang")]
[Conditional("NoBug")]
public static void FuncD()
{
Console.WriteLine("Created by Zhang, NoBug");
}
}
}
当类Program在Program.cs文件中,类ToolKit在ToolKit.cs文件中时,#define Buged需要在Program.cs文件头部和ToolKit.cs文件头部均定义,示例代码如下:
#define Buged //C#的宏定义必须在所有代码之前。当前只让Buged宏有效
//#define NoBug
//#define Li
//#define Zhang
using System;
using System.Diagnostics;
namespace AttributeTest
{
class Program
{
static void Main(string[] args)
{
ToolKit.FuncA();
ToolKit.FuncB();
ToolKit.FuncC();
ToolKit.FuncD();
Console.ReadKey();
}
}
}
#define Buged //C#的宏定义必须在所有代码之前。当前只让Buged宏有效
//#define NoBug
//#define Li
//#define Zhang
using System;
using System.Diagnostics;
namespace AttributeTest
{
public class ToolKit
{
[Conditional("Li")]
[Conditional("Buged")]
public static void FuncA()
{
Console.WriteLine("Created by Li, Buged");
}
[Conditional("Li")]
[Conditional("NoBug")]
public static void FuncB()
{
Console.WriteLine("Created by Li, NoBug");
}
[Conditional("Zhang")]
[Conditional("Buged")]
public static void FuncC()
{
Console.WriteLine("Created by Zhang, Buged");
}
[Conditional("Zhang")]
[Conditional("NoBug")]
public static void FuncD()
{
Console.WriteLine("Created by Zhang, NoBug");
}
}
}
运行结果如下:
注意:运行结果是由代码中“#define Buged ”这个宏定义所决定。
1、在本例中,我们使用了ConditionalAttribute这个Attribute,它被包含在System.Diagnostics命名空间中,多半时间是用来做程序调试与诊断的。
2、与ConditionalAttribute相关的是一组C#宏,它们看起来与C语言的宏别无二致,位置必须在所有C#代码之前。顾名思义,ConditionalAttribute是用来判断条件的,凡被ConditionalAttribute(或Conditional)”附着”了的方法,只有满足了条件才会执行。
3、就像船底上可以附着很多牡蛎一样,一个方法上也可以附着多个ConditionalAttribute的实例。把Attribute附着在目标上的书写格式很简单,使用方括号把Attribute括起来,然后紧接着写Attribute的附着体即可。当多个Attribute附着在同一个目标上时,就把这些Attribute的方括号一个挨一个地书写(或者在一对方括号中书写多个Attribute),而且不必在乎它们的顺序。
4、在使用Attribute的时候,有“长记法”和“短记法”两种。
由上面的第三条和第四条我们可以推出,以下四种Attribute的使用方式完全等价:
//长记法
[ConditionalAttribute("Li")]
[ConditionalAttribute("NoBug")]
public static void Func()
{Console.WriteLine("Created by Li, NoBug"); }
//短记法
[Conditional("Li")]
[Conditional("NoBug")]
public static void Func()
{Console.WriteLine("Created by Li, NoBug"); }
//换序
[Conditional("NoBug")]
[Conditional("Li")]
public static void Func()
{Console.WriteLine("Created by Li, NoBug"); }
//单括号叠加
[Conditional("NoBug"),Conditional("Li")]
public static void Func()
{Console.WriteLine("Created by Li, NoBug"); }