Dapper中怎么使用OUTPUT子句 Dapper获取INSERT/UPDATE后的数据

发布日期： 2025-12-24 阅读量： 作者： 幻夢星雲

Dapper 本身不直接封装 OUTPUT 子句，但可通过原生 SQL 配合 Query 或 QueryFirst 执行带 OUTPUT 的 INSERT/UPDATE 语句以获取返回数据；SQL Server 的 OUTPUT 支持 INSERTED/DELETED 伪表，可灵活返回新旧值、默认值、计算列等，比 SCOPE_IDENTITY() 更可靠；使用时需确保列名与 DTO 属性匹配，注意空结果异常应选用 QuerySingleOrDefault，且 OUTPUT 为 SQL Server 特有语法。

Dapper 本身不直接封装 OUTPUT 子句，但你可以通过原生 SQL + Dapper 的查询方法（如 Query 或 QueryFirst）来执行带 OUTPUT 的 INSERT/UPDATE 语句，并获取返回的数据。

INSERT 后用 OUTPUT 获取新生成的值（如 ID、默认值等）

SQL Server 的 OUTPUT 可在 INSERT 时返回刚插入行的任意列（包括 IDENTITY、GETDATE()、计算列、默认值等），比仅依赖 SCOPE_IDENTITY() 更灵活可靠。

用 Query() 执行带 OUTPUT 的 INSERT，T 对应你希望映射的返回结构
确保 OUTPUT 子句中的列名与 T 类型的属性名（或使用别名）匹配，支持大小写不敏感映射
推荐显式指定列名，避免因表结构变更导致映射失败

示例：

var sql = @"INSERT INTO Users (Name, Email, CreatedAt)
OUTPUT INSERTED.Id, INSERTED.CreatedAt
VALUES (@name, @email, GETDATE());";

var user = connection.QueryFirst(sql, new { name = "张三", email = "zhang@example.com" });

// UserDto 需包含 Id 和 CreatedAt 属性

UPDATE 时用 OUTPUT 返回修改前/后的数据

OUTPUT 支持 INSERTED 和 DELETED 伪表，UPDATE 可同时访问新旧值，适合审计、触发式逻辑或返回更新结果。

若只关心更新后的值，用 OUTPUT INSERTED.* 或指定字段
若需对比（如日志记录），可用 OUTPUT DELETED.Name AS OldName, INSERTED.Name AS NewName
注意：UPDATE 语句可能影响多行，用 Query() 获取全部，QueryFirst() 仅取第一行

示例（返回更新后的用户名和时间）：

var sql = @"UPDATE Users
SET Name = @newName, UpdatedAt = GETDATE()
OUTPUT INSERTED.Id, INSERTED.Name, INSERTED.UpdatedAt
WHERE Id = @id;";

var updated = connection.QueryFirst(sql, new { id = 123, newName = "李四" });

注意事项和常见坑

OUTPUT 是 SQL Server 特有语法，不能跨数据库使用（如 PostgreSQL 用 RETURNING，SQLite 用 RETURNING（3.35+））
Dapper 不会自动处理 OUTPUT 的多结果集（如 INSERT + SELECT 组合），确保语句只返回一个结果集
如果 OUTPUT 返回空结果（如 WHERE 不匹配），QueryFirst() 会抛异常，改用 QuerySingleOrDefault() 更安全
参数绑定完全由 Dapper 处理，无需手动拼接，OUTPUT 中不能引用参数，只能用 INSERTED/DELETED

替代方案对比（什么时候不用 OUTPUT）

只需主键：用 Execute() + SELECT SCOPE_IDENTITY() 更轻量，但无法获取其他默认值
需要复杂逻辑：可封装为存储过程，内部用 OUTPUT，Dapper 调用该 SP 即可
ORM 替代：EF Core 6+ 支持 ExecuteSqlInterpolated + OUTPUT，但 Dapper 更直接可控

基本上就这些。OUTPUT 不是 Dapper 的“功能”，而是你用 Dapper 执行标准 SQL 的能力体现——写对 SQL，Dapper 就能映射回来。

上一篇: Mac怎么设置开机问候语_Mac锁屏显示自定义文字

下一篇: 如何在Golang中使用reflect检测零值_判断变量是否

Dapper中怎么使用OUTPUT子句 Dapper获取INSERT/UPDATE后的数据

随便看看

南昌壹佳企网络通信有限公司