可查询扩展(Queryable Extensions)

当在像NHibernate或者Entity Framework之类的ORM框架中使用AutoMapper的标准方法Mapper.Map 时，您可能会注意到，当AutoMapper尝试将结果映射到目标类型时，ORM将查询图形中所有对象的所有字段。

如果你的ORM表达式是IQueryable的，你可以使用AutoMapper的QueryableExtensions帮助方法去解决这个痛点。

以Entity Framework为例，比如说你有一个实体OrderLine，它的成员Item与另外一个实体有关联。如果你想用Item的Name属性将它映射到OrderLneDTO，标准的Mapper.Map调用将导致实体框架查询整个OrderLine和Item表。

使用QueryableExtensions帮助方法代替。

相关实体：

public class OrderLine
{
  public int Id { get; set; }
  public int OrderId { get; set; }
  public Item Item { get; set; }
  public decimal Quantity { get; set; }
}

public class Item
{
  public int Id { get; set; }
  public string Name { get; set; }
}

相关DTO

public class OrderLineDTO
{
  public int Id { get; set; }
  public int OrderId { get; set; }
  public string Item { get; set; }
  public decimal Quantity { get; set; }
}

你可以像这样使用Queryable Extensions：

Mapper.Initialize(cfg =>
    cfg.CreateMap<OrderLine, OrderLineDTO>()
    .ForMember(dto => dto.Item, conf => conf.MapFrom(ol => ol.Item.Name)));

public List<OrderLineDTO> GetLinesForOrder(int orderId)
{
  using (var context = new orderEntities())
  {
    return context.OrderLines.Where(ol => ol.OrderId == orderId)
             .ProjectTo<OrderLineDTO>().ToList();
  }
}

.ProjectTo <OrderLineDTO>（）将告诉AutoMapper的映射引擎向IQueryable发出一个select子句，该子句将通知实体框架它只需要查询Item表的Name列，就像用Select子句手动将IQueryable投影到OrderLineDTO一样。

请注意，要使此功能起作用，必须在Mapping中显式处理所有类型转换。举个例子，你不能通过重写Item 类的ToString()方法来告诉实体框架只查询Name 列，并且必须明确处理数据类型转换，例如“Double”转“Decimal”。

防止延迟加载/SELECT N+1 问题

因为AutoMapper构建的LINQ投影通过查询提供器直接转换为SQL查询，映射发生在SQL/ADO.NET级别，并没有涉及到你的实体。所以所有数据都被加载到你的DTO中。

嵌套集合使用Select 映射子级DTO：

from i in db.Instructors
orderby i.LastName
select new InstructorIndexData.InstructorModel
{
    ID = i.ID,
    FirstMidName = i.FirstMidName,
    LastName = i.LastName,
    HireDate = i.HireDate,
    OfficeAssignmentLocation = i.OfficeAssignment.Location,
    Courses = i.Courses.Select(c => new InstructorIndexData.InstructorCourseModel
    {
        CourseID = c.CourseID,
        CourseTitle = c.Title
    }).ToList()
};

以上例子将导致SELECT N + 1问题，因为每个子成员Course都将执行一次查询，除非通过ORM指定立即获取。使用LINQ投影，ORM不需要特殊配置或规范。ORM使用LINQ投影来构建所需的确切SQL查询。

自定义投影

如果成员名称不对应，或者您想要创建计算属性，则可以使用MapFrom（而不是ResolveUsing）为目标成员提供自定义表达式:

