dapper 支持 query() 直接返回动态对象，自动映射为 expandoobject，可通过列名或别名访问字段；适用于不确定结构场景，但无编译检查，需防 null 和拼写错误，正式项目建议优先使用强类型。
Dapper 支持直接查询返回 dynamic 类型，无需提前定义实体类，适合快速获取不确定结构或临时数据的场景。核心是使用 Query<dynamic>()</dynamic> 方法，Dapper 会自动将每行结果映射为 IDictionary<string object></string> 的动态包装对象（实际是 ExpandoObject），可通过属性名直接访问字段。
基本用法：Query 查询单表
最常用方式是调用 connection.Query<dynamic>(sql)</dynamic>，SQL 返回的每一列都会变成 dynamic 对象的一个属性：
- 字段名不区分大小写（但建议保持 SQL 中的命名风格一致）
- NULL 值会映射为
null（对应 C# 的null，不是字符串 "null"） - 支持别名（
SELECT Name AS UserName→ 可用item.UserName访问）
示例：
var sql = "SELECT Id, Name, Em<a style="color:#f60; text-decoration:underline;" title="ai" href="https://www.php.cn/zt/17539.html" target="_blank">ai</a>l FROM Users WHERE Status = @status";<br>var users = connection.Query<dynamic>(sql, new { status = "Active" }).ToList();<br><br>foreach (var u in users)<br>{<br> Console.WriteLine($"{u.Id} - {u.Name} "); // 属性名直接来自列名或别名<br>}</dynamic>处理多表 JOIN 或匿名结构
即使 SQL 包含 JOIN、计算列、函数结果（如 COUNT(*)、GETDATE()），只要列有明确名称（推荐用别名），dynamic 就能正常访问：
- 避免无名字段，比如
SELECT COUNT(*)应写成SELECT COUNT(*) AS Total - JOIN 后同名列需显式别名，否则后一个会覆盖前一个（如
u.Id AS UserId, o.Id AS OrderId） - 动态对象属性访问是运行时绑定，拼写错误会在运行时报
RuntimeBinderException
示例：
var sql = @"<br>SELECT u.Name, COUNT(o.Id) AS OrderCount<br>FROM Users u<br>LEFT JOIN Orders o ON u.Id = o.UserId<br>GROUP BY u.Id, u.Name";<br><br>var result = connection.Query<dynamic>(sql).ToList();<br>foreach (var r in result)<br>{<br> Console.WriteLine($"{r.Name} has {r.OrderCount} orders");<br>}</dynamic>安全访问 dynamic 字段（防 Null 和拼写错误）
dynamic 没有编译期检查，建议加一层防护：
- 用
TryGetMember或转换为IDictionary<string object></string>再判断 key 存在性 - 访问前判空：
if (u?.Name != null) ... - 用扩展方法封装安全取值（如
u.SafeGetString("Name")） - 开发阶段可先用
var first = result.FirstOrDefault(); Console.WriteLine(first);查看实际属性名
注意：dynamic 不等于 var，也不支持 LINQ to Objects 的强类型操作
dynamic 是运行时解析，不能直接对 IEnumerable<dynamic></dynamic> 使用 .Where(x => x.Age > 18) 这类 LINQ 表达式（会报错）；如需过滤，得转成 List<object></object> 或先映射为具体类型：
- 简单过滤可用
foreach+ 手动判断 - 复杂逻辑建议改用强类型实体类 +
Query<user>()</user> - 如果只是投影部分字段，考虑用匿名类型
Query<object>().Select(x => new { ... })</object>（但注意：Dapper 不支持直接Query<object></object>，需用Query<dynamic></dynamic>后再 Select）
基本上就这些。dynamic 查询灵活轻量，适合脚本化、配置化或原型开发，但正式项目中建议优先用强类型保障可维护性。
