如何在?.NET?9?中使用?Mapster?快速、高效的實現(xiàn)對象映射
更新時間：2025年10月22日 08:48:56 作者：追逐時光者
本文我們的主要內容就是講解如何在ASP.NET?Core?9.0?Web?API項目中使用Mapster快速、高效的實現(xiàn)對象映射,本文結合實例代碼給大家介紹的非常詳細,感興趣的朋友跟隨小編一起看看吧
前言
在日常開發(fā)中，我們常常需要將一個對象映射到另一個對象，比如將數據庫實體轉換為數據傳輸對象（DTO），或將請求模型映射為領域模型。這個過程通常涉及大量重復性代碼，如果每次都手動編寫，不僅嚴重影響開發(fā)效率，而且隨著項目規(guī)模不斷增長，還容易出現(xiàn)錯誤（如：屬性遺漏、手寫時寫錯或復制粘貼失誤等）。
本文我們的主要內容就是講解如何在 ASP.NET Core 9.0 Web API 項目中使用 Mapster 快速、高效的實現(xiàn)對象映射。
Mapster 介紹
Mapster 是一個開源免費（MIT license）、快速、高性能、靈活且易于使用的 .NET 對象映射庫，用于在 .NET 用程序中進行對象之間的轉換和映射操作，大幅減少手動賦值帶來的重復代碼、人為錯誤和維護成本。
安裝 Mapster 相關包
方式一、NuGet 包管理器安裝
在 NuGet 包管理器中搜索：Mapster 和 Mapster.DependencyInjection 安裝：
Mapster 核心功能包
Mapster.DependencyInjection 依賴注入集成包
方式二、.NET CLI 安裝
dotnet add package Mapster --version 7.4.0 #核心功能包 dotnet add package Mapster.DependencyInjection --version 1.0.1 #依賴注入集成包
在 Program.cs 中注冊 Mapster 服務
var builder = WebApplication.CreateBuilder(args); // 注冊 Mapster 服務 builder.Services.AddMapster(); // 注冊 Mapster 映射規(guī)則 MapsterConfig.Register();
基礎映射一行代碼搞定
接下來我們分別定義一個源對象（Student）和一個目標對象（StudentViewModel），它們的屬性名和類型完全一致。
Student（源對象）
public classStudent
{
/// <summary>
/// 學生ID [主鍵，自動遞增]
/// </summary>
[PrimaryKey, AutoIncrement]
[Display(Name = "學生ID")]
publicint StudentID { get; set; }
/// <summary>
/// 班級ID
/// </summary>
[Display(Name = "班級ID")]
publicint ClassID { get; set; }
/// <summary>
/// 學生姓名
/// </summary>
[Display(Name = "學生姓名")]
publicstring Name { get; set; }
/// <summary>
/// 學生年齡
/// </summary>
[Display(Name = "學生年齡")]
publicint Age { get; set; }
/// <summary>
/// 學生性別
/// </summary>
[Display(Name = "學生性別")]
publicstring Gender { get; set; }
}StudentViewModel（目標對象）
public classStudentViewModel
{
/// <summary>
/// 學生ID
/// </summary>
[PrimaryKey, AutoIncrement]
[Display(Name = "學生ID")]
publicint StudentID { get; set; }
/// <summary>
/// 班級ID
/// </summary>
[Display(Name = "班級ID")]
publicint ClassID { get; set; }
/// <summary>
/// 學生姓名
/// </summary>
[Display(Name = "學生姓名")]
publicstring Name { get; set; }
/// <summary>
/// 學生年齡
/// </summary>
[Display(Name = "學生年齡")]
publicint Age { get; set; }
/// <summary>
/// 學生性別
/// </summary>
[Display(Name = "學生性別")]
publicstring Gender { get; set; }
/// <summary>
/// 班級名稱
/// </summary>
[Display(Name = "班級名稱")]
publicstring ClassName { get; set; }
}Mapster 自動完成映射
只要屬性名和類型一致，Mapster 自動完成映射，無需任何配置！
private async Task<List<StudentViewModel>?> GetStudentClassInfo(List<Student> students)
{
// Mapster 映射（無需任何配置！）
var studentsListDto = students.Adapt<List<StudentViewModel>>();
if (studentsListDto?.Count > 0)
{
var classIDs = studentsListDto.Select(x => x.ClassID).Distinct().ToList();
var querySchoolClassList = await _schoolClassHelper.QueryAsync(x => classIDs.Contains(x.ClassID)).ConfigureAwait(false);
if (querySchoolClassList?.Count > 0)
{
foreach (var studentItem in studentsListDto)
{
var getClassInfo = querySchoolClassList.FirstOrDefault(x => x.ClassID == studentItem.ClassID);
if (getClassInfo != null)
{
studentItem.ClassName = getClassInfo.ClassName;
}
}
}
}
return studentsListDto;
}映射結果輸出：
自定義映射規(guī)則
當屬性名或類型不一致時，可通過配置指定映射邏輯。
UserInfo（源對象）
public classUserInfo
{
publicint Id { get; set; }
publicstring FirstName { get; set; }
publicstring LastName { get; set; }
publicstring Email { get; set; }
public DateTime CreatedAt { get; set; }
}UserInfoViewModel（目標對象）
public classUserInfoViewModel
{
publicint Id { get; set; }
/// <summary>
/// 合并 FirstName + LastName
/// </summary>
publicstring FullName { get; set; }
publicstring Email { get; set; }
/// <summary>
/// 格式化日期
/// </summary>
publicstring CreatedDate { get; set; }
}配置 Mapster 映射規(guī)則
在項目根目錄創(chuàng)建 MapsterConfig.cs：
/// <summary>
/// Mapster 全局映射配置類。
/// 用于集中注冊項目中所有自定義的對象映射規(guī)則，
/// 避免映射邏輯分散在各處，提升可維護性與可測試性。
/// </summary>
publicstaticclassMapsterConfig
{
/// <summary>
/// 注冊所有自定義的 Mapster 映射配置
/// 此方法應在應用程序啟動時（如 Program.cs）調用一次
/// </summary>
public static void Register()
{
TypeAdapterConfig<UserInfo, UserInfoViewModel>
.NewConfig()
.Map(dest => dest.FullName,
src => $"{src.FirstName} {src.LastName}".Trim())
.Map(dest => dest.CreatedDate,
src => src.CreatedAt.ToString("yyyy-MM-dd"));
}
}自定義映射規(guī)則
/// <summary>
/// 使用 Mapster 映射 UserInfo 示例
/// </summary>
[ApiController]
[Route("api/[controller]/[action]")]
publicclassUserInfoController : ControllerBase
{
privatereadonly IMapper _mapper;
/// <summary>
/// 依賴注入
/// </summary>
/// <param name="mapper">mapper</param>
public UserInfoController(IMapper mapper)
{
_mapper = mapper;
}
/// <summary>
/// GetUserInfo
/// </summary>
/// <returns></returns>
[HttpGet]
public List<UserInfoViewModel> GetUserInfos()
{
var userInfos = new List<UserInfo>
{
new UserInfo
{
Id = 999,
FirstName = "李",
LastName = "四",
Email = "lisi@qq.com",
CreatedAt = DateTime.Now.AddYears(-5)
},
new UserInfo
{
Id = 666,
FirstName = "張",
LastName = "三",
Email = "zhangsan@example.com",
CreatedAt = DateTime.UtcNow.AddDays(-10)
}
};
// 使用 Mapster 映射
var getUserInfoViewModels = _mapper.Map<List<UserInfoViewModel>>(userInfos);
return getUserInfoViewModels;
}
}映射結果輸出：
完整示例源代碼
到此這篇關于在 .NET 9 中使用 Mapster 快速、高效的實現(xiàn)對象映射的文章就介紹到這了,更多相關.net mapster 對象映射內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
這篇文章主要介紹了asp.net中Table生成Excel表格的方法,可實現(xiàn)將html的table表格生成excel的功能,需要的朋友可以參考下2015-01-01
ASP.NET?MVC5網站開發(fā)之添加、刪除、重置密碼、修改密碼、列表瀏覽管理員篇2(六)
這篇文章主要為大家詳細介紹了ASP.NET?MVC5網站開發(fā)之添加、刪除、重置密碼、修改密碼、列表瀏覽，感興趣的小伙伴們可以參考一下2016-08-08
深入理解 .NET 9 BackgroundService 生命周期與應用解析
.NET 9 為開發(fā)者提供了強大而優(yōu)雅的 BackgroundService 抽象類,用于實現(xiàn)可擴展、可管理的后臺任務,這篇文章主要介紹了深入理解 .NET 9 BackgroundService 生命周期與應用解析,需要的朋友可以參考下2026-03-03
SQL為查詢的結果加上序號(ROW_NUMBER) 合并多個查詢結果
SQL為查詢的結果加上序號(ROW_NUMBER) 合并多個查詢結果2010-03-03
ASP.NET 4中的可擴展輸出緩存(可以緩存頁面/控件等)
ASP.NET 1.0引入輸出緩存的概念，這使得開發(fā)者可以緩存頁面、控件、控制器以及HTTP響應的輸出到內存中,接下來詳細介紹，感興趣的朋友可以了解下2013-01-01
本篇文章小編為大家介紹，基于.NET程序默認啟動線程數講解。需要的朋友參考下2013-04-04
ASP.NET?Core項目中調用WebService的方法
這篇文章介紹了ASP.NET?Core項目中調用WebService的方法，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-03-03
ToString()使用方法匯總,需要的朋友可以參考下2012-10-10
遍歷repeater中的控件的幾種方式小結，需要的朋友可以參考下。2010-02-02
這篇文章介紹了ASP.NET MVC使用母版頁視圖的方法，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下2022-03-03