Mapper.Initialize(cfg => cfg.CreateMap<Customer, CustomerDto>()
    .ForMember(d => d.FullName, opt => opt.MapFrom(c => c.FirstName + " " + c.LastName))
    .ForMember(d => d.TotalContacts, opt => opt.MapFrom(c => c.Contacts.Count()));

AutoMapper使用构建的投影传递提供的表达式. 只要您的查询提供器可以解析提供的表达式，所有内容都将一直传递到数据库。

如果表达式被您的查询提供器（Entity Framework，NHibernate等）拒绝，您可能需要调整表达式，直到找到一个被接受的表达式。

自定义类型转换

有时，你需要完全替换源类型到目标类型的类型转换。在正常的运行时映射中，通过ConvertUsing方法完成。要在LINQ投影中达到类似的目的，请使用ProjectUsing方法：

cfg.CreateMap<Source, Dest>().ProjectUsing(src => new Dest { Value = 10 });

ProjectUsing比ConvertUsing限制略多，因为只有Expression中允许的内容和底层LINQ提供器支持的才有效。

自定义目标类型构造函数

如果你的目标类型有自定义的构造器，但你又不想重写整个映射，那么久使用ConstructProjectionUsing方法：

cfg.CreateMap<Source, Dest>()
    .ConstructProjectionUsing(src => new Dest(src.Value + 10));

AutoMapper将根据匹配的名称自动将目标构造函数参数与源成员匹配，因此，如果AutoMapper无法正确匹配目标构造函数，或者在构造期间需要扩展定义，则只能使用此方法。

字符串转换

当目标成员类型是字符串而源成员类型不是时，AutoMapper将自动添加ToString（）。

public class Order {
    public OrderTypeEnum OrderType { get; set; }
}
public class OrderDto {
    public string OrderType { get; set; }
}
var orders = dbContext.Orders.ProjectTo<OrderDto>().ToList();
orders[0].OrderType.ShouldEqual("Online");

显式展开

在某些情况下，例如OData，通过IQueryable控制器操作返回的通用DTO。如果没有明确的说明，AutoMapper将展开结果中的所有成员。为了在投影期间控制哪些成员要被展开，在配置中设置ExplicitExpansion然后后传入要显式展开的成员中去。

dbContext.Orders.ProjectTo<OrderDto>(
    dest => dest.Customer,
    dest => dest.LineItems);
// 或者基于字符串类型的
dbContext.Orders.ProjectTo<OrderDto>(
    null,
    "Customer",
    "LineItems");

聚合

LINQ可以支持聚合查询，AutoMapper又支持LINQ扩展方法。在自定义投影的例子中，如果我们将TotalContacts成员重命名为ContactsCount，AutoMapper 将匹配Count()扩展方面并且LINQ提供器将计数转换为相关子查询以聚合子记录。

如果LINQ提供程序支持，AutoMapper还可以支持复杂的聚合和嵌套限制：

cfg.CreateMap<Course, CourseModel>()
    .ForMember(m => m.EnrollmentsStartingWithA,
          opt => opt.MapFrom(c => c.Enrollments.Where(e => e.Student.LastName.StartsWith("A")).Count()));

此查询返回每个课程姓氏以字母“A”开头的学生总数。

参数化

有时候，投影需要运行时的参数做为它的值。如果需要将当前用户名作为它数据的一部分时，可以使用参数化MapFrom配置，来代替使用映射后代码：

string currentUserName = null;
cfg.CreateMap<Course, CourseModel>()
    .ForMember(m => m.CurrentUserName, opt => opt.MapFrom(src => currentUserName));

当我们投影时，我们将在运行时替换我们的参数：

dbContext.Courses.ProjectTo<CourseModel>(Config, new { currentUserName = Request.User.Name });

这将通过捕获原始表达式中闭包的字段名称来实现，然后使用匿名对象/字典在将查询发送给查询提供器之前将值应用于参数值。

支持的映射选项

不是所有映射选项都被支持，因为生成的表达式最终由LINQ提供器来解析。所以只有被LINQ提供器支持的才会被AutoMapper支持：

• MapFrom
• Ignore
• UseValue
• NullSubstitute

不支持的：

• Condition
• DoNotUseDestinationValue
• SetMappingOrder
• UseDestinationValue
• ResolveUsing
• Before/AfterMap
• 自定义解析器
• 自定义类型转换器
• 在程序域对象上的任何计算属性

另外，递归或自引用目标类型不被LINQ提供器支持，所以也不被支持。典型的层次关系数据模型需要公共表表达式参与（CTEs）以正确地解决递归问题。