這篇文章以一個動態載入使用者控制項的實例,說明如何在 ASP.NET AJAX 中實作出「點擊按鈕才出現日曆控制項,操作時不影響整個頁面,再次點擊則卸載」的效果。
頁面效果是:當使用者點擊按鈕時,出現日曆控制項。這個日曆是一個使用者自訂控制項,每月1日會顯示「發工資」的提示。對日曆進行操作時,不會造成整頁重新整理;當使用者再次點擊按鈕時,日曆控制項會被卸載。
過去也曾實作過類似日曆效果,但當時採用整體使用者控制項載入,且不具備卸載功能。控制項的出現與消失,主要透過 Visible 屬性控制。這種做法雖然直覺,卻會增加頁面負擔。後來改用動態載入與移除的方式,效能與結構都更清楚。
首先在網站中新增一個使用者控制項,預設名稱為 WebUserControl.ascx。接著在這個控制項中放入 Calendar 控制項,並依需求調整外觀。
Calendar 控制項有幾個實用屬性值得注意。SelectionMode 可控制日期選擇方式,例如 Day 允許點選單一日期,DayWeek 允許選擇整個星期,DayWeekMonth 允許選擇整個月份,None 則不允許操作。此外,在 DayRender 事件中,可將 e.Day.IsSelectable 設為 false,關閉某些日期的選擇能力,例如不允許選擇今天以前的日期。
若要讓每月1日出現提示,可在 Calendar 的 DayRender 事件中判斷日期文字是否為 1。若是,就在該儲存格中加入提示文字,並可調整邊框、背景色與對齊方式,讓提示更明顯。
接著新增一個 Ajax 頁面,例如 DynamicLoadControl.aspx,並在頁面中放入 ScriptManager 與 UpdatePanel。在 UpdatePanel 中放入一個按鈕,以及一個 HTML hidden 控制項。這個 hidden 控制項會被改為伺服器控制項,用來記錄使用者控制項是否已載入。
在 Page_Init 事件中,可先判斷 hidden 控制項的值。若值為 true,代表使用者控制項已存在,就載入控制項;若為 false,則不載入。這樣可避免頁面初始化時控制項狀態不一致。
當使用者點擊按鈕時,若 hidden 值為 true,代表控制項已存在,此時就從 UpdatePanel 中移除該控制項,並將 hidden 值改為 false。若 hidden 值為 false,則載入 WebUserControl.ascx,將控制項加入 UpdatePanel,並把 hidden 值改為 true。
這種做法的好處,是控制項的 existence 由伺服器端狀態明確管理,而不是單純依賴 Visible。透過 UpdatePanel,也能讓控制項的出現與消失維持在非同步更新的體驗中。
動態載入使用者控制項的關鍵,在於狀態標記、控制項容器與非同步更新三者的配合。只要掌握 Page_Init、Button_Click 與 LoadControl 的流程,就能延伸出許多靈活的互動介面。