在 ASP.NET Web Forms 開發中,使用者控制項是實現程式碼重用、模組化頁面結構的核心機制之一。本文將詳細說明如何在 ASPX 頁面中註冊、引用與建立使用者控制項,並提供實際可執行的程式碼範例,協助開發者快速掌握這項基礎且重要的技能。
@ Register 指令引入 .ascx 檔案。.ascx 的標記與後置程式碼邏輯。在目標 .aspx 檔案的最上方(通常緊接在 @ Page 指令之後),加入下列註冊指令:
<%@ Register Src="~/Controls/IndexTop.ascx" TagName="IndexTop" TagPrefix="uc_top" %>
屬性說明:
Src:控制項檔案的相對或絕對虛擬路徑。TagName:自訂的標籤名稱,供頁面引用時使用。TagPrefix:命名空間前綴,避免同名控制項衝突。於需要顯示控制項的位置,以 <TagPrefix:TagName ... /> 語法放入實例:
<uc_top:IndexTop ID="IndexTop1" runat="server" />
runat="server" 屬性必須存在,才能讓伺服器端識別並處理該控制項的生命週期事件。
IndexTop.ascx在專案的 Controls 資料夾下新增 IndexTop.ascx,基本結構如下:
<%@ Control Language="C#" AutoEventWireup="true" CodeBehind="IndexTop.ascx.cs" Inherits="YourNamespace.Controls.IndexTop" %>
<div class="index-top">
<h3>這是使用者控制項的標題區塊</h3>
<asp:Label ID="lblTime" runat="server" />
</div>
對應的後置程式碼 IndexTop.ascx.cs 可在 Page_Load 等事件中撰寫動態邏輯:
public partial class IndexTop : System.Web.UI.UserControl
{
protected void Page_Load(object sender, EventArgs e)
{
lblTime.Text = DateTime.Now.ToString("yyyy/MM/dd HH:mm:ss");
}
}
Page.LoadControl("~/Controls/IndexTop.ascx") 並加入至 PlaceHolder 或面板控制項中。public 屬性,父頁面即可透過 IndexTop1.MyProperty = "值" 進行參數傳遞。event 並 raise,父頁面訂閱後即可處理跨控制項互動。掌握「註冊 → 引用 → 實作」三步驟,即可在 ASP.NET Web Forms 中靈活運用使用者控制項,達到 UI 邏輯封裝與重用的目標。建議在專案中建立統一的控制項命名規範與目錄結構,便於團隊協作與長期維護。