Dapper怎么映射动态对象 Dapper查询返回dynamic类型

来源：这里教程网时间：2026-02-21 17:35:59 作者：

Dapper 查询返回

dynamic

类型，本质上是让 Dapper 自动将每一行结果包装成一个

ExpandoObject

（动态对象），字段名作为属性名，值作为属性值。这种方式适合不确定结构的查询（比如 SELECT *、多表拼接、运行时构造 SQL），但要注意性能和类型安全问题。

用 Query 获取动态结果

直接调用

Query<dynamic>()</dynamic>

方法，Dapper 会自动映射为

ExpandoObject

的集合：

写法示例：var rows = conn.Query("SELECT Id, Name, CreatedTime FROM Users WHERE Status = @status", new { status = 1 }); 返回的是
IEnumerable<dynamic></dynamic>
，遍历时可直接访问属性，如
row.Id
、
row.Name
如果字段名含空格或特殊字符（如
First Name
），需用方括号语法：
row["First Name"]

动态对象的属性访问与注意事项

dynamic

对象在编译期不检查属性是否存在，运行时才解析，容易出错：

访问不存在的属性会抛
RuntimeBinderException
，建议加
try/catch
或先判断：if (row is IDictionary dict && dict.ContainsKey("Age")) { ... } 不能用
var x = row.Age;
然后直接传给强类型方法——除非目标方法参数也是
dynamic
，否则会编译失败或运行时报错数值类型默认是
object
，需要显式转换：
(int)row.Id
或
Convert.ToInt32(row.Id)

替代方案：用匿名类型更安全（推荐用于已知结构）

如果只是临时用、结构固定，用匿名类型比

dynamic

更清晰、有 IDE 提示、编译期检查：

var rows = conn.Query("SELECT Id, Name FROM Users").Select(x => new { Id = x.Id, Name = x.Name }); 或者直接
Query<anonymous></anonymous>
不行，但可以写成：var rows = conn.Query("SELECT Id, Name FROM Users").Select(x => new { x.Id, x.Name }); 缺点：无法跨方法传递（匿名类型是 internal 的），适合局部快速处理

进阶：手动构建 ExpandoObject（按需动态列）

当列名完全由变量控制（比如用户自定义报表字段），可用

IDataReader

+ 手动读取：

用
conn.ExecuteReader(sql)
获得
IDataReader
遍历
reader.FieldCount
，用
reader.GetName(i)
和
reader.GetValue(i)
构建
ExpandoObject
这样能完全控制映射逻辑，比如跳过 NULL 字段、重命名列、类型预处理等

基本上就这些。用