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

Dapper 查询返回 dynamic 类型本质是映射为 ExpandoObject 集合，适用于结构不确定的查询，但存在性能与类型安全风险；推荐结构明确时使用实体类或匿名类型。

Dapper 查询返回 dynamic 类型，本质上是让 Dapper 自动将每一行结果包装成一个 ExpandoObject（动态对象），字段名作为属性名，值作为属性值。这种方式适合不确定结构的查询（比如 select *、多表拼接、运行时构造 sql），但要注意性能和类型安全问题。

用 Query 获取动态结果

直接调用 Query() 方法，Dapper 会自动映射为 ExpandoObject 的集合：

• 写法示例：var rows = conn.Query(“SELECT Id, Name, CreatedTime FROM Users WHERE Status = @status”, new { status = 1 });
• 返回的是 IEnumerable，遍历时可直接访问属性，如 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 不行，但可以写成：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 字段、重命名列、类型预处理等

基本上就这些。用 dynamic 是为了灵活，不是为了偷懒；结构明确时优先用实体类或匿名类型，既快又稳。