C# Entity Framework Core 中的 Include 和 ThenInclude 详解

今天我要分享 Entity Framework Core 中两个非常重要的方法：Include 和 ThenInclude。

1. 什么是导航属性？

在开始之前，我们需要先理解一个核心概念：导航属性。

想象一下，在一个图书馆系统中：

• 一本书属于一个作者
• 一个作者可以写多本书
• 一本书可以有多个评论

这种"关联关系"在代码中就用导航属性来表示。

2. 基础数据模型

让我们创建一个简单的博客系统模型：

// 博客类
public class Blog
{public int BlogId { get; set; }          // 博客IDpublic string Title { get; set; }        // 博客标题public string Url { get; set; }          // 博客网址// 导航属性：一个博客有多篇文章public List<Post> Posts { get; set; } = new List<Post>();
}// 文章类
public class Post
{public int PostId { get; set; }          // 文章IDpublic string Title { get; set; }        // 文章标题public string Content { get; set; }      // 文章内容public int BlogId { get; set; }          // 外键：属于哪个博客// 导航属性：文章属于一个博客public Blog Blog { get; set; }// 导航属性：一篇文章有多个评论public List<Comment> Comments { get; set; } = new List<Comment>();
}// 评论类
public class Comment
{public int CommentId { get; set; }       // 评论IDpublic string Text { get; set; }         // 评论内容public string Author { get; set; }       // 评论作者public int PostId { get; set; }          // 外键：属于哪篇文章// 导航属性：评论属于一篇文章public Post Post { get; set; }
}

3. 问题：为什么需要 Include？

场景分析

如果我们想获取博客及其所有文章，可能会这样写：

// 错误的方式 - 会出现问题！
var blogs = context.Blogs.ToList();foreach (var blog in blogs)
{Console.WriteLine($"博客: {blog.Title}");// 这里会报错或者性能很差！foreach (var post in blog.Posts)  // Posts 为 null 或者需要额外查询{Console.WriteLine($"  - 文章: {post.Title}");}
}

问题所在：

• 第一次查询只获取了博客信息
• 当访问 blog.Posts 时，EF Core 需要再次访问数据库获取文章
• 这被称为 N+1 查询问题（1次查博客 + N次查文章）

4. Include 的解决方案

Include 的作用：一次性加载关联数据

// 正确的方式 - 使用 Include
var blogs = context.Blogs.Include(b => b.Posts)  // 告诉 EF Core：同时加载 Posts 数据.ToList();foreach (var blog in blogs)
{Console.WriteLine($"博客: {blog.Title}");// 现在 Posts 已经有数据了！foreach (var post in blog.Posts){Console.WriteLine($"  - 文章: {post.Title}");}
}

生成的 SQL 类似：

SELECT b.*, p.* 
FROM Blogs b
LEFT JOIN Posts p ON b.BlogId = p.BlogId

5. ThenInclude：处理多级关联

场景：我们需要博客 → 文章 → 评论

// 只使用 Include 是不够的
var blogs = context.Blogs.Include(b => b.Posts)  // 加载到文章// 但是文章的评论还是空的！.ToList();// 我们需要 ThenInclude 来继续深入
var detailedBlogs = context.Blogs.Include(b => b.Posts)           // 第一层：博客 → 文章.ThenInclude(p => p.Comments) // 第二层：文章 → 评论.ToList();

可视化理解

博客 (Blog)│├── 文章 (Post)          ← Include(b => b.Posts)│     ││     └── 评论 (Comment)  ← ThenInclude(p => p.Comments)│└── 其他属性...

6. 实际代码示例

示例 1：基础使用

using (var context = new BlogContext())
{// 加载博客及其文章var blogsWithPosts = context.Blogs.Include(b => b.Posts).ToList();// 加载博客、文章及评论var blogsWithPostsAndComments = context.Blogs.Include(b => b.Posts)           // 第一级：文章.ThenInclude(p => p.Comments) // 第二级：评论.ToList();
}

示例 2：多层 ThenInclude

// 假设我们还有用户系统
public class User
{public int UserId { get; set; }public string Name { get; set; }public List<Comment> Comments { get; set; }
}public class Comment
{// ... 之前的属性public int UserId { get; set; }public User User { get; set; }  // 新增：评论属于用户
}// 加载博客 → 文章 → 评论 → 用户
var detailedData = context.Blogs.Include(b => b.Posts)           // 博客 → 文章.ThenInclude(p => p.Comments) // 文章 → 评论.ThenInclude(c => c.User) // 评论 → 用户.ToList();

示例 3：多个 Include 分支

// 一个博客有作者信息
public class Blog
{// ... 之前的属性public int AuthorId { get; set; }public Author Author { get; set; }  // 博客作者