Dapper如何更新数据 Dapper Execute更新记录方法

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 安全执行 —— 简单直接,也留出了足够灵活的控制空间。