0

0

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

畫卷琴夢

畫卷琴夢

发布时间:2026-01-10 10:41:02

|

207人浏览过

|

来源于php中文网

原创

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

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

Dapper 本身不直接支持 SQL Server 存储过程中多个 OUTPUT 参数(即 OUTPUT 类型的参数,不是返回结果集),但它完全支持 OUT / OUTPUT 参数(即带 output 方向的 SqlParameter)。关键在于:你得手动构造 DynamicParameters 或原生 SqlParameter,并显式指定参数方向为 OutputReturnValue,Dapper 才能正确读取返回值。

用 DynamicParameters 绑定多个 OUTPUT 参数

DynamicParameters 是 Dapper 推荐的方式,它自动处理输入/输出参数的注册和取值,写法简洁清晰。

  • 先创建 DynamicParameters 实例
  • Add() 方法添加每个 OUTPUT 参数,设置 dbTypedirection = 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);

Sider
Sider

多功能AI浏览器助手,帮助用户进行聊天、写作、阅读、翻译等

下载

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,就能稳稳拿到所有输出值。

相关专题

更多
数据分析工具有哪些
数据分析工具有哪些

数据分析工具有Excel、SQL、Python、R、Tableau、Power BI、SAS、SPSS和MATLAB等。详细介绍:1、Excel,具有强大的计算和数据处理功能;2、SQL,可以进行数据查询、过滤、排序、聚合等操作;3、Python,拥有丰富的数据分析库;4、R,拥有丰富的统计分析库和图形库;5、Tableau,提供了直观易用的用户界面等等。

676

2023.10.12

SQL中distinct的用法
SQL中distinct的用法

SQL中distinct的语法是“SELECT DISTINCT column1, column2,...,FROM table_name;”。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

320

2023.10.27

SQL中months_between使用方法
SQL中months_between使用方法

在SQL中,MONTHS_BETWEEN 是一个常见的函数,用于计算两个日期之间的月份差。想了解更多SQL的相关内容,可以阅读本专题下面的文章。

346

2024.02.23

SQL出现5120错误解决方法
SQL出现5120错误解决方法

SQL Server错误5120是由于没有足够的权限来访问或操作指定的数据库或文件引起的。想了解更多sql错误的相关内容,可以阅读本专题下面的文章。

1094

2024.03.06

sql procedure语法错误解决方法
sql procedure语法错误解决方法

sql procedure语法错误解决办法:1、仔细检查错误消息;2、检查语法规则;3、检查括号和引号;4、检查变量和参数;5、检查关键字和函数;6、逐步调试;7、参考文档和示例。想了解更多语法错误的相关内容,可以阅读本专题下面的文章。

357

2024.03.06

oracle数据库运行sql方法
oracle数据库运行sql方法

运行sql步骤包括:打开sql plus工具并连接到数据库。在提示符下输入sql语句。按enter键运行该语句。查看结果,错误消息或退出sql plus。想了解更多oracle数据库的相关内容,可以阅读本专题下面的文章。

675

2024.04.07

sql中where的含义
sql中where的含义

sql中where子句用于从表中过滤数据,它基于指定条件选择特定的行。想了解更多where的相关内容,可以阅读本专题下面的文章。

571

2024.04.29

sql中删除表的语句是什么
sql中删除表的语句是什么

sql中用于删除表的语句是drop table。语法为drop table table_name;该语句将永久删除指定表的表和数据。想了解更多sql的相关内容,可以阅读本专题下面的文章。

414

2024.04.29

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

25

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java 教程
Java 教程

共578课时 | 44.2万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号