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

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