DeveloperSharp系列近期又被製造業ERP、民航飛行App、建築BIM、電力掌上營業廳、等多家大型採用,站在巨人的肩膀上你能走的更遠。 支持.Net Core2.0及以上,支持.Net Framework4.0及以上 數據分頁,幾乎是任何應用系統的必備功能。但當數據量較大時,分頁操作的效率 ...
DeveloperSharp系列近期又被製造業ERP、民航飛行App、建築BIM、電力掌上營業廳、等多家大型採用,站在巨人的肩膀上你能走的更遠。
支持.Net Core2.0及以上,支持.Net Framework4.0及以上
數據分頁,幾乎是任何應用系統的必備功能。但當數據量較大時,分頁操作的效率就會變得很低。大數據量分頁時,一個操作耗時5秒、10秒、甚至更長時間都是有可能的,但這在用戶使用的角度是不可接受的……
數據分頁往往有三種常用方案。
第一種,把資料庫中存放的相關數據,全部讀入代碼/記憶體,再由代碼對其進行分頁操作。
第二種,直接在資料庫中對相關數據進行分頁操作,再把分頁後的數據輸出給代碼程式。
第三種,先把資料庫中的相關數據全部讀入“緩存”,再由代碼程式對“緩存”中的數據進行讀取+分頁操作。
本文下麵重點闡述第一種與第二種兩個解決方案,它們也都是直接基於“資料庫”的。
(第三種方案雖然速度較快,但由於需要用到“緩存”這類第三方工具,且在有數據更改時需要較複雜的“資料庫-緩存”同步操作,故本文暫不詳述。)
◆◆第一種方案如下◆◆
從NuGet引入DeveloperSharp包,然後像如下那樣使用分頁功能:
using DeveloperSharp.Extension; -------------------------- var Page1 = DataAll.PagePartition(20, 5);
其中,要被分頁的DataAll對象可以是List<T>、IQueryable<T>、IEnumerable<T>、等任何集合類型。
PagePartition方法的第一個參數是“頁大小”,第二個參數是“頁序號”,即:PagePartition<T>(int pageSize, int pageIndex)
分頁後的返回值Page1的類型是:PagePiece<IEnumerable<T>>,它包含分頁後的數據集、總頁數、總數據、當前頁碼、等等一系列“分頁”後經常會用到的數據。PagePiece<IEnumerable<T>>對象內包含的屬性的詳細說明如下:
DataList 聲明:public IEnumerable<T> DataList; 用途:IEnumerable<T> --當前頁的數據 PageSize 聲明:public int PageSize; 用途:int --頁面大小 TotalPageNumber 聲明:public int TotalPageNumber; 用途:int --總頁數 TotalRecordNumber 聲明:public int TotalRecordNumber; 用途:int --記錄總數 CurrentStartIndex 聲明:public int CurrentStartIndex; 用途:int --當前頁的記錄起始編號 CurrentEndIndex 聲明:public int CurrentEndIndex; 用途:int --當前頁的記錄結束編號 CurrentPageSize 聲明:public int CurrentPageSize; 用途:int --當前頁的記錄數量 CurrentPageIndex 聲明:public int CurrentPageIndex; 用途:int --當前頁碼
以上,即是全網最簡單的“分頁”方法。此方法不僅簡單,還有兩大額外好處。
其一是:方法返回對象中,已自動包含了“分頁”後後續操作所需的全部相關數據(見上述8個),不需再做額外計算處理。
其二是:此方法已自動處理過傳入“頁序號”為負數、或、大於總頁數、等等意外情況,可安心使用。
◆◆第二種方案如下(包含“無主鍵分頁”)◆◆
為了演示“第二種分頁方案”如何使用,我們首先在Visual Studio中新建一個控制台工程。然後,我們做如下三個操作。
【第一步】:從NuGet引用DeveloperSharp包。
【第二步】:創建一個用來與資料庫進行通信的“數據源類”(文本示例為:TestData.cs),內容如下:
using DeveloperSharp.Structure.Model;//DataSource的命名空間 using DeveloperSharp.Framework.QueryEngine;//DatabaseType的命名空間 namespace YZZ { [DataSource(DatabaseType.SQLServer, "Server=localhost;Database=Test;Uid=sa;Pwd=123")] public class TestData : DeveloperSharp.Structure.Model.DataLayer { //類中沒有任何代碼 } }
說 明 :“數據源類”(文本示例為:TestData.cs)必 須 繼 承 自 DeveloperSharp.Structure.Model.DataLayer 類 , 並 且 在 其 上 設 置DataSource屬 性 的 初 始 化 值 為“資料庫類型”及其“鏈接字元串”。
【第三步】:為控制台應用類,添加通過“數據源類”(TestData)調用其PagePartition方法進行數據分頁的代碼。註 意:核心代碼就一行而已!!
代碼如下:
using DeveloperSharp.Extension;//Table擴展所在的命名空間(.NET6/VS2022用戶,則需要在.csproj文件中的<ItemGroup>下添加<Using>標簽) ----------------------------- class Program { static void Main(string[] args) { TestData td = new TestData(); //分頁 var pp = td.PagePartition("select top 5000 * from t_Order where Id>10 order by Id desc", 20, 162); List<Product> Products = pp.Table.ToList<Product>();//若沒有定義Product類,也可以使用dynamic替代 foreach (var P in Products) { Console.WriteLine(P.Name); } Console.ReadLine(); } }
Product類代碼如下:
//此實體類中的Id、Name、Quantity、ExpireTime、Model屬性名,要與數據表中的Id、Name、Quantity、ExpireTime、Model欄位名對應 public class Product { public string Id { get; set; } public string Name { get; set; } public int? Quantity { get; set; }//資料庫中該欄位若存在Null值,類型後需要加問號? public DateTime? ExpireTime { get; set; } public model? Model { get; set; }//也可以使用枚舉,會自動轉換 } public enum model { Junior=1, Middle=2, Senior=3 }
此處的PagePartition方法有兩個重載方法,其詳細功能說明如下:
PagePartition 聲明:public PagePiece PagePartition(string RecordSet, string Id, int PageSize, int PageIndex) 用途:分頁功能(有主鍵) 參數:(1)string RecordSet --需要分頁的記錄集,可以是表、視圖、或者SQL語句 (2)string Id --主鍵 (3)int PageSize --頁面大小 (4)int PageIndex --當前頁碼 返回:PagePiece --頁片實體 PagePartition 聲明:public PagePiece PagePartition(string RecordSet, int PageSize, int PageIndex) 用途:分頁功能(無主鍵) 參數:(1)string RecordSet -- 需要分頁的記錄集,可以是表、視圖、或者SQL語句 (2)int PageSize --頁面大小 (3)int PageIndex --當前頁碼 返回:PagePiece --頁片實體
註意:
(1) 當你需要分頁的數據表有“主鍵”欄位時,使用“分頁功能(有主鍵)”。反之,使用“分頁功能(無主鍵)”。
(2) RecordSet是你需要分頁的“數據總集”的SQL語句。該SQL語句的形式豐富多樣,可以帶條件、排序、甚至還能是多表的聯合查詢、等。
(該方案目前只能在Sql Server下執行,後續會擴展到其它資料庫...)
關註下方公眾號,可以獲得名企內推。向大佬學習,探行業內幕,享時代機遇。