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 优先契约胜于魔法——它不强制你改模型，但需要你明确告诉它“怎么设值”。选哪种方式，取决于你对封装强度、可维护性和团队规范的权衡。