萬盛學電腦網

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

ASP.NET WebForm 如何在其他頁面呼叫使用者控制項的分頁功能

前言

將分頁邏輯封裝在 Web 使用者控制項 中,供多個頁面複用,是 WebForm 時代常見的模組化做法。本文示範如何在頁面 Page_Load 中取得控制項實例並設定其屬性(資料來源控制項、資料表、排序欄位),實現「一個分頁控制項,多頁共用」。

使用者控制項結構

Paging.ascx 暴露公開屬性:

public partial class Paging : System.Web.UI.UserControl
{
    public Control DataControl { get; set; }      // 要繫結的 GridView/Repeater 等
    public string TableName { get; set; }         // 資料表名
    public string Sort { get; set; } = "asc";     // 排序方向
    public string Column { get; set; }            // 排序/主鍵欄位
    
    // 內部實現:Page_Load 讀取屬性 → 查詢 DB → 繫結 DataControl
    // 提供 PageChanging 事件供外部處理換頁邏輯
}

呼叫頁面實作

public partial class BookTypeList : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            // 1. 取得使用者控制項實例(ID = Paging1)
            var paging = Paging1; 
            
            // 2. 設定屬性
            paging.DataControl = gvBookType;      // 頁面上的 GridView
            paging.TableName = "BookShop_BookType";
            paging.Sort = "asc";
            paging.Column = "BookType_ID";
            
            // 3. 控制項內部會自動執行首次繫結
        }
    }
}

進階:支援動態查詢條件

// 控制項擴充
public string WhereClause { get; set; } = "1=1";
public Dictionary Parameters { get; set; }

// 頁面使用
paging.WhereClause = "TypeName LIKE @Name AND IsActive = @Active";
paging.Parameters = new Dictionary
{
    ["@Name"] = "%" + txtSearch.Text + "%",
    ["@Active"] = true
};

注意事項

  • 控制項 ID 必須固定:頁面宣告 <uc:Paging ID="Paging1" runat="server" />,後端直接用 Paging1 存取。
  • 生命週期:在 Page_Load !IsPostBack 設定屬性,控制項內部 Page_Load 才會讀取到正確值。
  • ViewState 依賴:分頁控制項通常依賴 ViewState 保存頁碼、排序狀態,確認頁面與控制項 EnableViewState="true"。
  • 現代化替代:ASP.NET Core / Razor Pages 使用 TagHelper 或 ViewComponent 封裝分頁 UI,配合服務層提供分頁資料,完全分離關注點。

結語

WebForm 時代透過「使用者控制項 + 公開屬性」實現分頁元件複用,核心在於頁面初始化階段注入相依性(DataControl、TableName、Sort、Column)。雖屬舊技術,理解其「控制項組合」思想有助於理解現代元件化開發(Blazor Component、React Component、Vue Component)的同源邏輯。

copyright © 萬盛學電腦網 all rights reserved