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
// UserDto 需包含 Id 和 CreatedAt 属性
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
注意事项和常见坑
-
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 就能映射回来。
