控制項註冊
<%@ 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();
}
控制項屬性說明
| 屬性 | 型別 | 預設值 | 說明 |
| PageSize | int | 10 | 每頁筆數 |
| TotalRecords | int | 0 | 總筆數 (必須正確設定才會顯示正確頁碼) |
| CurrentPage | int | 1 | 目前頁碼,PostBack 後自動更新 |
| CssClass | string | "pager" | 最外層容器 CSS 類別 |
| ShowFirstLast | bool | true | 是否顯示首頁/末頁 |
| ShowPrevNext | bool | true | 是否顯示上一頁/下一頁 |
| NumericPageCount | int | 10 | 數字頁碼顯示個數 |
樣式自訂 (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。