Dapper 支持通过 QueryMultiple 方法一次性执行 SQL 查询并返回多个结果集。这种方式能有效减少数据库往返次数,提升性能,特别适用于需要一次获取多组数据的场景。
使用 QueryMultiple 的基本步骤
调用
QueryMultiple执行包含多个 SELECT 语句的命令,然后按顺序从返回的
GridReader中读取每个结果集。 使用
connection.QueryMultiple(sql)执行多结果查询 调用
gridReader.Read<t>()</t>逐个读取结果集 确保读取顺序与 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<User>().FirstOrDefault();
var orders = multi.Read<Order>().ToList();
// 处理数据
Console.WriteLine($"User: {user?.Name}");
Console.WriteLine($"Orders Count: {orders.Count}");
}
}
注意事项和最佳实践
使用多结果集时要注意资源管理和执行逻辑的正确性。
必须按顺序读取结果集,不能跳过中间任何一个 即使某个结果集不需要,也应调用Read()消费它 建议始终将
GridReader包裹在 using 块中防止资源泄漏 适用于存储过程返回多个结果的情况,例如报表数据组合 SQL Server 中可通过一个存储过程返回多个结果集,Dapper 同样支持 基本上就这些。Dapper 的多结果集功能简洁高效,适合在需要批量获取关联数据时使用。
