【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对象。

​