Dapper怎么查询并返回dynamic列表 Dapper动态类型查询用法

Dapper 支持 Query() 直接返回动态对象，自动映射为 ExpandoObject，可通过列名或别名访问字段；适用于不确定结构场景，但无编译检查，需防 Null 和拼写错误，正式项目建议优先使用强类型。

Dapper 支持直接查询返回 dynamic 类型，无需提前定义实体类，适合快速获取不确定结构或临时数据的场景。核心是使用 Query() 方法，Dapper 会自动将每行结果映射为 IDictionary 的动态包装对象（实际是 ExpandoObject），可通过属性名直接访问字段。

基本用法：Query 查询单表

最常用方式是调用 connection.Query(sql)，SQL 返回的每一列都会变成 dynamic 对象的一个属性：

• 字段名不区分大小写（但建议保持 SQL 中的命名风格一致）
• NULL 值会映射为 null（对应 C# 的 null，不是字符串 "null"）
• 支持别名（SELECT Name AS UserName → 可用 item.UserName 访问）

示例：

var sql = "SELECT Id, Name, Email FROM Users WHERE Status = @status";
var users = connection.Query(sql, new { status = "Active" }).ToList();

foreach (var u in users)
{
  Console.WriteLine($"{u.Id} - {u.Name} "); // 属性名直接来自列名或别名
}

处理多表 JOIN 或匿名结构

即使 SQL 包含 JOIN、计算列、函数结果（如 COUNT(*)、GETDATE()），只要列有明确名称（推荐用别名），dynamic 就能正常访问：

• 避免无名字段，比如 SELECT COUNT(*) 应写成 SELECT COUNT(*) AS Total
• JOIN 后同名列需显式别名，否则后一个会覆盖前一个（如 u.Id AS UserId, o.Id AS OrderId）
• 动态对象属性访问是运行时绑定，拼写错误会在运行时报 RuntimeBinderException

示例：

var sql = @"
SELECT u.Name, COUNT(o.Id) AS OrderCount
FROM Users u
LEFT
 JOIN Orders o ON u.Id = o.UserId
GROUP BY u.Id, u.Name";

var result = connection.Query(sql).ToList();
foreach (var r in result)
{
  Console.WriteLine($"{r.Name} has {r.OrderCount} orders");
}

安全访问 dynamic 字段（防 Null 和拼写错误）

dynamic 没有编译期检查，建议加一层防护：

• 用 TryGetMember 或转换为 IDictionary 再判断 key 存在性
• 访问前判空：if (u?.Name != null) ...
• 用扩展方法封装安全取值（如 u.SafeGetString("Name")）
• 开发阶段可先用 var first = result.FirstOrDefault(); Console.WriteLine(first); 查看实际属性名

注意：dynamic 不等于 var，也不支持 LINQ to Objects 的强类型操作

dynamic 是运行时解析，不能直接对 IEnumerable 使用 .Where(x => x.Age > 18) 这类 LINQ 表达式（会报错）；如需过滤，得转成 List 或先映射为具体类型：

• 简单过滤可用 foreach + 手动判断
• 复杂逻辑建议改用强类型实体类 + Query()
• 如果只是投影部分字段，考虑用匿名类型 Query（但注意：Dapper 不支持直接 Query，需用 Query 后再 Select）

基本上就这些。dynamic 查询灵活轻量，适合脚本化、配置化或原型开发，但正式项目中建议优先用强类型保障可维护性。