C# 特性详解

在 C# 中，特性（Attribute）是一种给代码添加额外信息（元数据）的机制。它不会直接改变代码逻辑，而是为类、方法、属性、字段等附加说明，供编译器、运行时、框架或程序员读取和使用。

简单理解：

特性 = 给代码贴标签，让程序知道这段代码有什么特殊说明。

例如：

[Obsolete("这个方法已经过时，请使用NewMethod")] public void OldMethod() { }

这里[Obsolete]就是一个特性，它告诉编译器：

这个方法已经废弃，调用时提醒开发者。

一、为什么需要特性？

假设没有特性：

public class User { public string Name; public int Age; }

程序不知道：

• Name 是否必须填写？
• Age 是否需要验证？
• 这个类是否需要序列化？
• 是否需要映射数据库？
• 是否需要参与权限控制？

如果使用特性：

public class User { [Required] public string Name { get; set; } [Range(0,120)] public int Age { get; set; } }

框架看到：

Name → 必填 Age → 范围0~120

然后自动执行验证。

二、特性的基本语法

1. 特性写法

[特性名称] public class MyClass { }

例如：

[Serializable] public class Person { }

2. 多个特性

[Serializable] [Obsolete] public class Person { }

也可以：

[Serializable, Obsolete] public class Person { }

三、C# 常用内置特性

1. Obsolete（过时提醒）

用于标记废弃代码。

例如：

public class Calculator { [Obsolete] public int Add(int a,int b) { return a+b; } }

调用：

Calculator c=new Calculator(); c.Add(1,2);

提示：

Add方法已经过时

强制报错：

[Obsolete("请使用AddNew",true)] public int Add(int a,int b) { return a+b; }

第二个参数：

false 警告 true 错误

2. Serializable（序列化）

表示对象可以转换为二进制数据。

[Serializable] public class Student { public string Name; public int Age; }

表示：

Student对象 | ↓ 二进制数据

3. Conditional（条件编译）

控制代码是否执行。

#define DEBUG class Test { [Conditional("DEBUG")] public void Log() { Console.WriteLine("测试日志"); } }

如果：

#define DEBUG

存在：

执行。

否则：

方法调用会被忽略。

4. AttributeUsage

用于限制自定义特性使用范围。

例如：

[AttributeUsage(AttributeTargets.Class)] public class MyAttribute:Attribute { }

表示：

只能用于：

[My] class Person { }

不能：

[My] void Test() { }

四、自定义特性（重点）

实际开发中大量使用。

例如：

创建一个：

作者信息特性

第一步：继承 Attribute

public class AuthorAttribute:Attribute { }

规定：

所有特性必须继承：

System.Attribute

第二步：添加属性

public class AuthorAttribute:Attribute { public string Name {get;set;} public string Date {get;set;} }

第三步：使用

[Author(Name="张三",Date="2026")] public class Book { }

五、读取特性（反射）

特性本身不会自动执行。

需要：

Reflection（反射）

例如：

var type=typeof(Book); var attrs=type.GetCustomAttributes(); foreach(var attr in attrs) { Console.WriteLine(attr); }

输出：

AuthorAttribute

读取具体信息：

AuthorAttribute author = (AuthorAttribute)Attribute.GetCustomAttribute( typeof(Book), typeof(AuthorAttribute) ); Console.WriteLine(author.Name);

结果：

张三

六、特性参数类型

特性只能接受：

允许：

✅ 基本类型

int string bool double

✅ 枚举

enum Level { Low, High }

使用：

[My(Level.High)]

✅ Type类型

[Service(typeof(User))]

不能：

❌ 对象

new User()

❌ List

List<string>

七、特性的实际应用

1. ASP.NET Core 路由

例如：

[HttpGet] public IActionResult GetUser() { }

作用：

告诉框架：

这个方法处理GET请求

2. 数据验证

public class User { [Required] public string Name {get;set;} [EmailAddress] public string Email {get;set;} }

框架自动验证。

3. ORM数据库映射

例如：

public class User { [Key] public int Id {get;set;} [Column("user_name")] public string Name {get;set;} }

告诉 ORM：

Id 是主键 Name对应数据库字段 user_name

4. JSON序列化

public class User { [JsonIgnore] public string Password {get;set;} }

结果：

{ "Name":"Tom" }

Password不会输出。

八、特性执行流程

完整过程：

源代码 ↓ [Attribute] ↓ 编译器保存元数据 ↓ 程序集 DLL ↓ 反射读取 ↓ 框架执行对应功能

九、特性 vs 接口

很多初学者容易混淆。

接口：

表示：

你必须拥有某种能力

例如：

interface IFly { void Fly(); }

飞机：

class Plane:IFly { }

特性：

表示：

给你添加说明

例如：

[Flying] class Plane { }

区别：

十、企业开发常见特性体系

学习 C# 后期必须掌握：

基础

Attribute AttributeUsage Reflection

Web开发

[ApiController] [Route] [HttpGet] [Authorize]

数据库

[Key] [Table] [Column] [ForeignKey]

序列化

[JsonProperty] [JsonIgnore] [Serializable]

AOP编程

例如：

[Log] [Transaction] [Cache]

自动实现：

调用前记录日志 执行事务 缓存结果