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

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

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 查询灵活轻量,适合脚本化、配置化或原型开发,但正式项目中建议优先用强类型保障可维护性。

相关推荐