.NET中的AutoMapper是什么?如何简化对象之间的映射?

来源:这里教程网 时间:2026-02-21 17:31:23 作者:

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.CreateMap());
var mapper = config.CreateMapper();

var employee = new Employee { Id = 1, Name = "张三", Email = "zhang@example.com" };
var dto = mapper.Map(employee);

如何简化映射过程

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) 可通过 AfterMapConvertUsing 添加自定义转换逻辑 例如日期格式化、枚举转字符串等 集合映射

可以直接映射集合,无需遍历:

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 能显著提升开发效率,让对象转换更清晰、更可维护。

相关推荐

热文推荐