第三章 查询之翻页、过滤和使用DateTime中的日期部分分组

3-12 翻页和过滤

问题

你想使用分页和过滤来创建查询。

解决方案

假设你有如图3-13所示的模型,模型中有一个Custormer实体类型。

图3-13 包含一个Customer实体类型的模型

你有一个基于过滤条件来显示客户信息的应用。你的公司有许多客户(也许数百万!),为了保证尽可能响应的用户体验,你想在每一页上只显示一定数量的客户。创建一个查询,它能过虑客户并按页返回可控数量的结果集。如代码清单3-26所示。

代码清单3-26. 一个包含过滤和分页的查询

using (var context = new EFRecipesEntities())
{
    // 删除之前的数据
    context.Database.ExecuteSqlCommand("delete from chapter3.customer");
    // 添加新的测试数据
    context.Customers.Add(new Customer
    {
        Name = "Roberts, Jill",
        Email = "jroberts@abc.com"
    });
    context.Customers.Add(new Customer
    {
        Name = "Robertson, Alice",
        Email = "arob@gmail.com"
    });
    context.Customers.Add(new Customer
    {
        Name = "Rogers, Steven",
        Email = "srogers@termite.com"
    });
    context.Customers.Add(new Customer
    {
        Name = "Roe, Allen",
        Email = "allenr@umc.com"
    });
    context.Customers.Add(new Customer
    {
        Name = "Jones, Chris",
        Email = "cjones@ibp.com"
    });
    context.SaveChanges();
}


using (var context = new EFRecipesEntities())
{
    string match = "Ro";
    int pageIndex = 0;
    int pageSize = 3;

    var customers = context.Customers.Where(c => c.Name.StartsWith(match))
    //var customers = context.Customers.Where(c => c.Name.Contains(match))
                        .OrderBy(c => c.Name)
                        .Skip(pageIndex * pageSize)
                        .Take(pageSize);
    Console.WriteLine("Customers Ro*");
    foreach (var customer in customers)
    {
        Console.WriteLine("{0} [email: {1}]", customer.Name, customer.Email);
    }
}

using (var context = new EFRecipesEntities())
{
    string match = "Ro%";
    int pageIndex = 0;
    int pageSize = 3;

    var esql = @"select value c from Customers as c
     where c.Name like @Name
     order by c.Name
     skip @Skip limit @Limit";
    Console.WriteLine("\nCustomers Ro*");
    var customers = ((IObjectContextAdapter)context).ObjectContext.CreateQuery<Customer>(esql, new[]
          {
            new ObjectParameter("Name",match),
            new ObjectParameter("Skip",pageIndex * pageSize),
            new ObjectParameter("Limit",pageSize)
          });
    foreach (var customer in customers)
    {
        Console.WriteLine("{0} [email: {1}]", customer.Name, customer.Email);
    }
}

Console.WriteLine("\nPress <enter> to continue...");
Console.ReadLine();

代码清单3-26的输出如下:

Customers Ro*
Roberts, Jill [email: jroberts@abc.com]
Robertson, Alice [email: arob@gmail.com]
Roe, Allen [email: allenr@umc.com]
Customers Ro*
Roberts, Jill [email: jroberts@abc.com]
Robertson, Alice [email: arob@gmail.com]
Roe, Allen [email: allenr@umc.com]


原理

在代码清单3-26中,针对这个问题,我们展示了不同的方法。在第一种方法中,我们使用了LINQ to Entities扩展方法创建了一个LINQ查询。我们使用Where()方法过滤结果集,过虑条件为,姓以“Ro“开头。因为我们在lambda表达工中使用了扩展方法StartsWith()。我们不需要使用SQL的通配符表达式“Ro%"。

过滤后,我们使用OrderBy()方法对结果集排序,排序后的结果集通过方法Skip()来获取。我们使用Skip()方法跳过PageIndex页,每页的大小为PageSize. 使用Take()方法来获取受限的结果集(译注:从结果集获取指定页大小的记录数),我们只需要获取结果集中的一页。

注意,在代码块中,我们使用LINQ扩展方法创建了一个完整的查询,而不是我们之前看到的SQL查询表达式。Skip()和Take()方法只在扩展方法中公布,不是查询语法。

