萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

Repeater 搭配 PagedDataSource 實現分頁功能完整教學

Repeater 本身不支援分頁,但可搭配 PagedDataSource 封裝分頁邏輯 (資料來源切片、頁碼計算),再自行渲染分頁導覽列。

後端分頁核心代碼

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        int pageIndex = 1;
        int.TryParse(Request.QueryString["Page"], out pageIndex);
        pageIndex = Math.Max(1, pageIndex);

        DataTable dt = GetDocumentTable(); // 取得完整資料

        var pds = new PagedDataSource
        {
            DataSource = dt.DefaultView,
            AllowPaging = true,
            PageSize = 5,
            CurrentPageIndex = pageIndex - 1 // 0-based
        };

        rptDoc.DataSource = pds;
        rptDoc.DataBind();

        ltlPager.Text = BuildPager(pds, Request.CurrentExecutionFilePath);
    }
}

private string BuildPager(PagedDataSource pds, string url)
{
    int cur = pds.CurrentPageIndex + 1;
    int total = pds.PageCount;
    var sb = new System.Text.StringBuilder();

    Action addLink = (p, text) => 
        sb.Append($"<a href='{url}?Page={p}'>{text}</a> ");

    // 首頁 / 上一頁
    if (cur == 1) sb.Append("首頁 上一頁 ");
    else { addLink(1, "首頁"); addLink(cur - 1, "上一頁"); }

    // 頁碼區塊 (最多顯示 10 頁)
    int start = Math.Max(1, cur - 5);
    int end = Math.Min(total, start + 9);
    for (int i = start; i <= end; i++)
    {
        if (i == cur) sb.Append($"<span class='current'>{i}</span> ");
        else addLink(i, i.ToString());
    }

    // 下一頁 / 末頁
    if (cur == total) sb.Append("下一頁 末頁");
    else { addLink(cur + 1, "下一頁"); addLink(total, "末頁"); }

    return sb.ToString();
}

private DataTable GetDocumentTable()
{
    var dt = new DataTable();
    dt.Columns.Add("DocumentId", typeof(int));
    dt.Columns.Add("Title", typeof(string));
    for (int i = 1; i <= 30; i++)
        dt.Rows.Add(i, $"文檔標題 {i}");
    return dt;
}

前端繫結

<asp:Repeater ID="rptDoc" runat="server">
    <HeaderTemplate><ul class="doc-list"></HeaderTemplate>
    <ItemTemplate>
        <li><%# Eval("DocumentId") %>. <%# Eval("Title") %></li>
    </ItemTemplate>
    <FooterTemplate></ul></FooterTemplate>
</asp:Repeater>
<div class="pager"><asp:Literal ID="ltlPager" runat="server" /></div>

PagedDataSource 關鍵屬性速查

屬性說明
AllowPaging啟用分頁
PageSize每頁筆數
CurrentPageIndex目前頁索引 (0-based)
PageCount總頁數
DataSourceCount資料總筆數
IsFirstPage / IsLastPage是否首/尾頁

大量資料優化:自訂分頁

預設 PagedDataSource 會將所有資料載入記憶體再切片。百萬筆資料會造成 OOM。解法:實作 IPagedDataSource 或自訂類別,只從資料庫撈取當頁資料 (SQL `OFFSET/FETCH` 或 `ROW_NUMBER`),並手動設定 VirtualCount 告知總筆數。

copyright © 萬盛學電腦網 all rights reserved