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 属性

标签： app ai c#