ASP.NET 事件回傳機制深度解析：UniqueID、Name 屬性與 Request.Form 尋找控制項

現象觀察：為什麼 ID、ClientID、UniqueID 不同？

拖放 Button 至 UserControl (EventModule.ascx)，再放入頁面 (Default.aspx)：

• Button1.ID = "Button1" (程式碼邏輯識別碼)
• Button1.ClientID = "EventModule1_Button1" (瀏覽器端 HTML id 屬性)
• Button1.UniqueID = "EventModule1$Button1" (表單提交時的 name 屬性值)

瀏覽器回傳表單資料時，**只有 name 屬性會被送回伺服器**，伺服器端透過 Request.Form["EventModule1$Button1"] 找到觸發事件的控制項。

HTML 輸出驗證

<input type="submit" name="EventModule1$Button1" value="EventButton" id="EventModule1_Button1" />

• name="EventModule1$Button1" → 對應 UniqueID，含命名容器分隔符 $。
• id="EventModule1_Button1" → 對應 ClientID，分隔符 _，供 JavaScript/CSS 選取。

伺服器端尋找控制項流程

1. 瀏覽器提交表單，HTTP Request Body 包含 EventModule1$Button1=EventButton。
2. ASP.NET 管線 ProcessPostData 階段，解析 Form 集合。
3. 頁面呼叫 FindControl("EventModule1$Button1") (內部實作)。
4. FindControl 以 $ 分割："EventModule1" → 找到 UserControl → "Button1" → 找到 Button。
5. 確認控制項實作 IPostBackEventHandler，呼叫 RaisePostBackEvent 觸發 Click 事件。

兩個 Button 驗證：只有被點擊的 Button 回傳

頁面放置兩個 Button (Button1、Button2)，點擊 Button1 後，Request.Form 僅包含 EventModule1$Button1，**不包含** Button2 的鍵值。這證明：

• HTML 表單提交機制：只有被點擊的 <input type="submit"> 其 name/value 會被送出。
• ASP.NET 擷取該鍵，精確定位到唯一控制項，觸發其事件。

命名容器與 ID 分隔符規則

實作 IPostBackEventHandler 自訂回傳控制項

Public Class MyCustomButton : Implements IPostBackEventHandler
    Public Event Click As EventHandler
    
    Protected Overrides Sub Render(writer As HtmlTextWriter)
        ' 輸出隱藏欄位攜帶命令參數
        writer.Write("")
        ' 輸出可見按鈕
        writer.Write("" & Me.Text & "")
    End Sub
    
    Public Sub RaisePostBackEvent(eventArgument As String) Implements IPostBackEventHandler.RaisePostBackEvent
        ' eventArgument 即隱藏欄位 value
        RaiseEvent Click(Me, New EventArgs())
    End Sub
End Class

__EVENTTARGET / __EVENTARGUMENT 隱藏欄位機制

ASP.NET 頁面自動輸出兩個隱藏欄位：

<input type="hidden" name="__EVENTTARGET" id="__EVENTTARGET" value="" />
<input type="hidden" name="__EVENTARGUMENT" id="__EVENTARGUMENT" value="" />

• LinkButton、ImageButton、AutoPostBack=True 控制項：透過 __doPostBack('UniqueID', 'Argument') JavaScript 設定兩欄位值並提交表單。
• 伺服器端 RaisePostBackEvent 讀取 Request.Form["__EVENTTARGET"] 找到控制項 UniqueID，再呼叫其 RaisePostBackEvent(argument)。

常見問題與除錯

結語

ASP.NET 事件回傳機制建立在 **HTML 表單提交** 與 **命名容器層級 ID (UniqueID)** 之上。掌握 UniqueID (name/$)、ClientID (id/_)、ID 三者差異、Request.Form 解析流程、FindControl 遞迴邏輯、__doPostBack 隱藏欄位協定，即能從根本理解「為什麼點擊按鈕能精準觸發伺服器事件」，並快速排除動態控制項、UserControl、JavaScript 互動等常見回傳失效問題。