ASP.NET SqlPager 分頁控制項使用完整指南

SqlPager 是整合於 Winson.Framework 的靈活分頁控制項，基於 PagedDataSource，支援 AJAX/PostBack、多種分頁樣式、快取/非快取模式、多種資料來源控制項繫結。

主要功能

• AJAX 分頁與傳統 PostBack 切換。
• 內建數種分頁按鈕樣式，支援自訂樣式。
• 一次性載入全量資料（快取模式）或每頁查詢（非快取模式）。
• 可繫結 GridView、Repeater、DataList、ListControl 等。
• 支援頁面內 SQL 查詢或後端自訂資料源。
• 可指定排序欄位。
• 完全開源，方便擴充。

基本使用步驟

1. 註冊控制項

<%@ Register Assembly="Winson.WControls" Namespace="Winson.SqlPager" TagPrefix="SqlPager" %>

2. 放置控制項並設定屬性

<SqlPager:SqlPager ID="SqlPager1" runat="server"
    ControlToPaginate="GridView1"
    Width="700"
    ItemsPerPage="4"
    BorderStyle="Dotted"
    BackColor="#ffffff"
    PagerStyle="CustomAndNumeric"
    FirstButton="第一頁"
    PrevButton="上一頁"
    NextButton="下一頁"
    LastButton="最後一頁"
    PagingMode="Cached">
</SqlPager:SqlPager>

關鍵屬性說明

後端繫結範例 (NonCached 模式)

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        SqlPager1.PagingMode = PagingMode.NonCached;
        SqlPager1.DataBind += (s, args) =>
        {
            // args.StartRowIndex, args.MaximumRows 已由控制項計算
            string sql = "SELECT * FROM Products ORDER BY ProductID";
            DataTable dt = DbHelper.GetPagedData(sql, args.StartRowIndex, args.MaximumRows);
            GridView1.DataSource = dt;
            GridView1.DataBind();
            args.TotalRowCount = DbHelper.GetTotalCount("Products"); // 必須回傳總筆數
        };
    }
}

進階：自訂分頁樣式

設定 PagerStyle="Custom" 並提供 FirstButtonTemplate、NumericButtonTemplate 等模板，完全掌控 HTML 輸出。

1. 上一篇文章： ASP.NET + XML 打造網路硬碟：資料夾瀏覽與權限控制
2. 下一篇文章： 精通 ASP.NET 彈出視窗技術：從 alert 到 RegisterStartupScript

關於ASP.NET

ASP.NET 2.0 數據教程（十二）：GridView TemplateField 進階自訂與格式化方法應用

返回 ASP.NET 2.0 數據教程目錄 導言 Grid

基於 C# 與 ADO.NET 的分散式資料庫查詢系統實作指南

系統需求與架構設計 某家電連鎖企業擁有總部與多家分店，需實現

解決 Visual Studio 設計時「呈現控件時出錯」的根因與對策

前言 開發自訂控制項時，設計介面常出現「呈現控件時出錯：未將

ASP.NET 2.0 設計線上投票系統：資料庫設計與功能實作

線上投票系統核心功能：投票項目增刪、投票動作、即時結果顯示。