Dapper通过QueryMultiple方法支持一次执行多个SELECT查询并按顺序读取结果集，减少数据库往返次数。使用时需用using管理GridReader资源，依次调用Read()获取每个结果集，适用于获取用户及订单等关联数据场景。
Dapper 支持通过 QueryMultiple 方法一次性执行 SQL 查询并返回多个结果集。这种方式能有效减少数据库往返次数，提升性能，特别适用于需要一次获取多组数据的场景。
使用 QueryMultiple 的基本步骤
调用 QueryMultiple 执行包含多个 SELECT 语句的命令，然后按顺序从返回的 GridReader 中读取每个结果集。
- 使用
connection.QueryMultiple(sql)执行多结果查询 - 调用
gridReader.Read逐个读取结果集() - 确保读取顺序与 SQL 中的 SELECT 顺序一致
- 使用完后释放
GridReader资源（推荐用 using）
实际示例：获取用户及其订单信息
public class User
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
public class Order
{
public int Id { get; set; }
public int UserId { get; set; }
public decimal Amount { get; set; }
public DateTime OrderDate { get; set; }
}
// 使用 Dapper 多结果集
using (var connection = new SqlConnection(connectionString))
{
const string sql = @"
SELECT Id, Name, Email FROM Users WHERE Id = @UserId;
SELECT Id, UserId, Amount, OrderDate FROM Orders WHERE UserId = @UserId;
";
using (var multi = connection.QueryMultiple(sql, new { UserId = 1 }))
{
var user = multi.Read().FirstOrDefault();
var orders = multi.Read().ToList();
// 处理数据
Console.WriteLine($"User: {user?.Name}");
Console.WriteLine($"Orders Count: {orders.Count}");
}
}
注意事项和最佳实践
使用多结果集时要注意资源管理和执行逻辑的正确性。
- 必须按顺序读取结果集，不能跳过中间任何一个
- 即使某个结果集不需要，也应调用
Read()消费它 - 建议始终将
GridReader包裹在 using 块中防止资源泄漏 - 适用于存储过程返回多个结果的情况，例如报表数据组合
- SQL Server 中可通过一个存储过程返回多个结果集，Dapper 同样支持
