.NET中大型項目開發必備(8)--高效分頁

本文轉載自查看原文 2022-01-20 02:27 1293 C#/ 數據分頁/ 分頁插件/ sqlserver/ 分頁/ .NET/ 數據庫/ sql server/ 分頁查詢

前言：本系列文章適合有初/中級.NET知識的同學閱讀（請在電腦上打開頁面，獲取更好的閱讀效果）。
（1）本系列文章，旨在講述研發一個中大型項目所需要了解的一系列“基本構件”，並提供這些“基本構件”在全網的【最簡單】、【最快速】使用方法！！（並不深究技術原理）
（2）通過閱讀本系列文章，能讓你在正規“項目研發”方面快速入門+進階，並能達成“小團隊構建大網站”的目的。
（3）本系列文章采用的技術，已成功應用到人工智能、產業互聯網、社區電商、游戲、金融風控、智慧醫療、等項目上。

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

數據分頁，幾乎是任何應用系統的必備功能。但當數據量較大時，分頁操作的效率就會變得很低。大數據量分頁時，一個操作耗時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語句的形式豐富多樣，可以帶條件、排序、甚至還能是多表的聯合查詢、等。

【附注】：下載示例均已成功運行通過。但有些輔助設置需要自己調整。技術支持+獲取更多寶貴資源：請微信掃描文末二維碼，備注“進群”！

推薦閱讀

免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。