C#怎么使用AutoMapper C#对象属性映射配置方法

在C#项目开发中，不同层级的实体类之间经常需要做属性转换，比如数据库实体转DTO、DTO转前端展示模型等场景，手动编写赋值代码会非常繁琐。AutoMapper就是专门解决这类对象映射问题的工具，能够通过配置好的映射规则自动完成属性赋值。

AutoMapper安装

首先需要在项目中安装AutoMapper的NuGet包，可以通过包管理器控制台执行以下命令：

// 安装AutoMapper核心包
Install-Package AutoMapper
// 如果使用依赖注入，还需要安装扩展包
Install-Package AutoMapper.Extensions.Microsoft.DependencyInjection

基础映射配置

假设我们有两个实体类，一个是用户数据库实体UserEntity，一个是用户DTOUserDTO，两个类的属性大部分名称一致，需要做映射。

// 数据库实体类
public class UserEntity
{
    public int Id { get; set; }
    public string UserName { get; set; }
    public string Email { get; set; }
    public DateTime CreateTime { get; set; }
}

// 用户DTO类
public class UserDTO
{
    public int Id { get; set; }
    public string UserName { get; set; }
    public string Email { get; set; }
    public string CreateTime { get; set; }
}

接下来创建映射配置类，继承Profile：

using AutoMapper;

public class UserProfile : Profile
{
    public UserProfile()
    {
        // 创建UserEntity到UserDTO的映射
        CreateMap<UserEntity, UserDTO>()
            // 自定义CreateTime的映射规则，将DateTime转为字符串
            .ForMember(dest => dest.CreateTime, opt => opt.MapFrom(src => src.CreateTime.ToString("yyyy-MM-dd HH:mm:ss")));
    }
}

依赖注入中使用AutoMapper

在ASP.NET Core项目中，可以在Program.cs中注册AutoMapper：

var builder = WebApplication.CreateBuilder(args);

// 注册AutoMapper，会自动扫描程序集中的Profile配置
builder.Services.AddAutoMapper(typeof(Program));

var app = builder.Build();

然后在服务中注入IMapper使用：

using AutoMapper;

public class UserService
{
    private readonly IMapper _mapper;

    public UserService(IMapper mapper)
    {
        _mapper = mapper;
    }

    public UserDTO GetUserDTO(UserEntity userEntity)
    {
        // 执行映射
        return _mapper.Map<UserDTO>(userEntity);
    }
}

特殊场景映射配置

属性名称不一致的映射

如果两个类的属性名称不一样，比如UserEntity有RealName属性，UserDTO对应属性是Name，可以单独配置映射：

public class UserProfile : Profile
{
    public UserProfile()
    {
        CreateMap<UserEntity, UserDTO>()
            .ForMember(dest => dest.Name, opt => opt.MapFrom(src => src.RealName));
    }
}

忽略部分属性映射

如果目标类有属性不需要映射，可以使用Ignore方法：

public class UserProfile : Profile
{
    public UserProfile()
    {
        CreateMap<UserEntity, UserDTO>()
            // 忽略UserDTO的Email属性，不做映射
            .ForMember(dest => dest.Email, opt => opt.Ignore());
    }
}

构造函数映射

如果目标类只有带参数的构造函数，没有无参构造函数，需要配置构造函数映射：

public class UserDTO
{
    public UserDTO(int id, string userName)
    {
        Id = id;
        UserName = userName;
    }

    public int Id { get; }
    public string UserName { get; }
}

public class UserProfile : Profile
{
    public UserProfile()
    {
        CreateMap<UserEntity, UserDTO>()
            // 配置构造函数参数映射
            .ForCtorParam("id", opt => opt.MapFrom(src => src.Id))
            .ForCtorParam("userName", opt => opt.MapFrom(src => src.UserName));
    }
}

集合映射

AutoMapper也支持集合类型的映射，不需要额外配置，直接使用Map方法即可：

// 映射单个对象
UserDTO userDTO = _mapper.Map<UserDTO>(userEntity);
// 映射集合
List<UserDTO> userDTOList = _mapper.Map<List<UserDTO>>(userEntityList);

映射规则验证

为了确保映射配置没有问题，可以在启动时添加映射验证：

var config = new MapperConfiguration(cfg =>
{
    cfg.AddProfile<UserProfile>();
});
// 验证映射配置是否正确
config.AssertConfigurationIsValid();

如果映射配置有问题，比如目标类有属性没有被映射，会直接抛出异常，方便开发者提前发现问题。

AutoMapperCSharp对象映射属性配置修改时间：2026-06-21 21:24:31