Dapper支持SQL Server存储过程的多个OUTPUT参数,需用DynamicParameters显式设置ParameterDirection.Output方向,并确保参数名与存储过程定义完全一致(含@符号),执行Execute后调用Get()获取值。

Dapper 本身不直接支持 SQL Server 存储过程中多个 OUTPUT 参数(即 OUTPUT 类型的参数,不是返回结果集),但它完全支持 OUT / OUTPUT 参数(即带 output 方向的 SqlParameter)。关键在于:你得手动构造 DynamicParameters 或原生 SqlParameter,并显式指定参数方向为 Output 或 ReturnValue,Dapper 才能正确读取返回值。
用 DynamicParameters 绑定多个 OUTPUT 参数
DynamicParameters 是 Dapper 推荐的方式,它自动处理输入/输出参数的注册和取值,写法简洁清晰。
- 先创建
DynamicParameters实例 - 用
Add()方法添加每个OUTPUT参数,设置dbType、direction = ParameterDirection.Output - 调用
Execute()(非查询类存储过程)执行 - 执行后通过
Get获取输出值("paramName")
示例(SQL Server 存储过程假设):
CREATE PROCEDURE GetUserInfoAndCount
@UserId INT,
@UserName NVARCHAR(50) OUTPUT,
@TotalUsers INT OUTPUT
AS
BEGIN
SELECT @UserName = Name FROM Users WHERE Id = @UserId;
SELECT @TotalUsers = COUNT(*) FROM Users;
ENDDapper 调用:
var parameters = new DynamicParameters();
parameters.Add("@UserId", 123, DbType.Int32, ParameterDirection.Input);
parameters.Add("@UserName", dbType: DbType.String, direction: ParameterDirection.Output);
parameters.Add("@TotalUsers", dbType: DbType.Int32, direction: ParameterDirection.Output);
connection.Execute("GetUserInfoAndCount", parameters, commandType: CommandType.StoredProcedure);
string name = parameters.Get("@UserName");
int count = parameters.Get("@TotalUsers");
注意 OUTPUT 参数的方向与命名一致性
SQL Server 中 OUTPUT 参数必须显式声明为 OUTPUT(如 @Name NVARCHAR(50) OUTPUT),Dapper 中的参数名(如 "@UserName")必须与存储过程中定义的名称**完全一致**(包括 @ 符号),否则取不到值。
- 大小写不敏感,但建议保持一致
- 不要漏掉
@前缀;Dapper 默认要求带 @(除非用addWithNoAtSign显式关闭) -
direction必须设为ParameterDirection.Output,不能是InputOutput(除非你真要双向传值)
如果需要同时获取返回值(RETURN)+ 多个 OUTPUT 参数
SQL Server 存储过程还可通过 RETURN 返回一个整数。Dapper 支持用特殊名称 "@return" 捕获它:
- 添加参数:
parameters.Add("@return", dbType: DbType.Int32, direction: ParameterDirection.ReturnValue) - 调用后:
int ret = parameters.Get("@return"); - 可与其它
OUTPUT参数共存,互不影响
常见问题排查
如果取不到 OUTPUT 值,优先检查这几项:
- 存储过程中是否真的用了
OUTPUT关键字声明该参数?仅在SELECT @p = ...不够,必须声明时带OUTPUT - Dapper 参数名是否拼写错误或缺少
@ - 是否调用了
Execute()(而非Query())?只有Execute才触发 OUTPUT 参数回填 - 是否在
Execute之后才调用Get?提前读会得到默认值(如 null 或 0)() - 数据库类型是否匹配?比如 C# 的
int?对应 SQL 的INT NULL,需用Get()
基本上就这些。Dapper 处理多 OUTPUT 参数不复杂,但容易忽略参数方向和命名细节。只要按规则配好 DynamicParameters,就能稳稳拿到所有输出值。










