0

0

.NET如何使用AutoMapper进行对象映射

幻夢星雲

幻夢星雲

发布时间:2025-11-04 20:31:34

|

722人浏览过

|

来源于php中文网

原创

答案:AutoMapper用于.NET中对象映射,通过安装NuGet包、创建Profile配置映射规则,并在ASP.NET Core中注册服务,实现DTO与实体间自动转换,支持属性重命名、忽略、条件映射等高级功能,提升开发效率。

.net如何使用automapper进行对象映射

在 .NET 项目中,AutoMapper 是一个广泛使用的对象映射库,它能自动将一个对象的属性映射到另一个对象,特别适用于 DTO(数据传输对象)与实体模型之间的转换。使用 AutoMapper 可以大幅减少手动赋值代码,提高开发效率。

安装 AutoMapper

在项目中使用 AutoMapper 前,需要通过 NuGet 安装相关包:

  • Microsoft.EntityFrameworkCore(如果使用 EF Core)
  • AutoMapper
  • AutoMapper.Extensions.Microsoft.DependencyInjection(用于集成 ASP.NET Core 依赖注入)

通过 NuGet 包管理器或命令行安装:

dotnet add package AutoMapper.Extensions.Microsoft.DependencyInjection

配置映射关系

创建一个 Profile 类来定义映射规则。Profile 会自动收集映射配置。

public class MappingProfile : Profile
{
    public MappingProfile()
    {
        CreateMap();
        CreateMap(); // 双向映射可选
    }
}

假设你有以下两个类:

public class User
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string Email { get; set; }
}

public class UserDto
{
    public int Id { get; set; }
    public string Name { get; set; }
    public string EmailAddress { get; set; } // 属性名不同
}

若属性名不一致,可使用 ForMember 显式指定映射:

文心快码
文心快码

文心快码(Comate)是百度推出的一款AI辅助编程工具

下载
CreateMap()
    .ForMember(dest => dest.EmailAddress, opt => opt.MapFrom(src => src.Email));

在 ASP.NET Core 中注册服务

Program.csStartup.cs 中注册 AutoMapper:

var builder = WebApplication.CreateBuilder(args);

// 添加 AutoMapper 服务
builder.Services.AddAutoMapper(typeof(MappingProfile)); // 指定包含 Profile 的类型

这样 AutoMapper 会自动扫描并加载所有继承自 Profile 的类。

在控制器或服务中使用 IMapper

通过依赖注入获取 IMapper 实例进行映射:

[ApiController]
[Route("[controller]")]
public class UsersController : ControllerBase
{
    private readonly IMapper _mapper;

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

    [HttpGet("{id}")]
    public ActionResult Get(int id)
    {
        var user = new User { Id = id, Name = "张三", Email = "zhangsan@example.com" };
        var dto = _mapper.Map(user);
        return Ok(dto);
    }
}

高级用法示例

AutoMapper 支持多种映射场景:

  • 忽略某些属性: .ForMember(dest => dest.SomeProp, opt => opt.Ignore())
  • 条件映射: .ForMember(dest => dest.Status, opt => opt.Condition(src => !string.IsNullOrEmpty(src.Status)))
  • 扁平化映射: 自动将嵌套对象展开(如 Address.City → AddressCity)
  • 集合映射: _mapper.Map>(users) 直接映射集合

基本上就这些。只要定义好 Profile 并正确注入,AutoMapper 能处理大多数常见映射需求,让代码更简洁清晰。

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

318

2023.08.02

golang map内存释放
golang map内存释放

本专题整合了golang map内存相关教程,阅读专题下面的文章了解更多相关内容。

75

2025.09.05

golang map相关教程
golang map相关教程

本专题整合了golang map相关教程,阅读专题下面的文章了解更多详细内容。

36

2025.11.16

golang map原理
golang map原理

本专题整合了golang map相关内容,阅读专题下面的文章了解更多详细内容。

59

2025.11.17

java判断map相关教程
java判断map相关教程

本专题整合了java判断map相关教程,阅读专题下面的文章了解更多详细内容。

38

2025.11.27

vsd文件打开方法
vsd文件打开方法

vsd文件打开方法有使用Microsoft Visio软件、使用Microsoft Visio查看器、转换为其他格式等。想了解更多vsd文件相关内容,可以阅读本专题下面的文章。

480

2023.10.30

xml格式相关教程
xml格式相关教程

本专题整合了xml格式相关教程汇总,阅读专题下面的文章了解更多详细内容。

0

2026.01.19

PHP WebSocket 实时通信开发
PHP WebSocket 实时通信开发

本专题系统讲解 PHP 在实时通信与长连接场景中的应用实践,涵盖 WebSocket 协议原理、服务端连接管理、消息推送机制、心跳检测、断线重连以及与前端的实时交互实现。通过聊天系统、实时通知等案例,帮助开发者掌握 使用 PHP 构建实时通信与推送服务的完整开发流程,适用于即时消息与高互动性应用场景。

11

2026.01.19

微信聊天记录删除恢复导出教程汇总
微信聊天记录删除恢复导出教程汇总

本专题整合了微信聊天记录相关教程大全,阅读专题下面的文章了解更多详细内容。

85

2026.01.18

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Java 教程
Java 教程

共578课时 | 47.9万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号