EF Core AddRange怎么用 EF Core批量插入数据教程

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

EF Core 的

AddRange
是批量添加实体到上下文的高效方式,它比循环调用
Add
更快,也比原生 SQL 或第三方库更简洁。关键点是:它只是“标记为新增”,真正写入数据库仍需调用
SaveChanges()

基本用法:一次添加多个对象

适用于已创建好实体对象集合的场景,比如从 API、文件或表单中批量获取数据后插入。

传入
IEnumerable<t></t>
List<t></t>
或数组都行
所有对象状态被设为
Added
,后续
SaveChanges()
会生成一条或多条
INSERT
语句(取决于数据库提供程序和配置)
示例:
var users = new List<User>
{
    new User { Name = "张三", Email = "zhang@example.com" },
    new User { Name = "李四", Email = "li@example.com" },
    new User { Name = "王五", Email = "wang@example.com" }
};
context.Users.AddRange(users); // 仅跟踪,不提交
context.SaveChanges(); // 此时才真正执行 INSERT

配合 AsNoTracking 提升性能?别搞混了

AddRange
本身不需要、也不建议先用
AsNoTracking
—— 因为
AsNoTracking
是查询方法,对新增无意义。误用会导致编译错误或逻辑混乱。

✅ 正确:直接 new 对象 →
AddRange
SaveChanges
❌ 错误:
context.Users.AsNoTracking().AddRange(...)
(语法不合法)
⚠️ 注意:如果实体来自查询结果且你打算修改后插入(少见),需先
Detach
Clone
,避免状态冲突

处理主键:自增 vs 手动指定

EF Core 默认按模型配置决定主键行为。批量插入时要注意:

主键是数据库自增(如 SQL Server 的
IDENTITY
):实体中主键值可为 0 或
default
,EF Core 会忽略它,由数据库生成
主键需手动指定(如 GUID、业务编码):确保每个对象的主键值唯一且非空,否则可能抛出异常或覆盖数据 若想让 EF Core 在
SaveChanges
后自动获取数据库生成的 ID(如自增主键),确保属性标记了
[DatabaseGenerated(DatabaseGeneratedOption.Identity)]
,并启用
context.Entry(entity).Property(e => e.Id).IsModified = false;
(通常默认即可)

性能优化小技巧

大批量插入(如上万条)时,

AddRange + SaveChanges
可能变慢,因为 EF Core 默认每条 INSERT 都走完整变更追踪流程。

分批提交:每 100–1000 条调用一次
SaveChanges()
,减少内存压力和事务日志体积
禁用自动检测变化(可选):
context.ChangeTracker.AutoDetectChangesEnabled = false;
,插入完再设回
true
考虑替代方案:超大数据量(>5 万)推荐用
SqlBulkCopy
(SQL Server)或第三方库如
EFCore.BulkExtensions

基本上就这些。AddRange 不复杂但容易忽略细节,用对了能省不少事。

相关推荐