C#多特性叠加与解析（深入理解自定义特性在.NET中的组合使用与反射提取）

一、什么是C#特性？

特性是继承自 System.Attribute 的类，用于为程序元素添加声明式信息。例如，[Serializable]、[Obsolete] 都是内置特性。

二、允许多特性叠加的关键：AllowMultiple

默认情况下，C#不允许在同一目标上重复使用同一个特性。要实现C#多特性叠加，必须在自定义特性上设置 AttributeUsage 的 AllowMultiple = true。

using System;[AttributeUsage(AttributeTargets.Method, AllowMultiple = true)]public class LogAttribute : Attribute{    public string Message { get; }    public int Level { get; }    public LogAttribute(string message, int level = 1)    {        Message = message;        Level = level;    }}  

上面的 LogAttribute 特性设置了 AllowMultiple = true，因此可以在同一个方法上多次使用。

三、实际应用：叠加多个特性

下面我们在一个方法上叠加多个 LogAttribute：

public class Calculator{    [Log("开始计算加法", Level = 1)]    [Log("记录用户操作", Level = 2)]    [Log("安全审计日志", Level = 3)]    public int Add(int a, int b)    {        return a + b;    }}  

四、通过反射解析多特性

要读取这些叠加的特性，我们需要使用C#反射获取特性。关键方法是 GetCustomAttributes 或 GetCustomAttributesData。

using System;using System.Linq;using System.Reflection;class Program{    static void Main()    {        var method = typeof(Calculator).GetMethod(nameof(Calculator.Add));                // 获取所有 LogAttribute 实例        var logs = method.GetCustomAttributes<LogAttribute>(inherit: false);        Console.WriteLine($"方法 '{method.Name}' 上有 {logs.Count()} 个 LogAttribute:");        foreach (var log in logs)        {            Console.WriteLine($" - 消息: {log.Message}, 级别: {log.Level}");        }    }}  

运行结果：

方法 'Add' 上有 3 个 LogAttribute: - 消息: 开始计算加法, 级别: 1 - 消息: 记录用户操作, 级别: 2 - 消息: 安全审计日志, 级别: 3  

五、高级技巧：混合不同类型特性

除了同类型多特性叠加，你还可以在同一个成员上使用多种不同特性的组合，例如同时使用 [Log] 和 [Authorize]（假设后者是你定义的权限控制特性）。这在构建框架（如Web API）时非常常见。

六、总结

通过合理使用 AttributeUsage(AllowMultiple = true)，我们可以实现C#多特性叠加；再结合反射技术，就能在运行时动态解析这些元数据，从而实现灵活的日志、验证、权限控制等横切关注点。这种模式广泛应用于现代C#框架中，是提升代码可维护性和扩展性的关键技巧之一。

希望本教程能帮助你掌握自定义特性应用的核心思想。动手试试吧！