0

0

Dapper中QueryMultiple怎么用 Dapper返回多个结果集教程

月夜之吻

月夜之吻

发布时间:2026-01-11 09:47:02

|

360人浏览过

|

来源于php中文网

原创

Dapper的QueryMultiple方法可一次性执行含多个SELECT的SQL并按序获取多个结果集,返回GridReader对象,需严格按SQL中SELECT顺序调用Read()等方法读取,支持ReadSingle、Skip等进阶操作。

dapper中querymultiple怎么用 dapper返回多个结果集教程

Dapper 的 QueryMultiple 方法用于执行一条 SQL 语句(通常是存储过程或含多个 SELECT 的批处理),并一次性获取多个结果集,比多次调用 Query 更高效、更节省数据库连接资源。

基本用法:用 QueryMultiple 获取多个结果集

调用 QueryMultiple 后返回一个 SqlMapper.GridReader 对象,它支持按顺序读取每个结果集,每次调用 Read() 就消耗一个结果集。

示例:查询用户列表 + 订单总数 + 最新3个订单

string sql = @"
    SELECT * FROM Users WHERE Status = @status;
    SELECT COUNT(*) FROM Orders WHERE UserId IN (SELECT Id FROM Users WHERE Status = @status);
    SELECT TOP 3 * FROM Orders ORDER BY CreatedTime DESC;";

using var conn = new SqlConnection(connStr); var multi = conn.QueryMultiple(sql, new { status = "Active" });

var users = multi.Read().ToList(); // 第一个结果集 → User 列表 var orderCount = multi.ReadSingle(); // 第二个结果集 → 单个 int 值 var recentOrders = multi.Read().ToList(); // 第三个结果集 → Order 列表

常见场景:配合存储过程使用

SQL Server 存储过程中用多个 SELECT 返回不同结构的数据时,QueryMultiple 是最佳选择。

雪鸮AI
雪鸮AI

高效便捷的智能绘图辅助工具,一键生成高质量效果图。

下载
  • 确保每个 SELECT 的列名和类型与目标 .NET 类型匹配(Dapper 按列名映射)
  • 避免在存储过程中使用 SET NOCOUNT ON —— 它会干扰 Dapper 解析结果集(除非你明确知道影响并做了适配)
  • 如果某结果集为空,Read() 仍会返回空集合(如 IEnumerable),不会报错

注意点:顺序必须严格匹配,不能跳过或乱序

GridReader 是“游标式”读取,结果集按 SQL 中 SELECT 出现的顺序依次消费,且不可回退、不可重复读。

  • 调用 Read() 一次,就向前推进一个结果集;跳过某个结果集会导致后续读取错位
  • 不要对同一个 GridReader 多次调用 Read() 读同一结果集(第二次会返回空)
  • 如果只想读前两个结果集,第三个不关心,也建议显式调用 multi.Read()multi.Skip()(Dapper v2+ 支持)来“跳过”,避免潜在异常

进阶技巧:泛型 ReadSingle / ReadFirstOrDefault / Skip

除了 Read()GridReader 还提供常用快捷方法:

  • ReadSingle():读取单值结果(如 SELECT COUNT(*)
  • ReadFirstOrDefault():读第一个对象,无数据时返回 default(T)
  • Skip()(Dapper ≥ 2.0):跳过当前结果集,适合忽略中间某个结果
  • IsConsumed 属性可检查是否所有结果集已被读完

基本上就这些。QueryMultiple 不复杂但容易忽略顺序和生命周期管理,用对了能显著简化多结果集场景的代码。

相关专题

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

数据分析工具有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++开发框架推荐,阅读专题下面的文章了解更多详细内容。

78

2026.01.09

热门下载

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

精品课程

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

共578课时 | 44.7万人学习

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

共12课时 | 1.0万人学习

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

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