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

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

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<Order, User, Order>(<br/>
    sql,<br/>
    (order, user) =><br/>
    {<br/>
        order.Customer = user;<br/>
        return order;<br/>
    },<br/>
    splitOn: "Id" // 第二个 Id 是用户的 Id，所以在这里拆分<br/>
);<br/><br/>
foreach (var order in orders)<br/>
{<br/>
    Console.WriteLine($"{order.Amount} - {order.Customer.Name}");<br/>
}<br/>

}

注意事项

当使用多映射时，注意以下几点：

查询中的字段顺序必须与对象属性匹配，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 的多映射功能简洁高效，适合在保持轻量的同时处理关联数据。只要注意字段顺序和