萬盛學電腦網

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

ASP.NET Google 風格分頁控制項 TinyPager 使用指南

控制項註冊

<%@ Register Assembly="TinyToolBox" Namespace="TinyMS.UI" TagPrefix="tm" %>

頁面引用

<tm:TinyPager ID="TinyPager1" runat="server" PageSize="20" TotalRecords="289" OnPageClick="TinyPager1_Click" />

後端事件處理

protected void TinyPager1_Click(object sender, TinyMS.UI.PagerEventArgs e)
{
    // e.PageNo 為使用者點選的頁碼 (1-based)
    this.Label1.Text = $"第 {e.PageNo} 頁";
    // 這裡重新查詢資料並綁定 GridView/Repeater
    BindData(e.PageNo);
}

private void BindData(int pageNo)
{
    // 範例:使用分頁預存程序或 Skip/Take
    using (var db = new MyDbContext())
    {
        var list = db.Items.OrderBy(x => x.Id).Skip((pageNo-1)*20).Take(20).ToList();
        GridView1.DataSource = list;
        GridView1.DataBind();
    }
    // 更新 TotalRecords (若總筆數變動)
    TinyPager1.TotalRecords = GetTotalCount();
}

控制項屬性說明

屬性型別預設值說明
PageSizeint10每頁筆數
TotalRecordsint0總筆數 (必須正確設定才會顯示正確頁碼)
CurrentPageint1目前頁碼,PostBack 後自動更新
CssClassstring"pager"最外層容器 CSS 類別
ShowFirstLastbooltrue是否顯示首頁/末頁
ShowPrevNextbooltrue是否顯示上一頁/下一頁
NumericPageCountint10數字頁碼顯示個數

樣式自訂 (CSS)

.pager a, .pager span { display:inline-block; padding:4px 8px; margin:0 2px; border:1px solid #ddd; text-decoration:none; }
.pager .current { background:#0066cc; color:#fff; border-color:#0066cc; }
.pager .disabled { color:#999; border-color:#eee; pointer-events:none; }

優缺點評估

  • ✅ 輕量、無相依、Google 風格美觀、支援 PostBack/Ajax 兩種模式。
  • ✅ 事件模型符合 WebForms 慣例,易上手。
  • ❌ 僅支援 WebForms,MVC/Razor Pages 需自行實作或用 PagedList.Mvc。
  • ❌ 原始碼未開源,擴充彈性有限。

替代方案

  • MVC:PagedList.Mvc + ``
  • WebForms 原生:`DataPager` 控制項搭配 `ListView`
  • 通用:前端分頁 (jQuery DataTables、Bootstrap Pagination) + WebAPI 回傳 JSON。
copyright © 萬盛學電腦網 all rights reserved