如何在C#中约束泛型函数的Dictionary参数匹配类的键值？

核心思路 #

由于Dictionary的键是对应JsonProperty的字符串名称，值的类型是T类中各属性的不同类型，无法通过泛型参数直接约束Dictionary的类型（泛型参数要求固定类型），因此只能用Dictionary<string, object>作为参数，再通过反射在函数内部验证键值对是否符合T类的JsonProperty规则。

具体实现步骤 #

• 1. 提取T类中所有标记了[JsonProperty]的属性，映射其JsonProperty名称与属性类型
• 2. 遍历传入的Dictionary，验证每个键是否属于合法的JsonProperty名称，且值的类型与对应属性匹配
• 3. 执行业务逻辑（比如将Dictionary转换为T实例）

完整代码示例 #

首先定义带JsonProperty标记的实体类：

using Newtonsoft.Json;

public class MyJsonClass
{
    [JsonProperty("name")]
    public string Name { get; set; }

    [JsonProperty("age")]
    public int Age { get; set; }

    [JsonProperty("is_active")]
    public bool IsActive { get; set; }
}

实现泛型Get函数：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Reflection;
using Newtonsoft.Json;

public static class DictionaryHelper
{
    public static T Get<T>(Dictionary<string, object> data) where T : new()
    {
        // 构建JsonProperty名称到属性的映射
        var propertyMap = typeof(T)
            .GetProperties(BindingFlags.Public | BindingFlags.Instance)
            .Select(p => new
            {
                Property = p,
                JsonName = p.GetCustomAttribute<JsonPropertyAttribute>()?.PropertyName ?? p.Name
            })
            .ToDictionary(x => x.JsonName, x => x.Property);

        // 验证键的合法性与值的类型匹配
        foreach (var kvp in data)
        {
            if (!propertyMap.ContainsKey(kvp.Key))
            {
                throw new ArgumentException($"非法键：{kvp.Key}，允许的键为：{string.Join(", ", propertyMap.Keys)}");
            }

            var targetType = propertyMap[kvp.Key].PropertyType;
            var underlyingType = Nullable.GetUnderlyingType(targetType) ?? targetType;

            if (kvp.Value != null && !underlyingType.IsAssignableFrom(kvp.Value.GetType()))
            {
                throw new ArgumentException($"键{kvp.Key}的值类型不匹配，预期：{targetType.Name}，实际：{kvp.Value.GetType().Name}");
            }
        }

        // 将Dictionary转换为T实例（可替换为你的业务逻辑）
        var result = new T();
        foreach (var kvp in data)
        {
            var property = propertyMap[kvp.Key];
            var value = kvp.Value == null ? null : Convert.ChangeType(kvp.Value, property.PropertyType);
            property.SetValue(result, value);
        }

        return result;
    }
}

使用示例 #

// 合法数据测试
var validData = new Dictionary<string, object>
{
    { "name", "Alice" },
    { "age", 30 },
    { "is_active", true }
};

var myObj = DictionaryHelper.Get<MyJsonClass>(validData);
Console.WriteLine($"Name: {myObj.Name}, Age: {myObj.Age}, IsActive: {myObj.IsActive}");

// 非法数据测试（会抛出异常）
var invalidData = new Dictionary<string, object>
{
    { "name", "Bob" },
    { "invalid_key", "test" }
};
DictionaryHelper.Get<MyJsonClass>(invalidData);

补充说明 #

• 若使用System.Text.Json，只需将JsonPropertyAttribute替换为JsonPropertyNameAttribute，反射逻辑保持一致
• 如需编译时强约束，可通过源生成器生成对应T的强类型字典包装类，但实现复杂度较高，多数场景下运行时验证已足够
• 代码已处理可空类型（如int?）的适配逻辑

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