在C#中,Attribute类位于System命名空间下,它是所有特性的基类。特性本质上是一种描述性的元数据,能够附加在程序集、模块、类、方法、属性等目标上,用来向编译器或运行时提供额外信息。与注释不同,特性会被编译进程序集元数据,并且可以通过反射在运行时读取,从而改变程序的行为。

Attribute类的主要用途
Attribute类本身是一个抽象基类,我们通过继承它来创建具体的特性。它的常见用途包括:
- 标记序列化方式,例如指定某个字段不参与JSON序列化
- 实现权限或路由控制,如Web框架中用特性标注接口的访问路径
- 提供代码分析提示,帮助静态检查工具发现潜在问题
如何自定义特性
自定义特性需要创建一个继承Attribute的类,并可使用AttributeUsage来限制使用范围。下面演示一个简单的自定义特性,用来描述某个方法的功能说明。
using System;
// 限制该特性只能用在方法上,且不可重复
[AttributeUsage(AttributeTargets.Method, AllowMultiple = false)]
public class MethodNoteAttribute : Attribute
{
public string Note { get; }
// 构造函数接收描述信息
public MethodNoteAttribute(string note)
{
Note = note;
}
}
// 使用自定义特性
public class Demo
{
[MethodNote("此方法用来计算两个整数之和")]
public int Add(int a, int b)
{
return a + b;
}
}
通过反射读取特性
定义好特性后,我们可以在运行时利用反射获取这些信息,从而实现通用处理逻辑。
using System;
using System.Reflection;
class Program
{
static void Main()
{
var method = typeof(Demo).GetMethod("Add");
var attr = (MethodNoteAttribute)Attribute.GetCustomAttribute(method, typeof(MethodNoteAttribute));
if (attr != null)
{
Console.WriteLine("方法说明:" + attr.Note);
}
}
}
使用内置特性示例
除了自定义,C#也提供了许多内置特性,例如Obsolete用来标记过时成员。
using System;
public class Sample
{
[Obsolete("请使用NewMethod代替")]
public void OldMethod() { }
public void NewMethod() { }
}
注意事项
在自定义特性时,类名通常以Attribute结尾,使用时可以省略后缀。特性的构造函数参数必须是编译期常量,不能传递运行时变量。合理使用特性可以让代码配置与逻辑分离,提升可读性和扩展性。