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

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 类集中管理映射规则,提高可维护性。

例如:

public class UserProfile : Profile{    public UserProfile()    {        CreateMap();        CreateMap()            .ForMember(dest => dest.CreatedAt, opt => opt.Ignore());    }}

CreateMap() 声明双向映射基础ForMember 可定制特定属性行为,比如忽略、条件映射、值转换同名同类型属性默认自动映射,无需额外配置

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

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

var dto = _mapper.Map(entity); —— 对象转 DTOvar entity = _mapper.Map(dto); —— DTO 转实体也可映射集合:_mapper.Map>(userList)

常见注意事项

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

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

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

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

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1442749.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月17日 19:21:15
下一篇 2025年12月15日 23:41:09

相关推荐

发表回复

登录后才能评论
关注微信