《Entity Framework 6 Recipes》中文翻译系列 (17) 第三章 查询之分页、过滤和使用DateTime中的日期部分分组

翻译的初衷以及为什么选择《Entity Framework 6 Recipes》来学习，请看本系列开篇

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章继续讨论它。

实体框架交流QQ群:  458326058，欢迎有兴趣的朋友加入一起交流

谢谢大家的持续关注，我的博客地址：http://www.cnblogs.com/VolcanoCloud/