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。
