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

星降
发布: 2025-12-14 09:07:16
原创
701人浏览过
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 在较新版本中支持通过配置开启非公共属性写入。需在应用启动时设置:

千鹿Pr助手
千鹿Pr助手

智能Pr插件,融入众多AI功能和海量素材

千鹿Pr助手 128
查看详情 千鹿Pr助手
  • 调用 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))));
登录后复制

用 Dapper.Contrib 的 [Write(false)] + 私有字段回填

如果你用的是 Dapper.Contrib 扩展包,它本身不支持只读属性,但可以反向操作:把值先写进私有字段,再由只读属性读取。

  • 给类加 [Table("Products")] 特性
  • [ExplicitKey] 标识主键,其他字段保持 private set
  • 查询仍用原生 Query<t>()</t>,不走 Contrib 的 GetAsync 方法(它依赖 public set)

也就是说:Contrib 适合增删改,只读映射推荐回归原生 Dapper + 构造函数方案。

避免踩坑的细节提醒

  • 字段名和属性名不一致时,SQL 中一定要用 AS 显式别名,否则构造函数绑定失败
  • 若属性是 get; init;(C# 9+),Dapper 默认支持,无需额外配置
  • 异步方法如 QueryFirstOrDefaultAsync<t>()</t> 同样适用上述所有方式
  • 不要依赖 [ReadOnly(true)] 这类自定义特性——Dapper 不识别它们

基本上就这些。构造函数方式最稳定,也最符合领域模型封装原则。

以上就是Dapper如何映射到只读属性 Dapper Readonly Property映射的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号