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

来源：这里教程网时间：2026-02-21 17:37:36 作者：

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<t>("paramName")</t>
获取输出值

示例（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);
<p>connection.Execute("GetUserInfoAndCount", parameters, commandType: CommandType.StoredProcedure);</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1213" title="PixarAI"><img
                                                                                src="https://www.herecours.com/d/file/efpub/2026/21-21/20260221140301179507.jpg" alt="PixarAI"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1213" title="PixarAI">PixarAI</a>
                                                                        <p>PixarAI是一个AI驱动的皮克斯风格海报生成器，可以帮助用户创建迪士尼皮克斯风格的海报</p>
                                                                </div>
                                                                <a href="/ai/1213" title="PixarAI" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div><p>string name = parameters.Get<string>("@UserName");
int count = parameters.Get<int>("@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<int>("@return");</int>
可与其它
OUTPUT
参数共存，互不影响

常见问题排查

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

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

基本上就这些。Dapper 处理多 OUTPUT 参数不复杂，但容易忽略参数方向和命名细节。只要按规则配好