C# 如何使用AutoMapper - 简化对象之间的映射

php中文网
发布: 2025-12-06 12:23:02
原创
202人浏览过
AutoMapper 是 C# 中简化对象映射的常用库,通过配置 Profile 类定义 CreateMap 规则并注入 IMapper 接口,即可用一行代码完成实体与 DTO 的双向转换,支持忽略、条件映射和集合映射,需注意属性匹配、嵌套映射及空值处理。

c# 如何使用automapper - 简化对象之间的映射

AutoMapper 是 C# 中简化对象映射的常用库,它能自动将一个对象的属性值复制到另一个结构相似的对象中,避免手写大量赋值代码。核心在于配置映射规则,之后只需一行代码完成转换。

安装与基础配置

通过 NuGet 安装 AutoMapper 包(如 AutoMapperAutoMapper.Extensions.Microsoft.DependencyInjection,后者用于 ASP.NET Core 依赖注入)。

在启动时注册服务(以 .NET 6+ 为例):

  • Program.cs 中调用 builder.Services.AddAutoMapper(typeof(YourProfileClass))
  • 或使用程序集扫描:AddAutoMapper(Assembly.GetExecutingAssembly())

定义映射关系:使用 Profile 类

推荐用自定义 Profile 类集中管理映射规则,提高可维护性。

例如:

LongShot
LongShot

LongShot 是一款 AI 写作助手,可帮助您生成针对搜索引擎优化的内容博客。

LongShot 77
查看详情 LongShot
public class UserProfile : Profile
{
    public UserProfile()
    {
        CreateMap<UserEntity, UserDto>();
        CreateMap<UserDto, UserEntity>()
            .ForMember(dest => dest.CreatedAt, opt => opt.Ignore());
    }
}
登录后复制
  • CreateMap<tsource tdestination>()</tsource> 声明双向映射基础
  • ForMember 可定制特定属性行为,比如忽略、条件映射、值转换
  • 同名同类型属性默认自动映射,无需额外配置

执行映射:注入 IMapper 并调用 Map

在需要转换的地方注入 IMapper 接口(如 Controller 或 Service 中):

  • var dto = _mapper.Map<userdto>(entity);</userdto> —— 对象转 DTO
  • var entity = _mapper.Map<userentity>(dto);</userentity> —— DTO 转实体
  • 也可映射集合:_mapper.Map<list>>(userList)</list>

常见注意事项

映射不是万能的,需留意以下细节:

  • 属性名必须匹配(默认忽略大小写),或用 ForMember 显式指定源字段
  • 嵌套对象会自动递归映射,前提是已为嵌套类型配置了对应规则
  • 值类型不为 null 时注意目标类型是否可空,必要时用 ConvertUsing 处理
  • 调试映射问题可用 AssertConfigurationIsValid() 验证配置合法性

基本上就这些。合理配置 Profile + 注入 IMapper,就能让对象转换变得干净又可靠。

以上就是C# 如何使用AutoMapper - 简化对象之间的映射的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

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