Dapper怎么执行返回多个输出参数的存储过程 Dapper多Output参数处理_技术教程

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;
END

Dapper 调用：

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 参数共存，互不影响