輸入框打字、下方即時浮出候選清單——這個互動自從被 Google 帶紅之後,幾乎成了搜尋框的標準配備。在 ASP.NET Ajax 的架構下,它其實可以拆成很乾淨的兩半:一個負責把使用者輸入送到伺服器的用戶端函式,一個回傳 DataSet 並由回呼函式填進下拉清單。




<html>
<head>
<title>WebForm1</title>
<script language="javascript">
// 城市:把輸入框的值送進伺服器
function cityResult() {
var city = document.getElementById("TextBox1");
WebForm1.GetCityList(city.value, get_city_Result_CallBack);
}
function get_city_Result_CallBack(response) {
if (response.value != null) {
document.getElementById("DropDownList1").style.display = "block";
document.getElementById("DropDownList1").length = 0;
var ds = response.value;
if (ds != null && typeof(ds) == "object" && ds.Tables != null) {
for (var i = 0; i < ds.Tables[0].Rows.length; i++) {
var name = ds.Tables[0].Rows[i].city;
var id = ds.Tables[0].Rows[i].cityID;
document.getElementById("DropDownList1").options.add(new Option(name, id));
}
}
} else {
document.getElementById("DropDownList1").style.display = "none";
}
return;
}
function getData() {
var province = document.getElementById("DropDownList1");
var pindex = province.selectedIndex;
var pText = province.options[pindex].text;
document.getElementById("<%=TextBox1.ClientID%>").innerText = pText;
}
</script>
</head>
<body>
<form id="Form1" method="post" runat="server">
<asp:TextBox ID="TextBox1" runat="server"></asp:TextBox><br>
<asp:DropDownList ID="DropDownList1" runat="server" Width="192px" style="display:none"></asp:DropDownList>
</form>
</body>
</html>




第一,伺服器端要有一個可被腳本呼叫的 GetCityList。 用戶端的 WebForm1.GetCityList(值, 回呼函式) 這種「頁面名稱.方法名稱」呼叫形式,是 ScriptControl/Ajax 化的 Web 服務方法被註冊之後產生的代理。伺服器方法回傳 DataSet,Ajax 執行階段會把它序列化成用戶端可讀的物件,因此 ds.Tables[0].Rows[i] 這條路徑才走得通。
第二,下拉清單的顯示與隱藏要自己管。 DropDownList 預設是 display:none,只有在回呼拿到非空結果時才設成 block,並先將 length 歸零再逐筆 add,否則第二次查詢會把舊選項疊在上面。查無結果時則直接隱藏,避免留一個空框在使用者眼前。
第三,選完之後要把值寫回輸入框。 getData 從下拉清單取出選中項的文字,寫回 TextBox1。這一步很重要——因為下拉清單只是「提示」,真正該被表單送出、被後端讀取的欄位仍然是那個文字方塊。
這個範例的雛形取自 ASP.NET 2.0 早期的 Ajax 模型,若要在今日的環境重現,有幾點值得留意:一是候選資料最好限制筆數,避免一次回傳過量資料拖慢回呼;二是輸入事件建議加上輕量的 debounce,不然每敲一個字就打一輪伺服器,壓力可觀;三是 innerText 已屬舊式寫法,跨瀏覽器時改用 value 或 textContent 會更穩妥。
但核心不變:輸入框負責收集意圖,伺服器方法負責查詢,回呼函式負責把結果翻譯成畫面上的選項。這三者一分開,自動完成就不再神祕。