EF Core 6如何动态构建LINQ表达式实现DTO字段的SELECT查询

针对你在EF Core 6中需要动态选择查询字段的需求，这里提供一种基于表达式树的强类型方案，完全避免硬编码索引和字符串列名，直接生成Query.Select(topic => new TopicDTO { ... })形式的LINQ表达式。

核心思路 #

通过自定义特性标记DTO与实体的属性映射，结合表达式树动态构建DTO初始化逻辑，最终生成EF Core可解析的Select Lambda表达式。全程使用nameof而非魔法字符串，保证编译时类型安全。

步骤1：定义属性映射特性 #

先创建一个特性，用来标记DTO属性对应的实体属性：

[AttributeUsage(AttributeTargets.Property)]
public class MapToEntityPropertyAttribute : Attribute
{
    public string EntityPropertyName { get; }
    public MapToEntityPropertyAttribute(string entityPropertyName)
    {
        EntityPropertyName = entityPropertyName;
    }
}

步骤2：标记DTO属性 #

在你的TopicDTO中用特性指定对应实体的属性（如果属性名完全一致，后续可以跳过特性直接用同名映射）：

public class TopicDTO
{
    [MapToEntityProperty(nameof(Topic.Comp1))]
    public string TheComp1 { get; set; }

    [MapToEntityProperty(nameof(Topic.Comp2))]
    public int? TheComp2 { get; set; }

    // 更多属性...
}

步骤3：编写通用动态Select扩展方法 #

实现一个通用的Queryable扩展方法，动态构建Select表达式：

using System.Linq.Expressions;
using System.Reflection;

public static class QueryableDynamicSelectExtensions
{
    public static IQueryable<TDto> SelectDynamic<TSource, TDto>(this IQueryable<TSource> query, IEnumerable<string> includedDtoProperties)
    {
        var sourceType = typeof(TSource);
        var dtoType = typeof(TDto);

        // 筛选出需要包含的DTO属性
        var targetDtoProps = dtoType.GetProperties(BindingFlags.Public | BindingFlags.Instance)
            .Where(prop => includedDtoProperties.Contains(prop.Name))
            .ToList();

        if (!targetDtoProps.Any())
            throw new ArgumentException("必须指定至少一个要查询的DTO属性");

        // 创建参数表达式：TSource topic
        var sourceParam = Expression.Parameter(sourceType, "topic");
        var bindings = new List<MemberBinding>();

        foreach (var dtoProp in targetDtoProps)
        {
            // 获取映射的实体属性名（优先用特性，无特性则默认同名）
            var mapAttr = dtoProp.GetCustomAttribute<MapToEntityPropertyAttribute>();
            string entityPropName = mapAttr?.EntityPropertyName ?? dtoProp.Name;

            // 获取实体对应的属性
            var entityProp = sourceType.GetProperty(entityPropName, BindingFlags.Public | BindingFlags.Instance);
            if (entityProp == null)
                throw new InvalidOperationException($"实体{sourceType.Name}中不存在属性{entityPropName}");

            // 构建实体属性访问表达式：topic.Comp1
            var entityPropAccess = Expression.Property(sourceParam, entityProp);

            // 处理类型转换（如果DTO与实体属性类型不一致）
            if (dtoProp.PropertyType != entityProp.PropertyType)
                entityPropAccess = Expression.Convert(entityPropAccess, dtoProp.PropertyType);

            // 构建DTO属性绑定：TheComp1 = topic.Comp1
            bindings.Add(Expression.Bind(dtoProp, entityPropAccess));
        }

        // 构建DTO初始化表达式：new TopicDTO { ... }
        var dtoNewExpr = Expression.New(dtoType);
        var memberInitExpr = Expression.MemberInit(dtoNewExpr, bindings);

        // 生成最终的Lambda表达式：topic => new TopicDTO { ... }
        var selectLambda = Expression.Lambda<Func<TSource, TDto>>(memberInitExpr, sourceParam);

        // 应用到Queryable
        return query.Select(selectLambda);
    }
}

步骤4：使用示例 #

在业务代码中动态指定要查询的DTO字段，直接调用扩展方法即可：

// 假设你的DbContext中有Topics集合
using var dbContext = new YourDbContext();

// 动态指定需要查询的DTO属性（可以从配置/前端参数等动态获取）
var includedProperties = new List<string>
{
    nameof(TopicDTO.TheComp1),
    nameof(TopicDTO.TheComp2)
};

// 执行动态查询，EF Core会自动生成只包含所需列的SQL
var result = dbContext.Topics
    .SelectDynamic<Topic, TopicDTO>(includedProperties)
    .ToList();

方案优势 #

1. 强类型安全：全程使用nameof和反射获取属性，避免字符串拼写错误，编译时即可发现问题。
2. EF Core友好：生成的表达式树能被EF Core完全解析，生成最优的SQL查询（仅选择所需列），不会出现无法转译的情况。
3. 灵活性高：支持任意实体与DTO的映射，可动态调整查询字段，无需修改硬编码逻辑。

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