C#怎么使用AutoMapper C#对象属性映射配置方法_网络技术

C#怎么使用AutoMapper C#对象属性映射配置方法

发布时间 - 2025-12-27 00:00:00 点击率：次

AutoMapper是C#中用于DTO与实体间对象映射的主流库，需先定义Profile配置规则，再通过依赖注入获取IMapper执行Map操作；推荐在.NET 6+中用AddAutoMapper注册，配合AssertConfigurationIsValid验证配置。

AutoMapper 是 C# 中最常用的对象映射库，用于简化不同类（尤其是 DTO 与实体）之间的属性赋值。核心思路是：先定义映射规则，再用 IMapper 实例执行映射。配置方式主要有两种——静态初始化（旧版兼容）和依赖注入方式（推荐，.NET Core / .NET 5+ 标准做法）。

使用依赖注入注册 AutoMapper（推荐）

在 Program.cs（.NET 6+）或 Startup.cs 中配置：

安装 NuGet 包：AutoMapper 和 AutoMapper.Extensions.Microsoft.DependencyInjection
调用 AddAutoMapper() 自动扫描含 Profile 的程序集，或显式指定 Profile 类型

示例（.NET 6+ Program.cs）：

builder.Services.AddAutoMapper(typeof(UserProfile)); // 扫描 UserProfile 类所在程序集

定义映射配置 Profile 类

继承 Profile，在构造函数中用 CreateMap() 声明规则：

支持链式配置：如 .ForMember() 自定义字段映射、.Ignore() 忽略属性、.MapFrom() 指定源表达式
支持条件映射：.Condition() 或 .PreCondition()
支持扁平化映射（如 User.Address.Street → UserDto.Street），默认开启；也可禁用或手动配置

示例 Profile：

public class UserProfile : Profile
{
  public UserProfile()
  {
    CreateMap()
      .ForMember(dest => dest.FullName, opt => opt.MapFrom(src => src.FirstName + " " + src.LastName))
      .ForMember(dest => dest.Age, opt => opt.MapFrom(src => DateTime.Now.Year - src.BirthDate.Year))
      .ForMember(dest => dest.Email, opt => opt.Ignore());
  }
}

在服务中注入并使用 IMapper

Controller 或 Service 构造函数中注入 IMapper，调用 Map(source) 或 Map(source, destination)：

Map(user)：创建新对象并映射（最常用）
Map(user, userDto)：将源数据填充到已有目标实例（适合编辑场景）
支持集合映射：Map>(users) 或 users.ProjectTo(mapper.ConfigurationProvider)（配合 EF 查询时延迟映射，避免全量加载）

Controller 示例：

private readonly IMapper _mapper;
public UsersController(IMapper mapper) => _mapper = mapper;

public IActionResult Get(int id)
{
  var user = _context.Users.Find(id);
  var dto = _mapper.Map(user); // 自动按 Profile 规则转换
  return Ok(dto);
}

常见注意事项和技巧

避免踩坑，提升可维护性：

映射前务必调用 AssertConfigurationIsValid()（开发环境）验证配置是否合法，比如类型不匹配、未映射的非空属性等
不要在 Profile 中写业务逻辑，保持纯配置；复杂转换可封装为自定义 ValueResolver 或 IValueConverter
若 DTO 和实体命名一致、类型兼容，AutoMapper 默认自动映射（约定优于配置），无需显式声明
对于只读属性（如 get-only auto-property），需启用 AllowNullCollections = true 或配置 ForCtorParam 支持构造函数注入

基本上就这些。配置清晰、按需定制、结合 DI 使用，AutoMapper 就能既安全又高效地帮你处理对象转换。

# app # ai # microsoft # 开发环境 # c# # .net # 封装 # 构造函数 # auto # int # 继承 # class # public # private # Property # var # map # 对象 # typeof # 自定义 # 链式 # 最常用 # 尤其是 # 就能 # 已有 # 帮你 # 也可 # 再用 # 有两种

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：Wasm 玩出花？在浏览器中运行虚拟机！

下一篇：Angular.JS中的this指向详解

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：Wasm 玩出花？在浏览器中运行虚拟机！

下一篇：Angular.JS中的this指向详解