萬盛學電腦網

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

ASP.NET 使用者控制項 (.ascx) 參數傳遞與跨頁面互動完整指南

使用者控制項 (.ascx) 是 ASP.NET Web Forms 封裝可重用 UI 片段的核心機制。掌握「如何向控制項傳參數」、「頁面如何存取控制項內部成員」、「控制項如何對外公開事件」三大核心技巧,是構建模組化、可維護頁面的關鍵。

一、 向使用者控制項傳遞參數:屬性注入模式

在 .ascx.cs 定義公共屬性,頁面透過宣告式標記或程式碼後置賦值。

1. 控制項端定義屬性

public partial class UC_UserClass : System.Web.UI.UserControl
{
    private int _classID = 0;
    public int ClassID
    {
        get { return _classID; }
        set { _classID = value; }
    }

    protected void Page_Load(object sender, EventArgs e)
    {
        if (!IsPostBack)
        {
            // 使用 ClassID 執行資料繫結等初始化邏輯
            BindData(_classID);
        }
    }
}

2. 頁面端宣告式傳值 (推薦,設計階段可見)

<%@ Register Src="~/Controls/UC_UserClass.ascx" TagPrefix="uc1" TagName="UC_UserClass" %>
<uc1:UC_UserClass ID="UC_UserClass1" runat="server" ClassID="100" />

3. 頁面端程式碼後置動態傳值 (靈活,支援運算邏輯)

// 必須在頁面類別宣告對應欄位,VS2005+ 自動生成,VS2003 需手動加入
protected UC_UserClass UC_UserClass1;

protected void Page_Load(object sender, EventArgs e)
{
    if (!IsPostBack)
    {
        UC_UserClass1.ClassID = 123456789; // 動態計算值
    }
}
注意:控制項 ID 必須與頁面類別欄位名稱完全一致,否則找不到強型別參考。

二、 頁面存取控制項內部控制項與方法

使用 FindControl 穿透命名容器邊界,或直接公開強型別屬性/方法。

1. 取得內部控制項實例

DropDownList ddl = UC_UserClass1.FindControl("ddlCategory") as DropDownList;
if (ddl != null) ddl.SelectedValue = "5";

2. 公開強型別包裝屬性 (推薦,封裝內部結構)

// 在 UC_UserClass.ascx.cs 中
public string SelectedCategory
{
    get { return ddlCategory.SelectedValue; }
    set { ddlCategory.SelectedValue = value; }
}

// 頁面直接使用
string cat = UC_UserClass1.SelectedCategory;
UC_UserClass1.SelectedCategory = "8";

3. 公開公共方法

// 控制項
public void RefreshData(int newClassID) { ClassID = newClassID; BindData(newClassID); }

// 頁面
UC_UserClass1.RefreshData(999);

三、 控制項向外發送事件:事件回呼模式

控制項定義事件,頁面訂閱處理,實現雙向通訊而不產生循環參考。

1. 控制項定義事件

public event EventHandler CategorySelected;

public class CategorySelectedEventArgs : EventArgs
{
    public int CategoryID { get; set; }
    public string CategoryName { get; set; }
}

protected void ddlCategory_SelectedIndexChanged(object sender, EventArgs e)
{
    var handler = CategorySelected;
    if (handler != null)
        handler(this, new CategorySelectedEventArgs 
        { 
            CategoryID = int.Parse(ddlCategory.SelectedValue),
            CategoryName = ddlCategory.SelectedItem.Text 
        });
}

2. 頁面訂閱事件

<uc1:UC_UserClass ID="UC_UserClass1" runat="server" OnCategorySelected="UC_UserClass1_CategorySelected" />

// 或程式碼後置
UC_UserClass1.CategorySelected += UC_UserClass1_CategorySelected;

void UC_UserClass1_CategorySelected(object sender, CategorySelectedEventArgs e)
{
    lblInfo.Text = $"使用者選擇: {e.CategoryName} (ID={e.CategoryID})";
}

四、 進階場景:動態載入使用者控制項

Control ctrl = LoadControl("~/Controls/UC_UserClass.ascx");
var uc = ctrl as UC_UserClass;
if (uc != null)
{
    uc.ClassID = 888;
    uc.CategorySelected += UC_CategorySelected;
    phContainer.Controls.Add(ctrl); // PlaceHolder 或 Panel 作為容器
}

關鍵點:動態載入必須在 Page_Init 或更早階段執行,並確保每次 PostBack 都以相同 ID 重建控制項樹,以維持 ViewState 與事件連線。

五、 常見坑與避雷指南

問題原因解決方案
屬性值在 PostBack 後歸零屬性未存入 ViewState屬性 getter/setter 讀寫 ViewState["Key"] 或使用 ControlState
FindControl 回傳 null命名容器隔離 / 控制項尚未建立 / ID 錯誤確認命名容器層級、在 PreRender 後查找、使用唯一 ID
動態載入控制項事件不觸發PostBack 時未以相同 ID 重建在 Page_Init 重建,ID 固定,ViewState 自動還原
VS2003 頁面類別缺少控制項欄位舊版設計師不自動生成手動加入 protected UC_UserClass UC_UserClass1; 欄位

結語

使用者控制項參數傳遞的核心是 屬性注入,跨邊界存取的核心是 FindControl 或強型別包裝,雙向通訊的核心是 事件模式。遵循「高內聚、低耦合、封裝內部結構」原則,將控制項打造成真正可重用、可測試、可維護的 UI 元件。

copyright © 萬盛學電腦網 all rights reserved