Dapper如何映射私有属性 Dapper private setter映射方法

Dapper 默认不支持直接映射仅含 private set 的复杂类型属性，需通过 public setter 封装校验逻辑、注册 CustomPropertyTypeMap、使用 AS 别名配合 dynamic/匿名对象读取，或显式传参执行写操作。

Dapper 默认不支持直接映射到仅含 private set 的属性，尤其当属性类型是复杂对象（如自定义类）时。它能自动处理带 private set 的基础类型（如 string、int、DateTime），但对只读属性（get; 无 set）或私有 setter 不可达的场景，需额外干预。

用 public setter + 封装逻辑替代

最简单稳妥的做法是把 setter 设为 public，再在内部加保护逻辑，既满足 Dapper 映射，又不破坏业务约束：

例如：public string Name { get; set { _name = string.IsNullOrWhiteSpace(value) ? throw new ArgumentException("Name required") : value.Trim(); } }
避免完全暴露字段，而是把校验/转换逻辑放进 setter 中
适用于多数业务实体，开发和调试都直观

注册 CustomPropertyTypeMap 实现私有 setter 映射

当必须保留 strict 封装（如 DDD 领域模型），可用 SqlMapper.SetTypeMap 注册自定义映射器，显式告诉 Dapper 如何设置私有属性：

创建 CustomPropertyTypeMap 子类，重写 GetSetMethod，返回对应私有 setter 的 MethodInfo
调用 SqlMapper.SetTypeMap(typeof(YourEntity), new YourCustomMap()) 全局注册
注意：Dapper 6.0+ 对私有 setter 支持增强，但仍不自动识别复杂类型赋值，需确保 setter 可被反射访问（如非 private protected）

查询阶段用 AS 别名 + 动态/匿名对象过渡

如果只是读取（SELECT），不依赖强类型实体，可绕过 setter 限制：

SQL 中用 AS 对齐属性名：SELECT create_time AS CreateTime FROM book
先查为 dynamic 或 IDictionary，再手动构造目标对象
适合报表、DTO 映射等一次性场景，灵活但稍冗余

插入/更新时用匿名对象或 ExpandoObject

写操作无法靠私有 setter 自动填充，推荐显式传参：

插入：connection.Execute("INSERT INTO book (name, author) VALUES (@name, @author)", new { name = book.Name, author = book.Author })
避免传整个实体，而是提取需要的字段组成轻量对象
配合 SqlMapper.Bind 或自定义扩展方法可封装复用逻辑

基本上就这些。核心原则是：Dapper 优先契约胜于魔法——它不强制你改模型，但需要你明确告诉它“怎么设值”。选哪种方式，取决于你对封装强度、可维护性和团队规范的权衡。

# app # red # sql # String # Object # 封装 # 子类 # select # throw # int # public # private # protected # 对象 # typeof # 自定义 # 不支持 # 则是 # 设为 # 适用于 # 自动识别 # 你对 # 可达 # 重写

返回目录在线咨询

上一篇：JS二叉树的简单实现方法示例
下一篇：如何优化Apache服务器性能以应对高流量？

您的项目需求