《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 = "[e-mail]"
                });
                context.Customers.Add(new Customer
                {
                    Name = "Robertson, Alice",
                    Email = "[e-mail]"
                });
                context.Customers.Add(new Customer
                {
                    Name = "Rogers, Steven",
                    Email = "[e-mail]"
                });
                context.Customers.Add(new Customer
                {
                    Name = "Roe, Allen",
                    Email = "[e-mail]"
                });
                context.Customers.Add(new Customer
                {
                    Name = "Jones, Chris",
                    Email = "[e-mail]"
                });
                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: [e-mail]]
Robertson, Alice [email: [e-mail]]
Roe, Allen [email: [e-mail]]
Customers Ro*
Roberts, Jill [email: [e-mail]]
Robertson, Alice [email: [e-mail]]
Roe, Allen [email: [e-mail]]

 

原理

　　在代碼清單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/