《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 = ;
                 int pageSize = ;

                 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 = ;
                 int pageSize = ;

                 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 //
Jill Rogers
Steven Combs
Registrations for //
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/