AutoMapper通过约定自动映射同名属性,支持嵌套对象、集合转换及自定义规则,减少手动赋值代码。1. 基于属性名匹配自动映射;2. 配置Profile管理复杂映射;3. 支持深度嵌套与类型转换;4. 集成ASP.NET Core提升开发效率。

AutoMapper 是 .NET 中一个流行的对象映射库,主要用于简化不同对象类型之间的属性映射。比如在业务逻辑层和数据传输对象(DTO)之间转换时,手动逐个赋值属性既繁琐又容易出错。AutoMapper 通过约定和配置自动完成这些复制操作,大幅减少样板代码。
基本工作原理
AutoMapper 基于“约定优于配置”的原则,自动将源对象的属性映射到目标对象的同名属性上。只要两个对象的属性名称和类型匹配,就不需要额外配置。
例如,有一个 Employee 实体类和一个对应的 EmployeeDto 类:
public class Employee{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
public class EmployeeDto
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
使用 AutoMapper 可以直接将 Employee 实例映射为 EmployeeDto:
var config = new MapperConfiguration(cfg => cfg.CreateMapvar mapper = config.CreateMapper();
var employee = new Employee { Id = 1, Name = "张三", Email = "zhang@example.com" };
var dto = mapper.Map
如何简化映射过程
AutoMapper 提供多种方式减少手动编码,适应复杂场景。
支持深度嵌套对象映射如果对象包含子对象,AutoMapper 也能自动处理。例如:
- Order 包含 Customer 对象
- 只需定义 Order → OrderDto 和 Customer → CustomerDto 的映射
- AutoMapper 自动组合嵌套映射
当属性名不一致或需要转换逻辑时,可以显式配置:
.ForMember(dest => dest.EmailAddress, opt => opt.MapFrom(src => src.Email));
这会把源对象的 Email 映射到目标对象的 EmailAddress 属性。
类型转换与格式化- 支持内置类型转换(如 string 到 int)
- 可通过 AfterMap 或 ConvertUsing 添加自定义转换逻辑
- 例如日期格式化、枚举转字符串等
可以直接映射集合,无需遍历:
var employees = dbContext.Employees.ToList();var dtos = mapper.Map
- >(employees);
一行代码完成整个列表的转换。
集成与最佳实践
在 ASP.NET Core 项目中,通常在 Startup 或 Program 文件中注册 AutoMapper:
- 使用 AddAutoMapper 扫描程序集中所有 Profile 配置
- 通过继承 Profile 类集中管理映射规则
- 避免在运行时创建配置,提升性能
示例 Profile 类:
public class MappingProfile : Profile{
public MappingProfile()
{
CreateMap
CreateMap
}
}
基本上就这些。用好 AutoMapper 能显著提升开发效率,让对象转换更清晰、更可维护。










