將分頁邏輯封裝在 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
};
<uc:Paging ID="Paging1" runat="server" />,後端直接用 Paging1 存取。Page_Load !IsPostBack 設定屬性,控制項內部 Page_Load 才會讀取到正確值。EnableViewState="true"。WebForm 時代透過「使用者控制項 + 公開屬性」實現分頁元件複用,核心在於頁面初始化階段注入相依性(DataControl、TableName、Sort、Column)。雖屬舊技術,理解其「控制項組合」思想有助於理解現代元件化開發(Blazor Component、React Component、Vue Component)的同源邏輯。