Dapper 更新数据主要通过 Execute 方法执行参数化 UPDATE 语句,返回受影响行数以判断结果;需手动编写 SQL、管理连接,并支持匿名对象或实体传参,批量更新需借助循环或第三方扩展。

Dapper 更新数据主要通过 Execute 方法执行 SQL 的 UPDATE 语句,配合参数化查询防止 SQL 注入,是轻量又安全的做法。
使用 Execute 执行 UPDATE 语句
Dapper 的 Execute 方法用于执行不返回结果集的命令(如 INSERT、UPDATE、DELETE),返回受影响的行数,可用于判断更新是否成功。
- 需手动编写标准 SQL UPDATE 语句,Dapper 不提供类似 EF 的“跟踪-修改-保存”机制
- 必须使用参数化查询,推荐用匿名对象或强类型实体传参
- 连接需自行管理(打开/关闭),建议用
using确保释放
基础更新示例(按 ID 修改字段)
假设有个用户表 Users,要更新用户名和邮箱:
using (var conn = new SqlConnection(connectionString))
{
conn.Open();
var rows = conn.Execute(
"UPDATE Users SET Name = @Name, Email = @Email WHERE Id = @Id",
new { Name = "张三", Email = "zhangsan@example.com", Id = 123 });
if (rows == 0)
Console.WriteLine("未找到匹配记录,更新失败");
}
用实体对象传参更简洁
若已有实体(如 User 类),可直接传入实例,Dapper 自动映射属性名到 SQL 参数:
- 实体属性名需与 SQL 中的参数名(@xxx)一致
- WHERE 条件仍需显式写出,Dapper 不自动生成
var user = new User { Id = 123, Name = "李四", Email = "lisi@example.com" };
var rows = conn.Execute(
"UPDATE Users SET Name = @Name, Email = @Email WHERE Id = @Id",
user);
批量更新(多个记录)
Dapper 本身不支持原生批量更新语法(如 MySQL 的 INSERT ... ON DUPLICATE KEY UPDATE),但可通过以下方式实现:
- 拼接多条 UPDATE 语句(不推荐,易出错)
- 用循环逐条执行(适合小批量,逻辑清晰)
- 借助第三方扩展如 Dapper.Contrib 的
Update方法(仅支持单实体) - 对大数据量,建议改用存储过程或原生批量 SQL(如 SQL Server 的
MERGE)
基本上就这些。Dapper 更新的核心就是写好 SQL + 用 Execute 安全执行 —— 简单直接,也留出了足够灵活的控制空间。










