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下执行,后续会扩展到其它数据库...)
关注下方公众号,可以获得名企内推。向大佬学习,探行业内幕,享时代机遇。