Automapper中文文档

Automapper是一个扩展库，可在.NET中简化类之间的映射。它执行对象映射的过程，不必编写重复的转换代码。本文将从多个方面对Automapper中文文档进行详细阐述。

一、基本使用方法

在开始使用Automapper之前，首先需要在NuGet中安装Automapper包。

Install-Package AutoMapper

接下来，在应用程序启动中，映射配置需要在Configure方法中完成。下面是一个简单的映射配置示例：

using AutoMapper;
public class MappingProfile : Profile
{
    public MappingProfile()
    {
        CreateMap<Source, Destination>();
    }
}

以上代码需要CreateMap方法来提供源对象和目标对象类型。例如，使用以下代码映射两个类：

var source = new Source
{
    Value = "Hello world"
};
var destination = mapper.Map<Destination>(source);

在映射配置上，Automapper自动将源类中的属性名与目标类中名称相同的属性名称进行映射。

二、自定义映射

自动映射仅适用于基本类型和属性名称匹配的对象，如果源对象和目标对象的结构不同，或者需要自定义映射规则，则需要手动进行映射。下面是一个自定义映射的示例：

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Source, Destination>()
        .ForMember(dest => dest.DestinationValue, opt => opt.MapFrom(src => src.SourceValue));
});
var mapper = new Mapper(mapperConfig);
var source = new Source
{
    SourceValue = 42
};
var destination = mapper.Map<Destination>(source);
Console.WriteLine($"DestinationValue : {destination.DestinationValue}");

在上面的示例中，CreateMap方法创建一个自定义映射的配置。它使用ForMember方法进行目标对象属性自定义映射。这个例子中，源值映射到DestinationValue属性。

三、高级映射

Automapper提供了许多高级映射选项。例如，在映射集合和值类型的时候，很可能需要额外的配置。下面是一个集合映射的示例：

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Source, Destination>()
        .ForMember(dest => dest.Values, opt => opt.MapFrom(src => src.ListOfValues));
});
var mapper = new Mapper(mapperConfig);
var source = new Source
{
    ListOfValues = new List<int> { 1, 2, 3, 4, 5 }
};
var destination = mapper.Map<Destination>(source);
foreach (var value in destination.Values)
{
    Console.Write($"{value} ");
}

在上面的代码中，使用ForMember方法来定义Values属性如何映射到ListOfValues集合中的值。另一个更高级的映射示例是使用AfterMap选项。例如，应用程序需要转换一个枚举类型的属性并将其转换为一个字符串。可以使用以下代码：

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Source, Destination>()
        .ForMember(dest => dest.EnumPropertyAsString, opt => opt.Ignore())
        .AfterMap((src, dest) =>
        {
            dest.EnumPropertyAsString = src.EnumProperty.ToString();
        });
});
var mapper = new Mapper(mapperConfig);
var source = new Source
{
    EnumProperty = ExampleEnum.ValueOne
};
var destination = mapper.Map<Destination>(source);
Console.WriteLine($"EnumPropertyAsString : {destination.EnumPropertyAsString}");

AfterMap提供了一个委托，当映射完成后，调用该委托。在上面的示例中，使用Ignore隐藏了EnumPropertyAsString属性，由AfterMap方法填充。

四、借助DI容器使用Automapper

在应用程序中，通常使用依赖注入（DI）容器来管理类的生命周期。示例代码如下所示：

public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSingleton(new MapperConfiguration(cfg =>
        {
            cfg.AddProfile<MappingProfile>();
        }).CreateMapper());
    }
}
public class SomeService
{
    private readonly IMapper _mapper;
    public SomeService(IMapper mapper)
    {
        _mapper = mapper;
    }
}

在上面的代码中，ConfigureServices方法中的AddSingleton方法添加了一个单例DI服务。它使用CreateMapper方法创建一个新的Mapper实例。然后在SomeService类中使用该Mapper实例进行映射。

五、使用匿名类型进行映射

假设您现在需要一个匿名类型作为映射结果。在这种情况下，可以使用映射后的结果创建新的匿名类型。

var mapperConfig = new MapperConfiguration(cfg =>
{
    cfg.CreateMap<Source, object>()
        .ForMember("Total", opt => opt.MapFrom(src => src.Values.Sum()));
});
var mapper = new Mapper(mapperConfig);
var source = new Source
{
    Values = new int[] { 1, 2, 3 }
};
var destination = mapper.Map<object>(source, opts =>
{
    opts.AfterMap((src, dest) =>
    {
        dest = new { Total = (int)dest.GetType().GetProperty("Total").GetValue(dest) };
    });
});
Console.WriteLine($"Total : {destination.GetType().GetProperty("Total").GetValue(destination)}");

在上面的代码中，使用Map方法创建一个新的匿名对象。然后，使用AfterMap对该对象进行修正。必须在AfterMap中对Total属性进行强制转换，然后将值放入新的匿名对象中。

结论

在本文中，我们学习如何使用Automapper库来简化类之间的映射。我们介绍了基本的使用方法，自定义映射，高级映射选项，使用DI容器和匿名类型的映射。希望本文对你有所帮助。

详解Automapper中文文档