列表控制元件

Created: November-22, 2018

ASP.NET 提供以下控制元件

下拉選單
列表框
單選按鈕列表
核取方塊列表
專案符號列表

這些控制元件允許使用者從列表中的一個或多個專案中進行選擇。列表框和下拉選單包含一個或多個列表項。這些列表可以通過程式碼或 ListItemCollection 編輯器載入。

列表框控制元件的基本語法：

<asp:ListBox ID="ListBox1" runat="server" AutoPostBack="True"    OnSelectedIndexChanged="ListBox1_SelectedIndexChanged">
</asp:ListBox>

下拉選單控制元件的基本語法：

<asp:DropDownList ID="DropDownList1" runat="server" AutoPostBack="True"   OnSelectedIndexChanged="DropDownList1_SelectedIndexChanged">
</asp:DropDownList>

列表框和下拉選單的常見屬性：

屬性	描述
`Items`	ListItem 物件的集合，表示控制元件中的項。此屬性返回 ListItemCollection 型別的物件。
`Rows`	指定框中顯示的專案數。如果實際列表包含的行數多於顯示的行數，則會新增滾動條。
`SelectedIndex`	當前所選專案的索引。如果選擇了多個專案，則為第一個選定專案的索引。如果未選擇任何項，則此屬性的值為 -1。
`SelectedValue`	當前所選專案的值。如果選擇了多個專案，則為第一個選定專案的值。如果未選擇任何項，則此屬性的值為空字串（“”）。
`SelectionMode`	指示列表框是允許單個選擇還是多個選擇。

每個列表項物件的公共屬性：

屬性	描述
`Text`	顯示該專案的文字。
`Selected`	與項關聯的字串值。
`Value`	指示是否選擇了該專案。

重要的是要注意：

若要使用下拉選單或列表框中的專案，請使用控制元件的 Items 屬性。此屬性返回 ListItemCollection 物件，該物件包含列表的所有項。
當使用者從下拉選單或列表框中選擇其他項時，將引發 SelectedIndexChanged 事件。