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 里干净利落地实现按需加载关联数据。
