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

来源：这里教程网时间：2026-02-21 17:37:03 作者：

GridReader 是 Dapper 用来一次性读取多个结果集的核心工具，它不是泛型集合，也不是数据容器，而是一个“游标式读取器”——你调用一次

Read<t>()</t>

，它就向前推进一个结果集，并把当前结果集的数据映射为你指定的类型。它的价值在于减少数据库往返，比如查用户、订单、订单明细，一条命令全拿回来。

GridReader 从哪来？怎么创建

它只能通过

QueryMultiple

方法获得，不能手动 new。这个方法接收一个含多个

SELECT

（用分号隔开）的 SQL 字符串或存储过程名：

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

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

GridReader 按 SQL 中

SELECT

出现的顺序逐个提供结果集。每次调用

Read<t>()</t>

就消耗掉一个，不可回退、不可跳过：

grid.Read<customer>().Single()</customer>
→ 取第一个结果集的唯一客户
grid.Read<order>().ToList()</order>
→ 取第二个结果集的所有订单
grid.Read<orderdetail>().ToList()</orderdetail>
→ 取第三个结果集的所有明细如果某结果集为空，
Read<t>()</t>
返回空集合（
IEnumerable<t></t>
），不会抛异常

常见注意事项和边界情况

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

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

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