Dapper如何执行带输出参数的存储过程 Dapper Output参数用法

Dapper支持SQL Server存储过程的OUTPUT参数（非INSERT...OUTPUT子句），需通过SqlParameter或DynamicParameters显式声明Output方向，执行后读取Value或用Get获取，注意参数名一致、存储过程内赋值及类型转换。

Dapper 本身不直接支持 SQL Server 的 OUTPUT 参数（即存储过程中用 OUTPUT 关键字返回的参数），但它完全支持 ADO.NET 风格的 输出参数（SqlParameter with Direction = ParameterDirection.Output）。也就是说，如果你的存储过程定义了 OUTPUT 类型的参数（比如 @ResultID INT OUTPUT），Dapper 可以通过传入带方向的 SqlParameter 来获取其返回值。

使用 SqlParameter 显式声明 Output 参数

这是最常用、最可靠的方式。你需要手动创建 SqlParameter，设置 ParameterDirection.Output 或 InputOutput，再传给 Dapper 方法。

• 确保参数名与存储过程中定义的名称完全一致（包括 @ 符号）
• 输出参数的 Value 初始值可以为 DBNull.Value 或任意占位值（Dapper 不读取它的输入值，但 ADO.NET 要求非 null 引用）
• 执行后从 param.Value 中读取结果，注意类型转换（如 (int)param.Value）

示例（C#）：

var idParam = new SqlParameter("@ResultID", SqlDbType.Int) { Direction = ParameterDirection.Output };
var nameParam = new SqlParameter("@Name", "张三") { Direction = ParameterDirection.Input };

connection.Execute("sp_InsertUser", new[] { idParam, nameParam }, commandType: CommandType.StoredProcedure);

int newId = (int)idParam.Value; // 获取输出值

用 DynamicParameters 简化 Output 参数管理

Dapper.DynamicParameters 是 Dapper 提供的增强型参数容器，对 Input/Output/ReturnValue 参数支持更友好，语法也更简洁。

标签： app 常见问题 c# .net red