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

GridReader 是 Dapper 用来一次性读取多个结果集的核心工具,它不是泛型集合,也不是数据容器,而是一个“游标式读取器”——你调用一次 Read,它就向前推进一个结果集,并把当前结果集的数据映射为你指定的类型。它的价值在于减少数据库往返,比如查用户、订单、订单明细,一条命令全拿回来。
GridReader 从哪来?怎么创建
它只能通过 QueryMultiple 方法获得,不能手动 new。这个方法接收一个含多个 SELECT(用分号隔开)的 SQL 字符串或存储过程名:
- SQL 必须是多个独立查询拼在一起,例如:
"SELECT * FROM Customers; SELECT * FROM Orders;" - 必须用
using包裹,因为GridReader实现了IDisposable,底层持有一个打开的SqlDataReader - 参数支持匿名对象或动态对象,和普通 Dapper 查询一样,自动参数化防注入
怎么按顺序读取每个结果集
GridReader 按 SQL 中 SELECT 出现的顺序逐个提供结果集。每次调用 Read 就消耗掉一个,不可回退、不可跳过:
-
grid.Read→ 取第一个结果集的唯一客户().Single() -
grid.Read→ 取第二个结果集的所有订单().ToList() -
grid.Read→ 取第三个结果集的所有明细().ToList() - 如果某结果集为空,
Read返回空集合(() IEnumerable),不会抛异常
常见注意事项和边界情况
用 GridReader 容易踩坑的地方不多,但几个关键点得盯住:
- 结果集顺序必须和 SQL 里
SELECT的顺序严格一致,否则类型错位,数据乱套 - 不能在读完一个结果集后反复调用同一个
Read—— 它只前进不倒带() - 如果某个结果集需要做聚合或条件过滤,建议先
.ToList()再处理,避免多次枚举引发异常 - 不支持异步读取(
ReadAsync),Dapper 目前的GridReader是同步 API
基本上就这些。它不复杂,但容易忽略顺序和生命周期管理。










