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
# 对象
# 数据库
# 自定义
# 重命名
# 是一个
# 器中
# 是在
# 推荐使用
# 并在
# 可在
# 更强
# 转换为
相关文章：
在线制作视频的网站有哪些,电脑如何制作视频短片？
电影网站制作价格表,那些提供免费电影的网站，他们是怎么盈利的？
道歉网站制作流程,世纪佳缘致歉小吴事件，相亲网站身份信息伪造该如何稽查？
制作网站的网址是什么,请问后缀为.com和.com.cn还有.cn的这三种网站是分别是什么类型的网站？
网站制作与设计教程,如何制作一个企业网站，建设网站的基本步骤有哪些？
C#如何使用XPathNavigator高效查询XML
如何选择高效便捷的WAP商城建站系统？
Swift中swift中的switch 语句
广州营销型建站服务商推荐：技术优势与SEO优化解析
网站视频制作书签怎么做,ie浏览器怎么将网站固定在书签工具栏？
如何批量查询域名的建站时间记录？
建站主机选虚拟主机还是云服务器更好？
山东云建站价格为何差异显著？
建站主机服务器选型指南与性能优化方案解析
上海网站制作开发公司,上海买房比较好的网站有哪些？
如何用花生壳三步快速搭建专属网站？
高端建站如何打造兼具美学与转化的品牌官网？
网站制作培训多少钱一个月,网站优化seo培训课程有哪些？
建站之星五站合一营销型网站搭建攻略，流量入口全覆盖优化指南
如何用IIS7快速搭建并优化网站站点？
如何选择靠谱的建站公司加盟品牌？
制作网站建设的公司有哪些,网站建设比较好的公司都有哪些？
网站制作大概要多少钱一个,做一个平台网站大概多少钱？
,网站推广常用方法？
如何快速生成ASP一键建站模板并优化安全性？
如何通过VPS建站实现广告与增值服务盈利？
如何选择高效响应式自助建站源码系统？
如何用美橙互联一键搭建多站合一网站？
相亲简历制作网站推荐大全,新相亲大会主持人小萍萍资料？
企业宣传片制作网站有哪些,传媒公司怎么找企业宣传片项目？
南京网站制作费用,南京远驱官方网站？
建站之星安装提示数据库无法连接如何解决？
如何通过虚拟主机快速搭建个人网站？
如何在阿里云服务器自主搭建网站？
已有域名能否直接搭建网站？
建站之星体验版：智能建站系统+响应式设计，多端适配快速建站
建站之星云端配置指南：模板选择与SEO优化一键生成
广州顶尖建站服务：企业官网建设与SEO优化一体化方案
网页设计网站制作软件,microsoft office哪个可以创建网页？
香港服务器建站指南：外贸独立站搭建与跨境电商配置流程
如何基于PHP生成高效IDC网络公司建站源码？
韩国服务器如何优化跨境访问实现高效连接？
设计网站制作公司有哪些,制作网页教程？
专业公司网站制作公司,用什么语言做企业网站比较好？
官网网站制作腾讯审核要多久,联想路由器newifi官网
如何通过虚拟主机快速完成网站搭建？
如何注册花生壳免费域名并搭建个人网站？
网站app免费制作软件,能免费看各大网站视频的手机app？
模具网站制作流程,如何找模具客户？
天河区网站制作公司,广州天河区如何办理身份证？需要什么资料有预约的网站吗？
public DateTime CreatedAt { get; set; }
}
