在C#中使用Dapper的多映射（Multi-mapping）功能，可以将一条SQL查询返回的结果映射到多个关联的对象上。这在处理具有外键关系的表时特别有用，比如订单和用户、文章和作者等。
关键在于使用
splitOn参数来指定从哪一列开始拆分结果映射到下一个对象。
基本用法说明
Dapper 的
Query方法支持多映射，语法如下：
Query
- 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.QueryzuojiankuohaophpcnOrder, User, Orderyoujiankuohaophpcn(
sql,
(order, user) =youjiankuohaophpcn
{
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的设置，就能避免映射错误。
