Dapper如何映射到只读属性 Dapper Readonly Property映射

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Dapper如何映射到只读属性 Dapper Readonly Property映射

2025-12-14

浏览次数：次

返回列表

Dapper 默认不映射只读属性，但可通过构造函数参数匹配、启用非公共成员访问或自定义 TypeMap 实现映射；推荐使用构造函数方式，要求 SQL 列名与参数名严格一致。

dapper如何映射到只读属性 dapper readonly property映射

Dapper 默认只映射 public set 的属性，遇到只读属性（比如 public string Name { get; } 或 private set）时，不会自动赋值。但可以通过几种方式实现映射，关键是让 Dapper 知道“这个字段要写进去”，即使 setter 不公开。

用构造函数参数匹配字段名

Dapper 支持通过构造函数注入完成只读属性初始化。只要 SQL 查询列名和构造函数参数名完全一致（大小写敏感），Dapper 就会用该参数创建对象。

实体类需定义含参构造函数，参数名与数据库字段/别名严格对应
属性声明为只读（get;）或私有 setter（get; private set;）均可
查询时使用 Query<t>()</t>，Dapper 自动绑定构造参数

示例：

public class Product
{
    public int Id { get; }
    public string Name { get; }
    public decimal Price { get; }
<pre class='brush:php;toolbar:false;'>public Product(int id, string name, decimal price)
{
    Id = id;
    Name = name;
    Price = price;
}

}

SQL 查询必须用别名对齐参数名：SELECT Id, Name, Price FROM Products

启用非公共成员访问（.NET Core/.NET 5+）

Dapper 在较新版本中支持通过配置开启非公共属性写入。需在应用启动时设置：

Glean

Glean是一个专为企业团队设计的AI搜索和知识发现工具

210 查看详情 Glean

调用 Dapper.DefaultTypeMap.MatchNamesWithUnderscores = true;（可选，用于下划线转驼峰）
关键一步：设置 Dapper.SqlMapper.SetTypeMap 或启用 UseConstructorBinding = false 并配合反射权限
更直接的方式：在 Query<t>()</t> 前临时启用私有 setter 赋值

实际常用做法是添加一行初始化代码（仅需一次）：

Dapper.SqlMapper.AddTypeMap(typeof(Product), 
    new CustomPropertyTypeMap(typeof(Product), 
        (type, columnName) => type.GetProperties()
            .FirstOrDefault(p => p.Name.Equals(columnName, StringComparison.OrdinalIgnoreCase))));