C#中如何使用Dapper的多结果集功能?示例是什么?

来源:这里教程网 时间:2026-02-21 17:27:50 作者:

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 的多结果集功能简洁高效,适合在需要批量获取关联数据时使用。

相关推荐