【C#/.NET】使用Automapper映射record類型

        當使用Automapper進行對象映射時，通常我們會使用POCO（Plain Old CLR Object）類作為源對象和目標對象。然而，自從C# 9引入了record類型，它們提供了更簡潔、不可變的對象模型。我已經將項目的所有Dto都是用record類型，但是record類型還是有些需要註意的點，本文將介紹如何使用Automapper將POCO映射成record的對象。

        首先，我們需要確保已經安裝了Automapper NuGet包。可以通過NuGet包管理器控制台或者Visual Studio的NuGet包管理器來安裝

//安裝Nuget包
Install-Package AutoMapper.Extensions.Microsoft.DependencyInjection

//服務註冊
builder.Services.AddAutoMapper(assembly);  //你的程式集

        安裝完成後，我們可以在項目中引入Automapper的命名空間，以便在代碼中使用Automapper相關的功能。

        接下來，假設我們有一個POCO類Person，具有以下屬性：

public class Person
{
    public string FirstName { get; set; }
    public string LastName { get; set; }
    public int Age { get; set; }
}

        現在，我們希望將這個POCO類映射成一個record類型的對象PersonRecord，具有相同的屬性：

public record PersonRecord(string FirstName, string LastName, int Age);

        在使用Automapper之前，我們需要進行一些配置。可以在應用程式的啟動代碼或啟動器類中進行配置。以下是一個簡單的配置示例：

 public class PersonProfile : Profile
 {
     public PersonProfile()
     {
         CreateMap<Person, PersonRecord>();
     }
 }

        在上面的代碼中，我們創建了一個PersonProfile類，並使用CreateMap方法來定義從Person到PersonRecord的映射。

        現在，我們可以使用mapper對象來執行映射操作了。只需調用mapper.Map方法並傳入源對象即可：

public class AutomapperController : ControllerBase
  {
      private readonly IMapper _mapper;

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

      [HttpGet]
      public IActionResult Get()
      {
          Person person = new()
          {
              FirstName = "John",
              LastName = "Doe",
              Age = 30
          };

          PersonRecord personRecord = _mapper.Map<PersonRecord>(person);
          return Ok(personRecord);
      }
  }

        通過上面的代碼，我們就將Person對象映射成了PersonRecord對象。personRecord對象將具有與person相同的屬性值。

        值得註意的是，由於record是不可變的，因此我們只能在創建時初始化其屬性，無法在後續代碼中修改屬性值。因此，在映射過程中，Automapper會自動為record類型的目標對象生成一個構造函數，並根據源對象的屬性值進行初始化。

        使用Automapper進行POCO到record的映射還可以處理複雜的場景，包括嵌套對象、集合類型等。只需在配置過程中定義適當的映射規則，Automapper會自動處理屬性的映射。

        我們瞭解了使用Automapper將POCO映射成record的對象的步驟。首先，我們需要安裝和配置Automapper，然後定義映射規則。最後，在需要進行映射的地方調用mapper.Map方法即可。這樣，我們可以輕鬆地將POCO對象轉換為不可變的record對象。