Dapper怎么查询DataTable Dapper返回DataTable方法

Dapper 本身不提供直接返回 DataTable 的扩展方法，但可通过 ExecuteReader() 配合 DataTable.Load() 实现；该方式轻量高效，兼容各类 ADO.NET 提供程序，适用于动态列、旧系统集成等场景，且无需额外依赖。

Dapper 本身不提供直接返回 DataTable 的扩展方法，但可以通过底层的 IDbConnection.ExecuteReader() 配合 DataTable.Load() 快速实现。这种方式既保留了 Dapper 的轻量和高效，又满足了需要 DataTable 的场景（如动态列、旧系统集成、Excel 导出、WinForms 绑定等）。

用 ExecuteReader + Load 构建 DataTable

这是最常用、最简洁的方式，不依赖额外封装，直接利用 ADO.NET 原生能力：

• 调用 conn.ExecuteReader(sql, param) 获取 IDataReader
• 新建一个 DataTable 实例
• 调用 dt.Load(reader) 自动填充结构和数据
• 注意：reader 必须未关闭，且在 using 块内完成 Load

示例代码：

using (var conn = new SqlConnection(connectionString))
{
    conn.Open();
    var reader = await conn.ExecuteReaderAsync("SELECT Id, Name, Age FROM Users WHERE Age > @minAge", 
        new { minAge = 18 });
    var dt = new DataTable();
    dt.Load(reader); // ✅ 关键一步
    return dt;
}

封装成通用扩展方法

为避免重复写样板代码，可封装为 IDbConnection 的扩展方法：

• 方法签名建议： public static DataTable QueryDataTable(this IDbConnection cnn, string sql, object param = null, ...)
• 内部仍走 ExecuteReader → DataTable.Load 流程
• 支持异步（ExecuteReaderAsync）、超时、事务等参数
• 无需引用其他 ORM 或第三方 DataTable 工具包

小提示：如果项目中大量使用，建议统一放在 DapperExtensions.cs 中，保持风格一致。

注意 .NET Core/.NET 5+ 的驱动兼容性

在较新版本（.NET Core 3.1+ / .NET 5+）中：

• 推荐使用 Microsoft.Data.SqlClient 替代已过时的 System.Data.SqlClient
• 确保你的连接字符串和 NuGet 包版本匹配（如 Microsoft.Data.SqlClient 5.x）
• DataTable.Load(IDataReader) 在新版驱动中完全可用，无兼容问题

若用的是 SQLite、MySQL 等数据库，只要其 ADO.NET Provider 实现了标准 IDataReader，此方案同样适用。

为什么不直接用 Query 再转 DataTable？

虽然可行，但不推荐：

• 先映射到强类型 List，再反射遍历转 DataTable —— 多一次内存分配和循环，性能损耗明显
• 丢失原始列名大小写、空值处理细节（比如 DBNull 和 null 的差异）
• 无法处理匿名类型或运行时才确定结构的查询（如动态 SQL、PIVOT 结果）

所以，直连 ExecuteReader 是更干净、更可控的选择。

基本上就这些。不需要引入新库，也不用改架构，几行代码就能让 Dapper “输出” DataTable。