0

0

Dapper中GridReader是什么 Dapper GridReader用法详解

月夜之吻

月夜之吻

发布时间:2026-01-06 10:16:03

|

418人浏览过

|

来源于php中文网

原创

GridReader是Dapper中通过QueryMultiple创建的游标式读取器,用于按SQL中SELECT顺序一次性读取多个结果集;必须using包裹,每次Read()消耗一个结果集,不可回退,不支持异步。

dapper中gridreader是什么 dapper gridreader用法详解

GridReader 是 Dapper 用来一次性读取多个结果集的核心工具,它不是泛型集合,也不是数据容器,而是一个“游标式读取器”——你调用一次 Read(),它就向前推进一个结果集,并把当前结果集的数据映射为你指定的类型。它的价值在于减少数据库往返,比如查用户、订单、订单明细,一条命令全拿回来。

GridReader 从哪来?怎么创建

它只能通过 QueryMultiple 方法获得,不能手动 new。这个方法接收一个含多个 SELECT(用分号隔开)的 SQL 字符串或存储过程名:

  • SQL 必须是多个独立查询拼在一起,例如:"SELECT * FROM Customers; SELECT * FROM Orders;"
  • 必须用 using 包裹,因为 GridReader 实现了 IDisposable,底层持有一个打开的 SqlDataReader
  • 参数支持匿名对象或动态对象,和普通 Dapper 查询一样,自动参数化防注入

怎么按顺序读取每个结果集

GridReader 按 SQL 中 SELECT 出现的顺序逐个提供结果集。每次调用 Read() 就消耗掉一个,不可回退、不可跳过:

LogoAi
LogoAi

利用AI来设计你喜欢的Logo和品牌标志

下载
  • grid.Read().Single() → 取第一个结果集的唯一客户
  • grid.Read().ToList() → 取第二个结果集的所有订单
  • grid.Read().ToList() → 取第三个结果集的所有明细
  • 如果某结果集为空,Read() 返回空集合(IEnumerable),不会抛异常

常见注意事项和边界情况

用 GridReader 容易踩坑的地方不多,但几个关键点得盯住:

  • 结果集顺序必须和 SQL 里 SELECT 的顺序严格一致,否则类型错位,数据乱套
  • 不能在读完一个结果集后反复调用同一个 Read() —— 它只前进不倒带
  • 如果某个结果集需要做聚合或条件过滤,建议先 .ToList() 再处理,避免多次枚举引发异常
  • 不支持异步读取(ReadAsync),Dapper 目前的 GridReader 是同步 API

基本上就这些。它不复杂,但容易忽略顺序和生命周期管理。

相关专题

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

数据分析工具有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错误的相关内容,可以阅读本专题下面的文章。

1092

2024.03.06

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

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

356

2024.03.06

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

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

674

2024.04.07

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

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

571

2024.04.29

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

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

412

2024.04.29

PPT动态图表制作教程大全
PPT动态图表制作教程大全

本专题整合了PPT动态图表制作相关教程,阅读专题下面的文章了解更多详细内容。

12

2026.01.07

热门下载

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

精品课程

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

共578课时 | 42.9万人学习

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

共12课时 | 0.9万人学习

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

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