Dapper如何映射到私有构造函数的类 Dapper private constructor映射

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

Dapper 默认不支持直接映射到具有私有构造函数的类，因为它依赖于反射创建实例，而私有构造函数在没有显式指定时通常不会被调用（尤其当存在公有无参构造函数时）。但你可以通过几种方式让 Dapper 正确映射到私有构造函数的类。

使用带有参数的私有构造函数 + [Dapper.Constructor] 特性（推荐）

Dapper 从 v2.0 开始支持

[Dapper.Constructor]

特性，用于标记你希望 Dapper 在构造对象时调用的构造函数。只要该构造函数参数名与查询字段名（或别名）匹配，Dapper 就能自动绑定并调用它。

确保引用的是 Dapper ≥ 2.0（如
Dapper 2.1.24
或更高）在目标构造函数上添加
[Dapper.Constructor]
参数名需与 SQL 查询中的列名（或别名）严格一致（区分大小写取决于数据库和设置）

public class User
{
    public int Id { get; }
    public string Name { get; }
    [Dapper.Constructor]
    private User(int id, string name)
    {
        Id = id;
        Name = name;
    }
}
// 查询必须返回对应字段名（或别名）
var users = connection.Query<User>("SELECT Id, Name FROM Users");

手动指定映射：使用 Query(sql, map: ...) 重载

如果你无法修改类（比如是第三方类型），或想完全控制映射逻辑，可以用 Dapper 的

map

参数手动构造对象。

传入一个
Func<idatareader object t></idatareader>
显式读取字段并调用私有构造函数 适合复杂初始化、字段名不匹配、或需要转换逻辑的场景

var users = connection.Query<User>(
    "SELECT UserId AS id, UserName AS name FROM Users",
    (reader, values) => new User((int)values[0], (string)values[1])
);