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

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

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

相关推荐