使用者控制項 (`.ascx`) 封裝 UI 與邏輯,若需通知容器頁面「使用者點擊了內部按鈕」、「資料變更」等動作,必須對外公開事件,遵循「控制項觸發、頁面訂閱」模式,維持低耦合。
public event EventHandler EventName; (或自訂 EventHandler<TEventArgs>)protected virtual void OnEventName(EventArgs e) 引發方法OnEventName<%@ Control Language="C#" AutoEventWireup="true" CodeBehind="LinkClick.ascx.cs" Inherits="Demo.Controls.LinkClick" %>
<asp:LinkButton ID="lnkAction" runat="server" OnClick="lnkAction_Click">點擊我</asp:LinkButton>
public partial class LinkClick : UserControl
{
// 1. 公開事件
public event EventHandler LinkClicked;
protected void Page_Load(object sender, EventArgs e) { }
// 2. 引發方法
protected virtual void OnLinkClicked(EventArgs e)
{
LinkClicked?.Invoke(this, e); // C# 6.0 null-conditional operator
}
// 3. 內部按鈕點擊觸發
protected void lnkAction_Click(object sender, EventArgs e)
{
OnLinkClicked(EventArgs.Empty);
}
}
<%@ Register Src="~/Controls/LinkClick.ascx" TagPrefix="uc" TagName="LinkClick" %>
<uc:LinkClick ID="ucLink" runat="server" OnLinkClicked="ucLink_LinkClicked" />
<asp:Label ID="lblMsg" runat="server" />
protected void ucLink_LinkClicked(object sender, EventArgs e)
{
lblMsg.Text = $"使用者於 {DateTime.Now:HH:mm:ss} 點擊了連結";
}
// 自訂 EventArgs
public class LinkClickEventArgs : EventArgs
{
public string Url { get; set; }
public int UserId { get; set; }
}
// 控制項內
public event EventHandler<LinkClickEventArgs> LinkClickedWithData;
protected virtual void OnLinkClickedWithData(LinkClickEventArgs e) => LinkClickedWithData?.Invoke(this, e);
protected void lnkAction_Click(object sender, EventArgs e)
{
OnLinkClickedWithData(new LinkClickEventArgs { Url = "~/Detail.aspx", UserId = 123 });
}
// 頁面訂閱
protected void ucLink_LinkClickedWithData(object sender, LinkClickEventArgs e)
{
Response.Redirect($"{e.Url}?uid={e.UserId}");
}
On[動作] (引發方法) / [動作] (事件名) 慣例。virtual 允許衍生類別覆寫。?.Invoke 簡化 null 檢查,執行緒安全 (單執行緒 UI 無競爭)。Page.FindControl),破壞封裝。