AutoMapper 是 .NET 中常用的对象映射工具，用于简化实体与 DTO 之间的转换。通过安装 AutoMapper.Extensions.Microsoft.DependencyInjection 包并注册服务，可在 .NET 项目中快速集成。创建 Profile 类定义映射规则，如 CreateMap，并在 Program.cs 中调用 AddAutoMapper。在控制器中注入 IMapper 实例，使用 Map 方法完成对象转换。支持自定义配置，如字段重命名、值转换（MapFrom）、忽略字段（Ignore），以及处理空值（NullSubstitute）和条件映射（Condition）。集合映射自动生效，只要单个类型已配置。合理使用 AutoMapper 可显著提升开发效率与代码可维护性。
在 .NET 开发中，对象之间的映射是常见需求，尤其是在分层架构中（如从实体模型转换为 DTO）。手动赋值不仅繁琐还容易出错，AutoMapper 是一个流行的对象映射库，能够自动将一个对象的属性映射到另一个对象，极大提升开发效率。本文介绍如何在 .NET 项目中使用 AutoMapper 进行对象映射，并完成基本与高级配置。
安装 AutoMapper
在开始前，需通过 NuGet 安装 AutoMapper 包。在 .NET 6+ 或 ASP.NET Core 项目中，推荐使用以下命令：
dotnet add package AutoMapper.Extensions.Microsoft.DependencyInjection
该包整合了依赖注入支持，便于在 ASP.NET Core 中注册服务。
基本对象映射配置
假设我们有两个类：数据库实体 User 和用于返回前端的 DTO UserDto：
public class User
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
public DateTime CreatedAt { get; set; }
}
public class UserDto
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}
创建一个 Profile 类来定义映射规则：
using AutoMapper;
public class UserProfile : Profile
{
public UserProfile()
{
CreateMap();
}
}
在 Program.cs（.NET 6 及以上）中注册 AutoMapper：
var builder = WebApplication.CreateBuilder(args);
// 添加 AutoMapper 服务
builder.Services.AddAutoMapper(typeof(UserProfile));
var app = builder.Build();
在控制器中使用 IMapper
在 Controller 或 Service 中注入 IMapper 实例进行映射：
[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
private readonly IMapper _mapper;
public UsersController(IMapper mapper)
{
_mapper = mapper;
}
[HttpGet("{id}")]
public IActionResult Get(int id)
{
var user = new User
{
Id = id,
Name = "张三",
Email = "zhangsan@example.com",
CreatedAt = DateTime.Now
};
var dto = _mapper.MapzuojiankuohaophpcnUserDtoyoujiankuohaophpcn(user);
return Ok(dto);
}}
此时，AutoMapper 会自动将同名属性进行映射。
自定义映射规则
当源和目标对象字段不一致时，可自定义映射方式：
- 字段重命名：使用 ForMember
- 值转换：使用 MapFrom
- 忽略某些字段：使用 Ignore
示例：将 CreatedAt 转为字符串格式：
CreateMap()
.ForMember(dest => dest.Email, opt => opt.MapFrom(src => src.Email.ToLower()))
.ForMember(dest => dest.Name, opt => opt.MapFrom(src => "用户：" + src.Name))
.ForMember(dest => dest.Id, opt => opt.Ignore());
条件映射与空值处理
可设置条件映射，仅当满足条件时才映射：
CreateMap()
.ForMember(dest => dest.Name, opt => opt
.NullSubstitute("未知用户"))
.ForMember(dest => dest.Email, opt => opt
.Condition(src => !string.IsNullOrEmpty(src.Email)));
NullSubstitute 表示源为 null 时使用默认值；Condition 用于判断是否执行映射。
集合映射
AutoMapper 支持集合自动映射：
var users = new List{ /* ... */ };
var dtos = _mapper.Map>(users);
无需额外配置，只要单个对象映射已定义，集合会自动逐项映射。
基本上就这些。AutoMapper 简化了对象转换流程，配合 Profile 分类管理映射关系，代码更清晰、可维护性更强。合理使用自定义规则，能应对大多数业务场景。
# 前端
# app
# 工具
# ai
# microsoft
# .net
# 架构
# NULL
# 字符串
# map
# 对象
# 数据库
# 自定义
# 重命名
# 是一个
# 器中
# 是在
# 推荐使用
# 并在
# 可在
# 更强
# 转换为
相关文章：
北京网页设计制作网站有哪些,继续教育自动播放怎么设置？
天津个人网站制作公司,天津网约车驾驶员从业资格证官网？
建站主机服务器选型指南与性能优化方案解析
南京网站制作费用,南京远驱官方网站？
活动邀请函制作网站有哪些,活动邀请函文案？
网站视频怎么制作,哪个网站可以免费收看好莱坞经典大片？
制作无缝贴图网站有哪些,3dmax无缝贴图怎么调？
如何用虚拟主机快速搭建网站？详细步骤解析
外贸公司网站制作,外贸网站建设一般有哪些步骤？
如何制作一个表白网站视频,关于勇敢表白的小标题？
小米网站链接制作教程,请问miui新增网页链接调用服务有什么用啊？
如何在服务器上配置二级域名建站？
C#如何使用XPathNavigator高效查询XML
小程序网站制作需要准备什么资料,如何制作小程序？
购物网站制作费用多少,开办网上购物网站，需要办理哪些手续？
小捣蛋自助建站系统：数据分析与安全设置双核驱动网站优化
css网站制作参考文献有哪些,易聊怎么注册？
详解jQuery停止动画——stop()方法的使用
如何选择网络建站服务器？高效建站必看指南
如何快速查询网址的建站时间与历史轨迹？
公司网站制作价格怎么算,公司办个官网需要多少钱？
网站制作外包价格怎么算,招聘网站上写的“外包”是什么意思？
太平洋网站制作公司,网络用语太平洋是什么意思？
如何访问已购建站主机并解决登录问题？
在线ppt制作网站有哪些软件,如何把网页的内容做成ppt？
长春网站建设制作公司,长春的网络公司怎么样主要是能做网站的？
图片制作网站免费软件,有没有免费的网站或软件可以将图片批量转为A4大小的pdf？
C++中的Pimpl idiom是什么，有什么好处？（隐藏实现）
网站制作网站,深圳做网站哪家比较好？
广东专业制作网站有哪些,广东省能源集团有限公司官网？
香港代理服务器配置指南：高匿IP选择、跨境加速与SEO优化技巧
黑客入侵网站服务器的常见手法有哪些？
宝华建站服务条款解析：五站合一功能与SEO优化设置指南
制作网页的网站有哪些,电脑上怎么做网页？
如何快速查询域名建站关键信息？
jQuery 常见小例汇总
网站设计制作书签怎么做,怎样将网页添加到书签/主页书签/桌面？
如何制作公司的网站链接,公司想做一个网站，一般需要花多少钱？
如何快速建站并高效导出源代码？
盘锦网站制作公司,盘锦大洼有多少5G网站？
专业网站建设制作报价,网页设计制作要考什么证？
无锡营销型网站制作公司,无锡网选车牌流程？
,怎么用自己头像做动态表情包？
建站之星安装需要哪些步骤及注意事项？
潍坊网站制作公司有哪些,潍坊哪家招聘网站好？
如何选择最佳自助建站系统？快速指南解析优劣
西安专业网站制作公司有哪些,陕西省建行官方网站？
如何通过虚拟机搭建网站？详细步骤解析
电商平台网站制作流程,电商网站如何制作？
武汉外贸网站制作公司,现在武汉外贸前景怎么样啊？
public DateTime CreatedAt { get; set; }
}
