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 参数支持更友好,语法也更简洁。
这本书给出了一份关于python这门优美语言的精要的参考。作者通过一个完整而清晰的入门指引将你带入python的乐园,随后在语法、类型和对象、运算符与表达式、控制流函数与函数编程、类及面向对象编程、模块和包、输入输出、执行环境等多方面给出了详尽的讲解。如果你想加入 python的世界,David M beazley的这本书可不要错过哦。 (封面是最新英文版的,中文版貌似只译到第二版)
- 用
Add()方法添加参数时,指定dbType、direction和可选的value - 执行后调用
Get获取输出值(推荐),或直接访问("paramName") parameters.Get("paramName") - 支持多个输出参数,也兼容返回值(
ParameterDirection.ReturnValue)
示例:
var p = new DynamicParameters();
p.Add("@Name", "李四", DbType.String, ParameterDirection.Input);
p.Add("@UserId", dbType: DbType.Int32, direction: ParameterDirection.Output);
p.Add("@ReturnCode", dbType: DbType.Int32, direction: ParameterDirection.ReturnValue);
connection.Execute("sp_InsertUser", p, commandType: CommandType.StoredProcedure);
int userId = p.Get("@UserId");
int returnCode = p.Get("@ReturnCode");
注意:Output 参数 ≠ OUTPUT 子句(SQL Server 的 INSERT...OUTPUT)
别混淆两个概念:
-
OUTPUT 参数:存储过程定义的带
OUTPUT关键字的 T-SQL 参数,属于“过程级返回值”,需用SqlParameter.Direction = Output捕获 -
INSERT...OUTPUT 子句:SQL 语句级功能,用于返回被插入/更新/删除的行数据(如
OUTPUT INSERTED.Id)。Dapper 对它天然支持——只要你的存储过程里写了SELECT或直接OUTPUT返回结果集,Dapper 就能用Query接收,无需特殊参数设置()
常见问题提醒
- 存储过程必须用
commandType: CommandType.StoredProcedure,否则参数名匹配可能失败 - SQL Server 中 OUTPUT 参数默认是
NULL,务必在存储过程中显式赋值(如SET @ResultID = SCOPE_IDENTITY()) - 如果输出参数是字符串,建议指定
Size(如Size = 50),避免截断或长度推断异常 - Dapper 不支持匿名对象自动映射 Output 参数(比如
new { @Name = "a", @Id = Output }),必须用DynamicParameters或原生SqlParameter
基本上就这些。用好 DynamicParameters,Output 参数处理就很清晰自然。









