Dapper多映射：如何指定属性的映射顺序？

针对你的Instance和Entity类结构，在Dapper多映射时，属性的映射优先级主要由查询结果的列顺序和splitOn参数的设置来控制，同时可以通过列别名避免冲突。下面是具体的实现思路和示例：

1. 核心映射规则 #

Dapper的多映射（比如Query<Instance, Entity, Instance>）是按结果集顺序处理对象的：

• 先把结果集中splitOn参数指定列之前的所有列，映射到第一个泛型类型（也就是Instance）
• 从splitOn标记的列开始，后续所有列映射到第二个泛型类型（也就是Entity）
• 最后通过你定义的映射委托，把Entity对象赋值给Instance的Entity属性

简单说：splitOn之前的列优先映射主对象（Instance），之后的列映射关联对象（Entity）。

2. 解决同名属性冲突（关键步骤） #

如果Instance和Entity有同名属性（比如都有Id、Name），一定要在SQL查询里给列加别名，否则Dapper会优先把值映射到先处理的主对象（Instance），导致关联对象的属性无法正确赋值。

示例SQL查询：

SELECT 
    i.Id AS InstanceId, 
    i.Name AS InstanceName, 
    i.Attributes,
    e.Id AS EntityId, 
    e.Name AS EntityName
FROM Instance i
JOIN Entity e ON i.EntityId = e.Id

3. 完整多映射代码实现 #

在代码中指定splitOn参数，明确告诉Dapper从哪一列开始切换到映射Entity，同时通过委托完成对象关联：

using (var connection = new SqlConnection("你的数据库连接字符串"))
{
    var sql = @"SELECT 
                    i.Id AS InstanceId, 
                    i.Name AS InstanceName, 
                    i.Attributes,
                    e.Id AS EntityId, 
                    e.Name AS EntityName
                FROM Instance i
                JOIN Entity e ON i.EntityId = e.Id";

    var instances = connection.Query<Instance, Entity, Instance>(
        sql,
        (instance, entity) => 
        {
            instance.Entity = entity;
            return instance;
        },
        splitOn: "EntityId" // 从EntityId列开始，后续列映射到Entity对象
    ).ToList();
}

4. 针对你的Attributes属性的注意事项 #

你的Instance类中Attributes属性的setter会自动触发JsonConvert.PopulateObject填充AttributeList，只要查询返回的Attributes列是合法的JSON字符串，Dapper会直接映射这个字符串值到Attributes属性，不需要额外配置。

5. 特殊场景下的强制优先级控制 #

如果遇到必须调整属性映射优先级的情况（比如同名属性需要优先赋值给Entity），可以用两种方式：

• 调整SQL查询的列顺序，把需要优先映射给关联对象的列放在splitOn之后
• 使用Dapper的ColumnAttribute给类属性指定对应列名，比如：

public class Instance
{
    [Column("InstanceId")]
    public int Id { get; set; }

    [Column("InstanceName")]
    public string Name { get; set; }
    // 其他属性...
}

public class Entity
{
    [Column("EntityId")]
    public int Id { get; set; }

    [Column("EntityName")]
    public string Name { get; set; }
    // 其他属性...
}

这样即使列顺序有变化，Dapper也会根据ColumnAttribute的指定精准映射，规避优先级冲突。

内容的提问来源于stack exchange，提问作者Red Wei