正文

支持.Net/.Net Core/.Net Framework，可以部署在Docker, Windows, Linux, Mac。

數據分頁，幾乎是任何應用系統的必備功能。但當數據量較大時，分頁操作的效率就會變得很低。大數據量分頁時，一個操作耗時5秒、10秒、甚至更長時間都是有可能的，但這在用戶使用的角度是不可接受的……

數據分頁往往有三種常用方案。

第一種，把數據庫中存放的相關數據，全部讀入代碼/內存，再由代碼對其進行分頁操作。

第二種，直接在數據庫中對相關數據進行分頁操作，再把分頁后的數據輸出給代碼程序。

第三種，先把數據庫中的相關數據全部讀入“緩存”，再由代碼程序對“緩存”中的數據進行讀取+分頁操作。

本文下面重點闡述第一種與第二種兩個解決方案，它們也都是直接基于“數據庫”的。

（第三種方案雖然速度較快，但由于需要用到“緩存”這類第三方工具，且在有數據更改時需要較復雜的“數據庫-緩存”同步操作，故本文暫不詳述。）

◆◆第一種方案如下◆◆

從NuGet引入DeveloperSharp包，初始化IUtility工具

using DeveloperSharp.Framework.CoreUtility;
--------------------------
IUtility IU = new Utility();

IUtility內構建有3個重載的分頁PagePartition方法：

PagePartition
聲明：PagePiece PagePartition(DataTable Table, int PageSize, int PageIndex)
用途：分頁功能
參數：（1）DataTable Table ? -- ?需要分頁的DataTable
? ? ?（2）int PageSize ?-- ?頁面大小
? ? ?（3）int PageIndex ? ?-- ?當前頁碼
返回：PagePiece ? -- ?頁片實體
PagePartition
聲明：PagePiece<List<T>> PagePartition<T>(IQueryable<T> DataList, int pageSize, int pageIndex) where T : class
用途：分頁功能
參數：（1）IQueryable<T> DataList ? -- ?需要分頁的IQueryable
? ? ?（2）int PageSize ?-- ?頁面大小
? ? ?（3）int PageIndex ? ?-- ?當前頁碼
返回：PagePiece ? -- ?頁片實體
PagePartition
聲明：PagePiece<List<T>> PagePartition<T>(List<T> DataList, int pageSize, int pageIndex) where T : class
用途：分頁功能
參數：（1）List<T> DataList ? -- ?需要分頁的List
? ? ?（2）int PageSize ?-- ?頁面大小
? ? ?（3）int PageIndex ? ?-- ?當前頁碼
返回：PagePiece ? -- ?頁片實體

分頁方法的返回值PagePiece/PagePiece<T>類，包含分頁后的數據集、總頁數、總數據、當前頁碼、等等一系列“分頁”后經常會用到的數據。PagePiece/PagePiece<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 --當前頁碼
Table
聲明：public System.Data.DataTable Table;
用途：System.Data.DataTable--當前頁的數據表
（或者）
DataList
聲明：public List<T> DataList;
用途：List<T>--當前頁的數據

◆◆第二種方案如下◆◆

為了演示“第二種分頁方案”如何使用，我們首先在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>();
            foreach (var P in Products)
            {
                Console.WriteLine(P.Name);
            }

            Console.ReadLine();
        }
    }

Product類代碼如下：

public class Product
    {
        public string Id { get; set; }
        public string Name { get; set; }
        public int Quantity { get; set; }
    }

此處的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語句的形式豐富多樣，可以帶條件、排序、甚至還能是多表的聯合查詢、等。