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>
| 屬性 | 說明 |
|---|---|
| AllowPaging | 啟用分頁 |
| PageSize | 每頁筆數 |
| CurrentPageIndex | 目前頁索引 (0-based) |
| PageCount | 總頁數 |
| DataSourceCount | 資料總筆數 |
| IsFirstPage / IsLastPage | 是否首/尾頁 |
預設 PagedDataSource 會將所有資料載入記憶體再切片。百萬筆資料會造成 OOM。解法:實作 IPagedDataSource 或自訂類別,只從資料庫撈取當頁資料 (SQL `OFFSET/FETCH` 或 `ROW_NUMBER`),並手動設定 VirtualCount 告知總筆數。