EF Core ThenInclude怎么用 EF Core多级关联查询方法

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

EF Core 的

ThenInclude
是用来解决“多级关联数据一次性加载”问题的核心方法,它必须接在
Include
后面,不能单独使用。它的作用不是替代
Include
,而是延伸加载路径——比如从“订单”到“订单项”,再从“订单项”到“商品”,这就是典型的两级延伸。

ThenInclude 必须配合 Include 使用

ThenInclude
没有独立意义,它只对上一个
Include
ThenInclude
返回的类型起作用。也就是说:

Include(o => o.OrderItems)
返回的是
OrderItems
集合(
ICollection<orderitem></orderitem>
ThenInclude(oi => oi.Product)
的参数
oi
就是
OrderItem
类型,只能访问
OrderItem
的导航属性
不能跳过中间层,比如不能在
Order
上直接
ThenInclude
Product

支持集合和引用两种路径延伸

无论中间是集合还是单个引用,

ThenInclude
都能继续往下走:

集合 → 元素的引用:如
Blog.Posts
(集合)→
Post.Author
(引用)
集合 → 元素的集合:如
Blog.Posts
Post.Comments
(集合)
引用 → 下级引用:如
Post.Author
Author.ContactInfo

示例代码:

context.Blogs<br>  .Include(b => b.Posts)<br>  .ThenInclude(p => p.Author)<br>  .ThenInclude(a => a.Profile)<br>  .ToList();

同一层级多个分支要分开写 Include

如果想从同一个集合加载多个不同子属性(比如一篇文章既要作者,也要标签),不能靠一次

ThenInclude
完成,得重复写
Include
+
ThenInclude

先写
.Include(b => b.Posts).ThenInclude(p => p.Author)
再写
.Include(b => b.Posts).ThenInclude(p => p.Tags)
两个调用都基于
Posts
,EF Core 会合并成一条 SQL

避免常见错误

实际用错最多的地方集中在三类:

ThenInclude
放在最前面或中间断开链路(如漏了某个
Include
参数表达式类型不匹配(比如
ThenInclude
里用了
Blog
的属性,但上一级是
Post
过度加载导致结果集爆炸(比如博客有 100 篇文章,每篇有 50 条评论,查出来就是 5000 行,内存飙升)

建议搭配

Select
投影只取需要字段,或用分页控制数据量。

基本上就这些。用熟了你会发现,

Include
ThenInclude
的链式结构,本质上就是在代码里画一棵查询树——根是主实体,枝杈是你明确指定的每一级关联。

相关推荐