這幾天做專案時遇到一個問題:要在使用者控制項(User Control)裡實作不刷新的 DropDownList 連動。折騰了一陣子總算解決,寫出來跟大家分享——高手可能早就知道了,但為了給自己留個紀錄,還是獻醜一次。
要無刷新,第一個想到的当然是 Ajax,我用的是 AjaxPro。真正卡住我的是另一件事:在使用者控制項裡用 JavaScript 取得頁面上的控制項 ID。
一般 ASPX 頁面直接用:
document.getElementById(ControlID);
就能拿到控制項。但如果是把使用者控制項放進另一個頁面再呼叫,這行就會失敗,瀏覽器丟出「缺少物件」的錯誤。原因不難理解:控制項被宿主頁面載入後,它的實際 ID 會被加上命名容器的層級前綴,並不等於你在控制項裡宣告的那個名字。
讓 ASP.NET 自己把最終的 ID 吐出來即可:
var id = '<%= this.ControlID.ClientID %>'; var obj = document.getElementById(id);
這兩行就能確實取到使用者控制項內部的子控制項。
以下是我這份程式碼的關鍵片段(資料綁定的部分省略,只留相關邏輯)。
private void Page_Load(object sender, System.EventArgs e)
{
// 註冊 AjaxPro 組件
AjaxPro.Utility.RegisterTypeForAJax(typeof(Top_test1));
if (!IsPostBack)
{
BindToPro(); // 綁定省份
BindToCity(); // 綁定城市
// 掛上 onchange 事件,觸發前端連動
this.ddlProSt_hy.Attributes.Add("onchange", "cityResult();");
}
}
前端收到選擇變更後,取出目前選中的省份值,透過 AjaxPro 呼叫伺服器端方法取得對應城市清單,再把結果填回城市的下拉選單——整個過程頁面不刷新。
只要牽涉到使用者控制項,JavaScript 裡就不該出現「寫死」的控制項 ID。養成用 ClientID 的習慣,控制項被重複使用或巢狀放置時才不會出錯。這 also 是使用 Master Page 時必然會遇到的同一類問題,早點習慣可以省下不少時間。