如何在C#的Attribute类中使用Dictionary<string, object>作为参数？

C# 特性（Attribute）的参数必须为编译时常量，仅支持基础数据类型、枚举、Type类型，以及上述类型的一维数组。Dictionary<string, object> 属于动态引用类型，不符合特性参数的类型约束，因此会抛出CS0181错误。

方案1：使用参数数组间接构造Dictionary #

在构造函数中接收交替排列的键值参数数组，内部自动转换为Dictionary，适合配置键不固定的场景，代码示例：

[AttributeUsage(AttributeTargets.All)]
public class TestAttribute: Attribute
{
    public string cName{ get; private set; }
    public string oName { get; private set; }
    public string aUser { get; private set; }
    public Dictionary<string, object> Settings { get; private set; }

    public TestAttribute(string cName, string oName, string aUser = null,
        params object[] keyValuePairs)
    {
        this.cName= cName;
        this.oName= oName;
        this.aUser = aUser ;
        // 构造Settings字典
        Settings = new Dictionary<string, object>();
        if (keyValuePairs.Length % 2 != 0)
            throw new ArgumentException("键值对参数必须为偶数个，格式为key1,value1,key2,value2...");
        for (int i = 0; i < keyValuePairs.Length; i += 2)
        {
            if (keyValuePairs[i] is not string key)
                throw new ArgumentException("奇数位参数必须为string类型的键");
            Settings.Add(key, keyValuePairs[i + 1]);
        }
    }
}

使用示例：

// 按 键1,值1,键2,值2 的顺序传入参数即可
[Test("类名", "对象名", "admin", "maxCount", 10, "enable", true, "remark", "测试")]

方案2：使用JSON字符串传递配置 #

如果配置结构比较复杂，可以直接传JSON格式字符串，构造函数内部反序列化为Dictionary，代码示例：

[AttributeUsage(AttributeTargets.All)]
public class TestAttribute: Attribute
{
    public string cName{ get; private set; }
    public string oName { get; private set; }
    public string aUser { get; private set; }
    public Dictionary<string, object> Settings { get; private set; }

    public TestAttribute(string cName, string oName, string aUser = null,
        string settingsJson = null)
    {
        this.cName= cName;
        this.oName= oName;
        this.aUser = aUser ;
        if (!string.IsNullOrEmpty(settingsJson))
        {
            // 可根据项目情况选择System.Text.Json或者Newtonsoft.Json做反序列化
            Settings = System.Text.Json.JsonSerializer.Deserialize<Dictionary<string, object>>(settingsJson);
        }
    }
}

使用示例：

[Test("类名", "对象名", settingsJson: "{\"maxCount\":10,\"enable\":true,\"remark\":\"测试\"}")]

方案3：拆分配置为独立属性 #

如果配置的键是固定可枚举的，最稳妥的方案是直接把每个配置项拆成特性的独立属性，使用时通过命名参数赋值，代码示例：

[AttributeUsage(AttributeTargets.All)]
public class TestAttribute: Attribute
{
    public string cName{ get; private set; }
    public string oName { get; private set; }
    public string aUser { get; private set; }
    // 拆分原来的Settings配置为独立属性
    public int MaxCount { get; set; }
    public bool Enable { get; set; }
    public string Remark { get; set; }

    public TestAttribute(string cName, string oName, string aUser = null)
    {
        this.cName= cName;
        this.oName= oName;
        this.aUser = aUser ;
    }
}

使用示例：

[Test("类名", "对象名", MaxCount = 10, Enable = true, Remark = "测试")]

内容的提问来源于stack exchange，提问作者user3535843