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

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<t></t> 或 QueryFirst<t></t>）来执行带 OUTPUT 的 INSERT/UPDATE 语句，并获取返回的数据。

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

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

• 用 Query<t>()</t> 执行带 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 属性

AI Content Detector

Writer推出的AI内容检测工具

119

查看详情

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

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

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

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

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<t>()</t> 会抛异常，改用 QuerySingleOrDefault<t>()</t> 更安全
• 参数绑定完全由 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 就能映射回来。

以上就是Dapper中怎么使用OUTPUT子句 Dapper获取INSERT/UPDATE后的数据的详细内容，更多请关注php中文网其它相关文章！