.NET/C#大型项目研发必备(8)--高效分页

DeveloperSharp

已于 2023-10-01 04:00:24 修改

阅读量900

点赞数

文章标签： c# 大数据数据库 sqlserver .net

于 2022-01-12 23:23:30 首次发布

本文链接：https://blog.csdn.net/weixin_45237473/article/details/122464052

版权

前言：本系列文章适合有初/中级.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  --页片实体