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

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")获取输出值
示例(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);
<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/1258" title="Yodayo"><img
src="https://img.php.cn/upload/ai_manual/000/000/000/175680155366412.png" alt="Yodayo" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1258" title="Yodayo">Yodayo</a>
<p>一个专为动漫迷和vTuber打造的AI艺术创作平台、交流社区</p>
</div>
<a href="/ai/1258" title="Yodayo" 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>()?提前读会得到默认值(如 null 或 0) - 数据库类型是否匹配?比如 C# 的
int?对应 SQL 的INT NULL,需用Get<int?>()
基本上就这些。Dapper 处理多 OUTPUT 参数不复杂,但容易忽略参数方向和命名细节。只要按规则配好 DynamicParameters,就能稳稳拿到所有输出值。