第二种方法,我们构建了一个完整的参数化的Entity SQL表达式,这也许是你最熟悉的方式,但是这在使用字符串和可执行代码(C#)来表示查询的两种方式间产生了固有的不匹配风险。

3-13 按日期分组

问题

你有一个包含DateTime类型属性的实体,你想通过DateTime类型属性的Date部分来对实体的实例进行分组。

解决方案

假设你有如图3-14所示的模型,模型中有一个Registration实体类型,该实体类型包含一个DateTime类型的属性。

图3-14 模型中有一个Registration实体类型,该实体类型包含一个DateTime类型的属性

该示例使用Code-First方法,在代码清单3-27中,我们创建了一些实体。

代码清单3-27. Registration实体类型

public class Registration
{
    public int RegistrationId { get; set; }
    public string StudentName { get; set; }
    public DateTime? RegistrationDate { get; set; }
}

接下来,代码清单3-28中创建了上下文对象,它是用Code-First方法访问实体框架功能的入口。

代码清单3-28. 上下文对象

public class EFRecipesEntities : DbContext
{
    public EFRecipesEntities()
        : base("ConnectionString") {}
    public DbSet<Registration> Registrations { get; set; }
    protected override void OnModelCreating(DbModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Registration>().ToTable("Chapter3.Registration");
        base.OnModelCreating(modelBuilder);
    }
}

我们使用RegistrationDate属性的Date部分对所有的registrations进行分组,你可能会对LINQ中的 group by RegistrationDate.Date动心.虽然能过编译,但是你仍会得到一个运行时错误,该错误描述Date不能转换成SQL。 为了能使用RegistrationDate属性的Date部分来分组,请看代码清单3-29.

代码清单3-29. 使用DateTime类型属性的Date部分对实例进行分组

using (var context = new EFRecipesEntities())
{
    // 删除之前的测试数据
    context.Database.ExecuteSqlCommand("delete from chapter3.registration");
    // 添加新的测试数据
    context.Registrations.Add(new Registration
    {
        StudentName = "Jill Rogers",
        RegistrationDate = DateTime.Parse("12/03/2009 9:30 pm")
    });
    context.Registrations.Add(new Registration
    {
        StudentName = "Steven Combs",
        RegistrationDate = DateTime.Parse("12/03/2009 10:45 am")
    });
    context.Registrations.Add(new Registration
    {
        StudentName = "Robin Rosen",
        RegistrationDate = DateTime.Parse("12/04/2009 11:18 am")
    });
    context.Registrations.Add(new Registration
    {
        StudentName = "Allen Smith",
        RegistrationDate = DateTime.Parse("12/04/2009 3:31 pm")
    });
    context.SaveChanges();
}

using (var context = new EFRecipesEntities())
{
    var groups = from r in context.Registrations
                 // 凭借内置的TruncateTime函数提取Date部分
                 group r by DbFunctions.TruncateTime(r.RegistrationDate)
                     into g
                     select g;
    foreach (var element in groups)
    {
        Console.WriteLine("\nRegistrations for {0}",
               ((DateTime)element.Key).ToShortDateString());
        foreach (var registration in element)
        {
            Console.WriteLine("\t{0}", registration.StudentName);
        }
    }
}

Console.WriteLine("\nPress <enter> to continue...");
Console.ReadLine();

代码清单3-29输出如下:

Registrations for 12/3/2009
Jill Rogers
Steven Combs
Registrations for 12/4/2009
Robin Rosen
Allen Smit


原理

对registrations分组的分组键是通过Truncate()函数提RegistrationDate属性中的Date部分。这是实体框架的内置函数,包含在DbFunctions类中,它只提取DateTime中的Date部分。内置的DbFunctions类,包含着大量的,格式化、聚合、字符串操作、日期和数字服务。它在命名空间System.Data.Entity中。遗留类,EntityFunctios,是在EF6之前的版本中使用的,它仍然能在EF6中使用,但你会得到一个编译警告,它建议你使用最亲的DbFunctions类。我们将在11章继续讨论它。

《Entity Framework 6 Recipes》中文翻译系列