如何在ASP.NET MVC中实现分页功能

在ASP.NET MVC项目里，当数据量较大时，一次性加载所有数据会导致页面加载缓慢，还会影响用户浏览体验，因此分页是常用的优化手段。本文会介绍两种常见的ASP.NET MVC分页实现方式，分别是手动实现分页和使用PagedList组件实现分页。

一、手动实现分页的基础思路

手动实现分页的核心是计算分页参数，然后根据参数从数据源中截取对应页的数据。需要的分页参数包括：当前页码、每页显示条数、总数据条数、总页数。

1.1 控制器中的分页逻辑

首先在控制器中接收页码参数，计算分页相关数据，再把分页数据和当前页数据传递到视图。

// 假设使用Entity Framework作为数据访问层
public class ProductController : Controller
{
    private readonly MyDbContext _db = new MyDbContext();

    public ActionResult Index(int pageIndex = 1, int pageSize = 10)
    {
        // 获取总数据条数
        int totalCount = _db.Products.Count();
        // 计算总页数，使用Math.Ceiling向上取整
        int totalPages = (int)Math.Ceiling((double)totalCount / pageSize);
        // 页码边界校验，避免超出范围
        if (pageIndex < 1) pageIndex = 1;
        if (pageIndex > totalPages && totalPages > 0) pageIndex = totalPages;

        // 跳过前面的数据，取当前页的数据，使用Skip和Take方法
        var pageData = _db.Products
            .OrderBy(p => p.Id)
            .Skip((pageIndex - 1) * pageSize)
            .Take(pageSize)
            .ToList();

        // 把分页参数和当前页数据传递到视图
        ViewBag.PageIndex = pageIndex;
        ViewBag.PageSize = pageSize;
        ViewBag.TotalCount = totalCount;
        ViewBag.TotalPages = totalPages;

        return View(pageData);
    }
}

1.2 视图中的分页控件实现

视图中需要展示当前页的数据，同时还要生成分页导航按钮，方便用户切换页码。

@model List<Product>

<h2>产品列表</h2>
<table border="1" cellpadding="5" cellspacing="0">
    <tr>
        <th>ID</th>
        <th>产品名称</th>
        <th>价格</th>
    </tr>
    @foreach (var item in Model)
    {
        <tr>
            <td>@item.Id</td>
            <td>@item.Name</td>
            <td>@item.Price</td>
        </tr>
    }
</table>

<div class="pager">
    @if (ViewBag.PageIndex > 1)
    {
        <a href="/Product/Index?pageIndex=@(ViewBag.PageIndex - 1)&pageSize=@ViewBag.PageSize">上一页</a>
    }
    <span>第 @ViewBag.PageIndex 页 / 共 @ViewBag.TotalPages 页，总计 @ViewBag.TotalCount 条数据</span>
    @if (ViewBag.PageIndex < ViewBag.TotalPages)
    {
        <a href="/Product/Index?pageIndex=@(ViewBag.PageIndex + 1)&pageSize=@ViewBag.PageSize">下一页</a>
    }
</div>

二、使用PagedList组件简化分页实现

手动实现分页需要处理较多的参数计算和边界判断，实际开发中可以使用成熟的第三方组件PagedList.Mvc来简化流程，它已经封装好了分页的核心逻辑和分页控件。

2.1 安装PagedList组件

首先通过NuGet包管理器安装PagedList.Mvc包，安装完成后会自动引入相关的依赖。

2.2 控制器中使用PagedList

PagedList提供了ToPagedList扩展方法，可以直接把数据源转换为分页对象，不需要手动计算分页参数。

public class ProductController : Controller
{
    private readonly MyDbContext _db = new MyDbContext();

    public ActionResult Index(int page = 1, int pageSize = 10)
    {
        // 直接调用ToPagedList方法生成分页对象，第一个参数是当前页码，第二个是每页条数
        var pagedData = _db.Products
            .OrderBy(p => p.Id)
            .ToPagedList(page, pageSize);

        return View(pagedData);
    }
}

2.3 视图中使用PagedList的分页控件

PagedList会提供现成的分页 helper 方法，直接调用就可以生成完整的分页导航，不需要自己写分页按钮逻辑。

@model PagedList.IPagedList<Product>
@using PagedList.Mvc;

<h2>产品列表</h2>
<table border="1" cellpadding="5" cellspacing="0">
    <tr>
        <th>ID</th>
        <th>产品名称</th>
        <th>价格</th>
    </tr>
    @foreach (var item in Model)
    {
        <tr>
            <td>@item.Id</td>
            <td>@item.Name</td>
            <td>@item.Price</td>
        </tr>
    }
</table>

<div class="pager">
    @* 使用PagedList提供的分页控件，自动生成页码导航 *@
    @Html.PagedListPager(Model, page => Url.Action("Index", new { page, pageSize = Model.PageSize }))
    <span>第 @Model.PageNumber 页 / 共 @Model.PageCount 页，总计 @Model.TotalItemCount 条数据</span>
</div>

三、两种实现方式的对比

下面通过表格对比两种分页实现方式的特点，开发者可以根据项目需求选择：

四、分页实现的注意事项

• 分页查询时一定要对数据源进行排序，否则Skip和Take方法返回的数据可能不稳定，每次查询的结果顺序不一致。
• 要对传入的页码参数做边界校验，避免用户手动输入超出范围的页码导致查询异常。
• 如果数据量非常大，建议结合数据库的分页查询能力，不要先把所有数据查出来再在内存中分页，否则会浪费大量内存和查询资源。
• 如果需要支持用户自定义每页显示条数，可以在页面添加条数选择控件，把选中的条数传递到控制器的pageSize参数中。

ASP.NET_MVC分页数据查询PageList控制器修改时间：2026-06-04 14:58:24