跳转到主内容
websoft网络软件专家 - 深耕网络技术,打造实用软件!

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

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 基本上就这些。它不复杂,但容易忽略顺序和生命周期管理。

相关文章