C#怎么自定义特性 C# Attribute的定义和使用场景-C#.Net教程-PHP中文网

C#怎么自定义特性 C# Attribute的定义和使用场景

小老鼠

发布： 2025-11-18 11:15:34

原创

175人浏览过

自定义特性是继承Attribute的类，用于添加元数据并结合反射在运行时读取。1. 定义时使用[AttributeUsage]指定目标、是否允许多次使用及继承性；2. 应用时以[特性名]标记类、方法等；3. 通过反射获取特性实例并处理。典型场景包括日志监控、权限验证、序列化控制、MVC路由过滤、数据校验和AOP编程。命名建议以"Attribute"结尾，使用时可省略后缀，构造函数传必填参数，属性设可选值，保持特性轻量不可变，合理配置AttributeUsage。

c#怎么自定义特性 c# attribute的定义和使用场景

在 C# 中，自定义特性（Custom Attribute） 是一种允许你在代码中添加元数据的机制。这些元数据可以在运行时通过反射读取，用于控制程序行为、标记类或方法用途、实现 AOP（面向切面编程）、序列化控制等场景。

一、如何定义自定义特性

自定义特性本质上是一个继承自 System.Attribute 的类。你可以通过以下步骤创建：

1. 创建特性类

使用 [AttributeUsage] 指定该特性可以应用的目标（如类、方法、属性等）：

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
public class LogActionAttribute : Attribute
{
    public string Description { get; set; }
    public bool Enabled { get; set; }
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">public LogActionAttribute(string description)
{
    Description = description;
    Enabled = true;
}

登录后复制

}

AttributeTargets：指定能应用此特性的程序元素，比如 Class、Method、Property 等。
AllowMultiple：是否允许多次应用于同一目标。
Inherited：是否被派生类或重写成员继承。

2. 应用自定义特性

将特性添加到类、方法或其他支持的目标上：

[LogAction("用户登录操作", Enabled = true)]
public class LoginService
{
    [LogAction("验证用户名密码")]
    public bool ValidateUser(string username, string password)
    {
        return !string.IsNullOrEmpty(username);
    }
}

登录后复制

3. 在运行时读取特性信息（使用反射）

通过反射获取类型或成员上的特性，并进行相应处理：

var method = typeof(LoginService).GetMethod("ValidateUser");
var attr = method.GetCustomAttribute<LogActionAttribute>();
<p>if (attr != null && attr.Enabled)
{
Console.WriteLine($"正在执行: {attr.Description}");
}

登录后复制