EF Core IncludeFilter怎么用 EF Core筛选性加载关联数据

来源:这里教程网 时间:2026-02-21 17:34:45 作者:

EF Core 本身没有内置的

IncludeFilter
方法,但自 EF Core 5.0 起,官方支持在
Include()
中结合
Where
OrderBy
等操作符实现**筛选性加载关联数据**(也称“过滤的包含”)。这个功能常被开发者误称为
IncludeFilter
,实际是通过
Include().ThenInclude().Where()
链式表达式完成的。

用 Include + Where 实现关联数据筛选

默认

Include(b => b.Posts)
会加载博客下所有文章。如果只想加载「已发布」的文章,不能直接写
.Include(b => b.Posts.Where(p => p.IsPublished))
(语法错误),而要使用
Include
的扩展方式:

对集合导航属性(如
List<post></post>
):用
Include(...).Where(...)
形式
需引用
Microsoft.EntityFrameworkCore
命名空间
必须配合
AsSplitQuery()
或启用全局分割查询,否则可能触发笛卡尔积

示例:只加载辽宁省下「状态为启用」的市级数据

var provinces = context.Provinces
    .Where(p => p.Name == "辽宁省")
    .Include(p => p.Cities)
        .ThenInclude(c => c.Districts)
    .Include(p => p.Cities)
        .Where(c => c.Status == true) // ← 关键:筛选 Cities 集合
    .AsSplitQuery() // 推荐加上,避免结果膨胀
    .ToList();

多级筛选:ThenInclude 后接 Where

若需对更深层级做筛选(比如只加载某市下「2024 年新增」的区县),可在

ThenInclude
后继续加
Where

只能用于集合导航属性(
IEnumerable<t></t>
类型),不能用于单个引用属性(如
Author
筛选条件作用于数据库 SQL 的
ON
子句,不是内存过滤
生成的 SQL 会带
LEFT JOIN ... ON ... AND
,确保主实体不因子数据不满足条件而丢失

示例:查博客,只包含「2024 年发布的文章」及其「点赞数 > 10 的评论」

var blogs = context.Blogs
    .Include(b => b.Posts)
        .ThenInclude(p => p.Comments)
            .Where(c => c.Likes > 10)
    .Include(b => b.Posts)
        .Where(p => p.PublishDate.Year == 2024)
    .AsSplitQuery()
    .ToList();

替代方案:用 Select 投影更精准控制

Include().Where()
不够灵活(比如要跨表条件、聚合或排序),推荐改用
Select
投影——它在数据库层完成筛选与字段裁剪,性能更好、语义更清晰:

返回的是匿名类型或 DTO,不是完整实体,不可直接修改跟踪 天然避免 N+1 和笛卡尔积问题 可自由组合主表和关联表字段,甚至加
Count
Max
等聚合

示例:只取博客名、文章标题和评论数(仅含已发布文章)

var blogSummary = context.Blogs
    .Select(b => new
    {
        BlogName = b.Name,
        Posts = b.Posts
            .Where(p => p.IsPublished)
            .Select(p => new
            {
                Title = p.Title,
                CommentCount = p.Comments.Count()
            })
    })
    .ToList();

注意事项和常见坑

这类筛选性加载容易出错,务必注意:

不支持在同一个
Include
链中对同一集合多次
Where
,会编译失败
Where
必须紧跟在
Include
ThenInclude
后,不能隔开调用
若未启用
AsSplitQuery()
,一对多+多对多嵌套可能导致结果集爆炸
筛选条件里不能用非数据库可转换的方法(如
DateTime.Now.Date
应改用
EF.Functions.DateDiffDay
或参数化)

基本上就这些。用对

Include().Where()
Select
,就能在 EF Core 里干净利落地实现按需加载关联数据。

相关推荐