17370845950

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

常见问题排查

如果取不到 OUTPUT 值，优先检查这几项：

• 存储过程中是否真的用了 OUTPUT 关键字声明该参数？仅在 SELECT @p = ... 不够，必须声明时带 OUTPUT
• Dapper 参数名是否拼写错误或缺少 @
• 是否调用了 Execute()（而非 Query()）？只有 Execute 才触发 OUTPUT 参数回填
• 是否在 Execute 之后才调用 Get()？提前读会得到默认值（如 null 或 0）
• 数据库类型是否匹配？比如 C# 的 int? 对应 SQL 的 INT NULL，需用 Get()

基本上就这些。Dapper 处理多 OUTPUT 参数不复杂，但容易忽略参数方向和命名细节。只要按规则配好 DynamicParameters，就能稳稳拿到所有输出值。