新闻中心

.NET如何使用AutoMapper进行对象映射_AutoMapper对象映射配置指南

2025-11-25
浏览次数：次
返回列表
AutoMapper 是 .NET 中常用的对象映射工具，用于简化实体与 DTO 之间的转换。通过安装 AutoMapper.Extensions.Microsoft.DependencyInjection 包并注册服务，可在 .NET 项目中快速集成。创建 Profile 类定义映射规则，如 CreateMap，并在 Program.cs 中调用 AddAutoMapper。在控制器中注入 IMapper 实例，使用 Map 方法完成对象转换。支持自定义配置，如字段重命名、值转换（MapFrom）、忽略字段（Ignore），以及处理空值（NullSubstitute）和条件映射（Condition）。集合映射自动生效，只要单个类型已配置。合理使用 AutoMapper 可显著提升开发效率与代码可维护性。

.net如何使用automapper进行对象映射_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; }
}
<p>public class UserDto
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
}</p>

创建一个 Profile 类来定义映射规则：

using AutoMapper;
<p>public class UserProfile : Profile
{
public UserProfile()
{
CreateMap<User, UserDto>();
}
}</p>

在 Program.cs（.NET 6 及以上）中注册 AutoMapper：

var builder = WebApplication.CreateBuilder(args);
<p>// 添加 AutoMapper 服务
builder.Services.AddAutoMapper(typeof(UserProfile));</p><p>var app = builder.Build();</p>

在控制器中使用 IMapper

在 Controller 或 Service 中注入 IMapper 实例进行映射：

[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
    private readonly IMapper _mapper;
<pre class='brush:php;toolbar:false;'>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.Map<UserDto>(user);
    return Ok(dto);
}

}

美图云修 美图云修

商业级AI影像处理工具

美图云修 50 查看详情 美图云修

此时，AutoMapper 会自动将同名属性进行映射。

自定义映射规则

当源和目标对象字段不一致时，可自定义映射方式：

  • 字段重命名：使用 ForMember
  • 值转换：使用 MapFrom
  • 忽略某些字段：使用 Ignore

示例：将 CreatedAt 转为字符串格式：

CreateMap<User, UserDto>()
    .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<User, UserDto>()
    .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<User>{ /* ... */ };
var dtos = _mapper.Map<List<UserDto>>(users);

无需额外配置，只要单个对象映射已定义，集合会自动逐项映射。

基本上就这些。AutoMapper 简化了对象转换流程，配合 Profile 分类管理映射关系，代码更清晰、可维护性更强。合理使用自定义规则，能应对大多数业务场景。

以上就是.NET如何使用AutoMapper进行对象映射_AutoMapper对象映射配置指南的详细内容，更多请关注其它相关文章！


# 是在  # 科技关键词优化排名宣传  # 房山区环保网络营销推广  # 怎么做个人艺术网站推广  # 南昌seo优化高手  # 云通seo  # 河南seo网络推广工具  # 网页设计汽车网站建设  # 贺州网站推广的优势  # 明星个人网站建设方案  # SEO北京环球港  # 并在  # 推荐使用  # 前端  # 器中  # 是一个  # 重命名  # 表单  # 如何使用  # 美图  # 自定义  # .net  # microsoft  # ai  # 工具  # app 


相关栏目： 【 科技资讯46185 】 【 网络学院92790 】


相关推荐： qq游戏免费畅玩入口_qq游戏电脑版快速启动  照顾宝贝2小游戏免费秒玩入口  LocoySpider如何部署到云服务器_LocoySpider云部署的远程配置  Golang如何通过reflect操作map_Golang reflect map操作与遍历技巧  J*aScript对象创建方式_J*aScript设计模式应用  Angular响应式表单：实现提交后表单及按钮的禁用与只读化  Spring Boot嵌入式服务器与J*a EE：功能支持深度解析  Win10如何恢复误删的快捷方式_Win10重建常用软件快捷方式  C++如何连接MySQL数据库_C++使用Connector/C++操作MySQL数据库教程  神经网络二分类模型训练异常：高损失与完美验证准确率的排查与修正  MAC如何安全彻底地删除文件_MAC使用终端命令确保文件无法被恢复  windows10怎么查看硬盘序列号_windows10硬盘id查询命令  自定义Bag-of-Words实现：处理带负号的词汇权重  妖精动漫免费平台 妖精动漫官网资源观看网址  谷歌邮箱注册显示错误Gmail服务器异常与延迟处理  晋江读书网页版在线登录 晋江读书电脑版官网  Tailwind CSS line-clamp 布局问题解析与修复指南  React/Next.js中实现列表项的动态选择与移动  电脑IP地址怎么查 查看本机IP地址的几种方法  TypeScript/J*aScript：高效查找数组中首个唯一ID对象  怎么在mac上运行html代码_mac运行html代码方法【指南】  AO3同人作品网入口 AO3搜索引擎官网永久地址  b站怎么取消点赞_b站点赞取消操作方法  c++如何使用TBB库进行任务并行_c++ Intel线程构建模块  b站赚钱渠道_b站收益来源  千牛数据看板网页版_千牛数据看板网页版访问方法  葱吃多了会怎样 葱吃多了会伤胃吗  Odoo 16：在表单视图中基于当前记录动态修改Tree视图属性  Composer的 "check-platform-reqs" 命令有什么用_在部署前检查生产环境是否满足Composer依赖需求  解决移动端滚动问题的overflow属性应用指南  动漫共和国防屏蔽稳定域名-动漫共和国官方正版直达通道  百度网盘网页版入口 百度网盘网页版官方登录网址  内存疯狂猛猛涨价：主板销量直接腰斩！  响应式容器内容自动缩放与宽高比维持教程  Django模型中自动计算可用余额的实现方法  Lar*el表单中优雅地处理“返回”按钮以规避验证：最佳实践指南  在哪找SublimeJ远程工具_SFTP插件配置教程  QQ邮箱正确登录入口_QQ邮箱官方网站使用地址  c++项目目录结构应该如何组织_c++工程化项目结构规范  J*a递归快速排序中静态变量导致数据累积问题的解决方案  Mac怎么查看崩溃日志_Mac控制台错误报告分析  AO3最新镜像入口 Archive of Our Own官方平台访问  Golang如何使用const iota_Go iota常量计数器讲解  Python中高效访问嵌套字典与列表中的键值对  反效果？《战地6》免费试玩开启后玩家数不升反降  网站内容防复制粘贴的实现策略与局限性  双系统安装时，如何设置默认启动系统？ msconfig命令了解一下！  Windows7怎么硬盘安装 Windows7提取ISO镜像到非系统盘并运行setup.exe实现硬盘直装【教程】  C++如何实现线程池_C++11手动实现一个简单的固定大小线程池  解决 Vaadin 8 中大文件音频播放与定位时出现的 IOException 

上一篇：C++多态的实现原理详解_C++虚函数表vptr与vtable的剖析
下一篇：C++如何实现回调函数_C++函数指针与std::function的使用

搜索