AutoMapper是一个.NET的对象映射工具。

项目地址：​​https://github.com/AutoMapper/AutoMapper​​。

帮助文档：​​https://github.com/AutoMapper/AutoMapper/wiki​​

主要用途

领域对象与DTO之间的转换、数据库查询结果映射至实体对象。

使用笔记

场景1：源类型BlogEntry，目标类型BlogPostDto，指定属性进行映射（BlogEntry.ID对应于BlogPostDto.PostId）。

代码：



AutoMapper.Mapper.CreateMap<BlogEntry, BlogPostDto>()
                .ForMember(dto => dto.PostId, opt => opt.MapFrom(entity => entity.ID));


场景2：IDataReader映射至实体类

代码：



AutoMapper使用笔记_映射关系

using (IDataReader reader = _db.ExecuteReader(command))
{
    if (reader.Read())
    {
        return AutoMapper.Mapper.DynamicMap<BlogConfig>(reader);
    }
}


AutoMapper使用笔记_映射关系


 

场景3：列表类型之间的映射，比如：源类型List<BlogSite>，目标类型List<BlogSiteDto>

代码如下：



AutoMapper.Mapper.CreateMap<BlogSite, BlogSiteDto>();
var blogSiteDto = AutoMapper.Mapper.Map<List<BlogSite>, List<BlogSiteDto>>(blogSite);


注：必须要先通过CreateMap建立BlogSite与BlogSiteDto的映射关系。

 

场景4：在映射时为目标实例的属性指定值

代码如下：



var blogSiteDto = new BlogSiteDto();
AutoMapper.Mapper.CreateMap<BlogEntry, BlogPostDto>()
                .ForMember(dto => dto.BlogSiteDto, opt => opt.UseValue(blogSiteDto));


注：BlogSiteDto是BlogPostDto的一个属性。

 

补充：

AutoMapper的配置（比如AutoMapper.Mapper.CreateMap<BlogSite, BlogSiteDto>();）建议放在程序启动时，比如Global.asax的Application_Start, BootStrapper。