Dapper如何批量更新数据 Dapper Bulk Update高效实现

Dapper 本身不支持批量更新，需借助原生 SQL、表值参数（TVP）、临时表或第三方库（如 RepoDB、Dapper.FastCRUD）实现；推荐 TVP + JOIN 方式，避免 foreach 循环和字符串拼接。

Dapper 本身不内置批量更新（Bulk Update）功能，它是一个轻量级 ORM，专注于单条 SQL 执行和映射。要实现高效批量更新，需结合原生 SQL、表值参数（TVP）、临时表或第三方扩展库（如 Dapper.FastCRUD、Dapper.Contrib 或更主流的 SqlKata + SqlServer 配合 TVP）。核心思路是：避免循环执行单条 UPDATE，改用一次 SQL 操作更新多行。

使用表值参数（TVP）+ 原生 SQL（推荐，SQL Server）

这是最常用、性能好且可控性强的方式。先在 SQL Server 中创建用户定义表类型（UDT），再通过 DataTable 或自定义 IDataReader 传入多行数据，在 UPDATE 中 JOIN TVP 完成批量更新。

在数据库中提前建好 TVP 类型，例如：CREATE TYPE dbo.UpdateUserTableType AS TABLE (Id INT, Name NVARCHAR(50), Email NVARCHAR(100));
C# 中构造 DataTable，列名/类型严格匹配 TVP；或用 Dapper.SqlMapper.Execute 配合 new SqlMapper.ICustomQueryParameter 实现高效传参
SQL 写法示例：UPDATE u SET u.Name = t.Name, u.Email = t.Email FROM Users u INNER JOIN @updates t ON u.Id = t.Id;

拼接动态 SQL（小批量、简单场景）

适用于更新数据量较小（比如 ≤ 100 条）、字段固定、且对 SQL 注入有严格校验的场景。用 StringBuilder 拼出 CASE WHEN 或 VALUES + JOIN 形式。

例如用 UPDATE t SET col = CASE id WHEN 1 THEN 'a' WHEN 2 THEN 'b' END WHERE id IN (1,2)
注意参数化：所有值必须通过 @p0, @p1... 参数传入，不可字符串拼接值
Dapper 支持匿名对象或 DynamicParameters，可配合 Dictionary 或 List

借助成熟扩展库（省事但引入依赖）

如果项目允许引入第三方包，Dapper.FastCRUD 和 RepoDB 提供了开箱即用的 BulkUpdate 方法（底层仍走 TVP 或 SqlBulkCopy）。

connection.BulkUpdate(users, batchSize: 1000); —— RepoDB 示例，支持实体类直接更新
Dapper.FastCRUD 要求实体有主键标记，调用 UpdateAsync(IEnumerable) 即可
注意：这些库在非 SQL Server 环境（如 PostgreSQL、MySQL）行为可能受限，需查文档确认支持情况

避坑提醒：什么方式不推荐

以下做法看似简单，实际在生产环境应避免：

用 foreach 循环调用 connection.Execute("UPDATE ...", item) —— N+1 查询，性能极差
手动拼接 SQL 字符串并插入值（未参数化）—— SQL 注入高危
用 INSERT INTO ... SELECT + MERGE 替代 UPDATE，逻辑复杂且易出错，除非真需要 upsert 语义

基本上就这些。真正高效的 Dapper 批量更新，关键不在“用哪个库”，而在于是否绕开了逐条执行、是否利用了数据库原生批量能力（如 TVP、MERGE、SqlBulkCopy）。选型时优先考虑数据库兼容性、团队熟悉度和维护成本。

# mysql # app # ai # sqlserver # c# # sql # Object # foreach # select # 字符串 # int # 循环 # 值参数 # 对象 # table # postgresql # 数据库 # 第三方 # 单条 # 这是 # 适用于 # 它是 # 自定义 # 不支持 # 较小 # 先在 # 数据库中

返回目录在线咨询

上一篇：在为电商网站挑选主机时，哪些环境因素最为关键？
下一篇：如何在免费建站平台上添加和管理网站内容？

您的项目需求