C#中如何使用Dapper的多映射功能?示例是什么?

c#中如何使用dapper的多映射功能?示例是什么?

在C#中使用Dapper的多映射(Multi-mapping)功能,可以将一条SQL查询返回的结果映射到多个关联的对象上。这在处理具有外键关系的表时特别有用,比如订单和用户、文章和作者等。

关键在于使用

splitOn

参数来指定从哪一列开始拆分结果映射到下一个对象。

基本用法说明

Dapper 的

Query

方法支持多映射,语法如下:

Query(sql, mapper, splitOn)

T1, T2:要映射的两个类类型TResult:最终返回的类型(通常为 T1 或一个组合类型)mapper:定义如何将 T1 和 T2 组合起来的委托splitOn:指定从哪个字段开始被视为第二个对象的起点(默认是 “Id”,如果不是需显式指定)

示例:订单与用户关联查询

假设有两个类:

public class User
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}

public class Order
{
public int Id { get; set; }
public decimal Amount { get; set; }
public int UserId { get; set; }
public User Customer { get; set; } // 导航属性
}

现在想通过一次查询获取订单及其对应的用户信息,并填充到

Order.Customer

中。

using (var connection = new SqlConnection(connectionString))
{
var sql = @”
SELECT o.Id, o.Amount, o.UserId, u.Id, u.Name, u.Email
FROM Orders o
INNER JOIN Users u ON o.UserId = u.Id”;

var orders = connection.Query(
sql,
(order, user) =>
{
order.Customer = user;
return order;
},
splitOn: "Id" // 第二个 Id 是用户的 Id,所以在这里拆分
);

foreach (var order in orders)
{
Console.WriteLine($"{order.Amount} - {order.Customer.Name}");
}

}

注意事项

当使用多映射时,注意以下几点:

查询中的字段顺序必须与对象属性匹配,Dapper 按顺序映射如果第二个对象的主键不是 “Id”,一定要正确设置

splitOn

,例如:

splitOn: "UserId"

支持最多 7 个对象映射(T1 到 T7),适用于复杂联表查询性能高,适合需要 JOIN 多表且不想使用 ORM 负载的场景

三表联合映射示例(扩展)

比如订单、用户、产品三个表:

var sql = @”
SELECT o.Id, o.Amount, u.Id, u.Name, p.Id, p.Title
FROM Orders o
JOIN Users u ON o.UserId = u.Id
JOIN Products p ON o.ProductId = p.Id”;

var result = connection.Query(
sql,
(order, user, product) =>
{
order.Customer = user;
order.Item = product;
return order;
},
splitOn: “Id,Id” // 第一个 Id 后是 User,第二个 Id 后是 Product
);

基本上就这些。Dapper 的多映射功能简洁高效,适合在保持轻量的同时处理关联数据。只要注意字段顺序和

splitOn

的设置,就能避免映射错误。

以上就是C#中如何使用Dapper的多映射功能?示例是什么?的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1439865.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 16:33:35
下一篇 2025年12月17日 16:33:49

相关推荐

发表回复

登录后才能评论
关注微信