在 Web 開發裡,把資料源的動態資料載入列表控制項是家常便飯。在傳統 ASP 時代這件事相對棘手:你得查資料庫、取回 Recordset,然後在組 HTML 標籤的過程中再一次手動遍歷它。
到了 ASP.NET,同樣的事有了更好的做法,而且資料來源不再只能是資料庫——XML 檔也是選項之一。哪個比較好?這牽涉效能、彈性、可靠度、設定難易與安全性,本文不打算深入。本文要談的是幾種把 XML 綁進列表控制項的做法。
範例以 ListBox 為主角,但這些技巧可以直接套到所有繼承自 System.Web.UI.WebControls.ListControl 的控制項上,包括 CheckBoxList、DropDownList 與 RadioButtonList。
最直覺的方式是用 HTML 直接寫死選項:
<select size="1" id="lstPizzaTopping"> <option value="supreme">Supreme</option> <option value="italianclassic">Italian Classic</option> <option value="meatlover">Meat Lover</option> </select>
這是最簡單、成本最低的做法,代價是幾乎沒有調整行為的餘地。在 ASP.NET 中改用伺服器控制項,就能拿到同樣的結果,同時獲得對行為與屬性更多的掌控:
<asp:listbox rows="1" id="lstPizzaTopping" runat="server"> <asp:listitem value="supreme">Supreme</asp:listitem> <asp:listitem value="italianclassic">Italian Classic</asp:listitem> <asp:listitem value="meatlover">Meat Lover</asp:listitem> </asp:listbox>
也可以改在程式碼裡組。除了把項目硬寫進控制項,你同樣能用 ListItem 物件產生項目再加進去。ListItem 有兩個參數:顯示文字與值;若省略第二個參數,值就等於文字。
<script runat="server">
Sub Page_Load(src As Object, e As EventArgs)
lstPizzaTopping.Items.Add(New ListItem("Supreme", "supreme"))
lstPizzaTopping.Items.Add(New ListItem("Italian Classic", "italianclassic"))
lstPizzaTopping.Items.Add(New ListItem("Meat Lover", "meatlover"))
End Sub
</script>
...
<asp:listbox rows="1" id="lstPizzaTopping" runat="server" />
ASP.NET 允許你把列表控制項的內容綁到一個物件上——那可以是陣列、集合、資料庫,甚至一個 XML 檔。先看最單純的陣列版本:
<script runat="server">
Sub Page_Load(src As Object, e As EventArgs)
Dim arrPizzaTopping As String() = _
{ "Supreme", "Italian Classic", "Meat Lover" }
lstPizzaTopping.DataSource = arrPizzaTopping
lstPizzaTopping.DataBind()
End Sub
</script>
...
<asp:listbox rows="1" id="lstPizzaTopping" runat="server" />
如果現在往陣列裡塞一個新元素,列表會自己更新嗎?不會,除非你再呼叫一次 DataBind。這套機制的好處是:什麼時候、在哪裡更新列表,主控權完全在你手上。
換成 ArrayList 也一樣。它與 VB 的陣列相似但更強,能承載更複雜的資料型別;本質上它是一個集合,所以新增項目時呼叫 Add 並傳入物件即可:
<script runat="server">
Sub Page_Load(src As Object, e As EventArgs)
Dim arrPizzaTopping As New ArrayList()
arrPizzaTopping.Add("Supreme")
arrPizzaTopping.Add("Italian Classic")
arrPizzaTopping.Add("Meat Lover")
lstPizzaTopping.DataSource = arrPizzaTopping
lstPizzaTopping.DataBind()
End Sub
</script>
...
<asp:listbox rows="1" id="lstPizzaTopping" runat="server" />
資料綁定的意義,是把邏輯與使用者介面(HTML)分開。但上面這些做法綁的都是靜態資料——資料被硬寫在我們自己的 .aspx 檔裡。如果資料是動態的呢?如果想在多個頁面之間共用同一份列表內容呢?這時就得靠外部資料來源,最典型的就是把清單存在資料庫的資料表中。相關討論很多,例如 Scott Mitchell 就有專文談如何用 Access 資料庫為列表控制項綁定資料。
談夠資料庫了,換個方式:XML 檔。
XML 檔是純文字檔,用記事本就能開、能改。以下這份 XML 有兩個區塊,註解標得很清楚:前半是 pizza topping 清單,後半是 pizza crust 清單。每個區塊下有多個項目,每個項目又各有 <value> 與 <desc> 兩個元素。這只是範例,元素名稱與內容完全由你定義。
<?xml version="1.0" standalone="yes" ?> <lookup> <!-- START OF: Topping --> <topping> <value>supreme</value> <desc>Supreme</desc> </topping> <topping> <value>italianclassic</value> <desc>Italian Classic</desc> </topping> <topping> <value>meatlover</value> <desc>Meat Lover</desc> </topping> <!-- END OF: Topping --> <!-- START OF: Crust --> <crust> <value>original</value> <desc>Original Crust</desc> </crust> <crust> <value>handstretched</value> <desc>Hand-Stretched Crust</desc> </crust> <crust> <value>pan</value> <desc>Pan Crust</desc> </crust> <!-- END OF: Crust --> </lookup>
現在開始變魔術。這份 XML 本身沒什麼特別,除非你把它載入 ADO.NET 的 DataSet。ADO.NET 對 XML 的支援很強,能直接在 XML 檔上推導出關聯式結構:以上面這份檔案為例,ADO.NET 會自動建立一個名為 lookup 的 DataSet,裡頭含兩張表——topping 與 crust。topping 表有 value 與 desc 兩欄、三列;crust 表同樣兩欄三列。ADO.NET 是依據檔案的「結構描述」來讀取並建構這些表的。
載入只要兩行。第一行建立 DataSet 執行個體,第二行呼叫 ReadXml 並傳入 XML 檔的完整路徑;我們用 Server.MapPath 把虛擬路徑轉成實體路徑:
Dim myDataSet As DataSet = New DataSet
myDataSet.ReadXml(Server.MapPath("lookup.xml"))
把表綁到列表控制項很簡單:設定 DataSource 與 DataMember 指向特定的表,再呼叫 DataBind。另外別忘了設定 DataTextField 與 DataValueField——ASP.NET 不會替你判斷哪一欄該當值、哪一欄該當文字,這件事得自己講清楚。
<script runat="server">
Sub Page_Load(src As Object, e As EventArgs)
...
lstPizzaTopping.DataSource = myDataSet
lstPizzaTopping.DataMember = "topping"
lstPizzaTopping.DataBind()
End Sub
</script>
...
<asp:listbox rows="1"
id="lstPizzaTopping"
datatextfield="desc"
datavaluefield="value"
runat="server" />
有時你希望項目依序排列。做法是取用資料表的預設檢視(DataView),設定它的 Sort 屬性,再把檢視本身當成資料來源:
Dim myDataView As DataView = myDataSet.Tables("topping").DefaultView
myDataView.Sort = "desc ASC"
lstPizzaTopping.DataSource = myDataView
lstPizzaTopping.DataBind()
第一行取得 topping 表的預設檢視,第二行指定依 desc 欄升冪排序,接著把列表的 DataSource 指向這個檢視並執行綁定,內容就照新順序重排了。
資料綁定是有成本的操作,所以只在需要時才做。何時需要?清單內容是動態產生的時候,以及刻意要在多個頁面之間共用同一份清單、以便日後只需改一處的時候。若不符合這兩個條件,為了避免不必要的開銷,直接硬編碼反而更划算。
排序同樣要花資源。如果你希望清單永遠以固定順序呈現,與其在執行期排序,不如直接把 XML 檔按正確順序寫好。
本文從最直覺的硬編碼談起,接著示範以陣列與 ArrayList 綁定資料,最後用 XML 檔搭配 ADO.NET 的 DataSet 完成綁定與排序。以 XML 綁定資料,是資料庫之外值得考慮的一條路:實作容易,也能省下企業級 SQL 資料庫的高額成本。