如何基于EF Core已加载关联实体的查询结果创建DataTable

首先需要明确：你通过Include/ThenInclude配置的关联数据，只有在查询实际执行（调用ToList()、ToArray()等物化方法）后，才会被填充到内存中实体对象的导航属性上，禁止直接对未执行的IQueryable对象做转换操作，否则会触发重复查询、懒加载异常等问题。

第一步：完成关联数据查询加载 #

根据你需要的关联层级编写查询，调用物化方法拿到内存实体集合：

// 单级关联场景
var singleLevelEntities = _context.dbset
    .Include(x => x.RelatedEntity)
    .ToList();

// 多级关联场景
var multiLevelEntities = _context.dbset
    .Include(x => x.RelatedEntity)
        .ThenInclude(c => c.ChildRelatedEntity)
    .ToList();

第二步：通用实体转DataTable方法 #

下面的方法支持自动映射实体值属性，可配置是否展开已加载的单引用类型导航属性，支持控制关联展开的最大深度，适配你加载的多级关联场景：

// 注意需要提前引入以下命名空间
// using System.Data;
// using System.Reflection;
// using System.Collections;

public DataTable BuildDataTableFromEntities<T>(
    IEnumerable<T> sourceEntities, 
    bool expandNavigationProps = false, 
    int maxNavigationDepth = 2)
{
    var resultTable = new DataTable(typeof(T).Name);
    if (sourceEntities == null || !sourceEntities.Any())
        return resultTable;

    // 递归构建表列结构
    void BuildTableColumns(Type entityType, string columnPrefix = "", int currentDepth = 0)
    {
        foreach (var prop in entityType.GetProperties(BindingFlags.Public | BindingFlags.Instance))
        {
            // 判定是否为导航属性：非值类型、非字符串、非二进制字段
            bool isNavigation = !prop.PropertyType.IsValueType
                                && prop.PropertyType != typeof(string)
                                && prop.PropertyType != typeof(byte[]);

            if (isNavigation)
            {
                // 超过展开深度/不需要展开导航属性则跳过
                if (!expandNavigationProps || currentDepth >= maxNavigationDepth)
                    continue;
                // 集合类导航属性（1对多/多对多关联）默认跳过，建议单独建表存储
                if (typeof(IEnumerable).IsAssignableFrom(prop.PropertyType))
                    continue;
                // 递归处理下一级关联实体的属性
                BuildTableColumns(prop.PropertyType, $"{columnPrefix}{prop.Name}_", currentDepth + 1);
            }
            else
            {
                // 处理可空值类型
                Type colType = Nullable.GetUnderlyingType(prop.PropertyType) ?? prop.PropertyType;
                resultTable.Columns.Add($"{columnPrefix}{prop.Name}", colType);
            }
        }
    }

    BuildTableColumns(typeof(T));

    // 递归填充行数据
    foreach (var entity in sourceEntities)
    {
        var dataRow = resultTable.NewRow();
        void FillRowData(object currentObj, string columnPrefix = "", int currentDepth = 0)
        {
            if (currentObj == null) return;
            Type objType = currentObj.GetType();
            
            foreach (var prop in objType.GetProperties(BindingFlags.Public | BindingFlags.Instance))
            {
                bool isNavigation = !prop.PropertyType.IsValueType
                                    && prop.PropertyType != typeof(string)
                                    && prop.PropertyType != typeof(byte[]);

                if (isNavigation)
                {
                    if (!expandNavigationProps || currentDepth >= maxNavigationDepth)
                        continue;
                    if (typeof(IEnumerable).IsAssignableFrom(prop.PropertyType))
                        continue;
                    
                    object navValue = prop.GetValue(currentObj);
                    FillRowData(navValue, $"{columnPrefix}{prop.Name}_", currentDepth + 1);
                }
                else
                {
                    object propValue = prop.GetValue(currentObj) ?? DBNull.Value;
                    dataRow[$"{columnPrefix}{prop.Name}"] = propValue;
                }
            }
        }

        FillRowData(entity);
        resultTable.Rows.Add(dataRow);
    }

    return resultTable;
}

调用方式 #

• 仅需要主实体字段，不需要展开关联属性：

DataTable mainEntityTable = BuildDataTableFromEntities(singleLevelEntities, expandNavigationProps: false);

• 需要展开已加载的多级关联属性：

// 最大展开深度设置为2，匹配你用ThenInclude加载的两级关联
DataTable fullInfoTable = BuildDataTableFromEntities(multiLevelEntities, expandNavigationProps: true, maxNavigationDepth: 2);

优化建议 #

• 如果你只需要关联实体的部分字段，不要全量加载所有属性，建议用Select做投影后再转换，性能更高，也不需要处理复杂的导航属性逻辑：

var projectedData = _context.dbset
    .Include(x => x.RelatedEntity)
        .ThenInclude(c => c.ChildRelatedEntity)
    .Select(x => new 
    {
        x.Id,
        MainEntityName = x.Name,
        RelatedEntityName = x.RelatedEntity.Name,
        ChildRelatedValue = x.RelatedEntity.ChildRelatedEntity.Value
    })
    .ToList();

DataTable projectedTable = BuildDataTableFromEntities(projectedData);

• 对于1对多、多对多的集合类导航属性，不要强行合并到主表中，会产生大量冗余数据，建议单独生成对应子表，通过主外键ID关联即可。
• 转换前必须确认查询已经物化完成，否则访问未加载的导航属性会触发EF Core的懒加载，可能导致上下文释放报错、额外性能开销等问题。

内容的提问来源于stack exchange，提问作者What was THAT