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 自动组合嵌套映射 自定义映射规则当属性名不一致或需要转换逻辑时,可以显式配置:
cfg.CreateMap.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 能显著提升开发效率,让对象转换更清晰、更可维护。
