共用方式為

ListBox Web 伺服器控制項

建立單一選取或多重選取的清單方塊。

<asp:ListBoxid="Listbox1"      DataSource="<% databindingexpression %>"     DataTextField="DataSourceField"     DataValueField="DataSourceField"     AutoPostBack="True|False"     Rows="rowcount"     SelectionMode="Single|Multiple"     OnSelectedIndexChanged="OnSelectedIndexChangedMethod"     runat="server">   <asp:ListItemvalue="value" selected="True|False">      Text   </asp:ListItem></asp:ListBox>

備註

使用 ListBox 控制項建立可以單一或多重項目選取的清單控制項。使用 Rows 屬性可指定控制項的高度。若要啟用多重項目選取，請將 SelectionMode 屬性設定為 ListSelectionMode.Multiple。

若要指定您希望出現在 ListBox 控制項中的項目 (Item)，請將每一項目 (Entry) 的 ListItem 項目 (Element) 置於 ListBox 控制項的開始和結束標記之間。

ListBox 控制項也支援資料繫結。若要將控制項繫結至資料來源，請先建立含有要在控制項中顯示之項目的資料來源，例如 System.Collections.ArrayList。然後，使用 Control.DataBind 方法將資料來源繫結至 ListBox 控制項。使用 DataTextField 和 DataValueField 屬性來指定資料來源中哪個欄位要分別繫結至控制項中每一清單項目的 Text 和 Value 屬性。ListBox 控制項現在將會顯示來自資料來源的資訊。

如果 SelectionMode 屬性是設定為 ListSelectionMode.Multiple，請重複 Items 集合並且測試集合中每一項目的 Selected 屬性，藉以判斷 ListBox 控制項中選取的項目。如果 SelectionMode 屬性是設定為 ListSelectionMode.Single，您可以使用 SelectedIndex 屬性來判斷所選取項目的索引。然後，這個索引就可以用來從 Items 集合擷取這個項目。

如需 ListBox Web 伺服器控制項之屬性和事件的詳細資訊，請參閱 ListBox 類別文件。

範例

下列範例是示範如何使用 ListBox 控制項對使用者顯示預先定義選項的清單。使用者選取的項目會顯示在 Label 控制項中。

<%@ Page Language="VB" AutoEventWireup="True" %>
<html>
<head>
   <script runat="server">
      Sub SubmitBtn_Click(sender As Object, e As EventArgs)
         If ListBox1.SelectedIndex > - 1 Then
            Label1.Text = "You chose: " & ListBox1.SelectedItem.Text
         End If
      End Sub 'SubmitBtn_Click
   </script>
</head>
<body>
   <h3>ListBox Example</h3>
   <p>
   <form runat="server">
      <asp:ListBox id="ListBox1" 
           Rows="6"
           Width="100px"
           SelectionMode="Single" 
           runat="server">
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem>
         <asp:ListItem>Item 5</asp:ListItem>
         <asp:ListItem>Item 6</asp:ListItem>
      </asp:ListBox>
      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
      <p>
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
   </form>
</body>
</html>
[C#]
<%@ Page Language="C#" AutoEventWireup="True" %>
<html>
<head>
   <script runat="server">
      void SubmitBtn_Click(Object sender, EventArgs e) 
      {
         if (ListBox1.SelectedIndex > -1)
            Label1.Text="The first item you chose: " +
                        ListBox1.SelectedItem.Text;
      }
   </script>
</head>
<body>
   <form runat="server">
      <h3>ListBox Example</h3>
      <asp:ListBox id="ListBox1"  
           Rows="4" 
           SelectionMode="Multiple" 
           Width="100px" 
           runat="server">
         <asp:ListItem>Item 1</asp:ListItem>
         <asp:ListItem>Item 2</asp:ListItem>
         <asp:ListItem>Item 3</asp:ListItem>
         <asp:ListItem>Item 4</asp:ListItem> 
         <asp:ListItem>Item 5</asp:ListItem> 
         <asp:ListItem>Item 6</asp:ListItem>
      </asp:ListBox>
      <asp:button id="Button1"
           Text="Submit" 
           OnClick="SubmitBtn_Click" 
           runat="server" />
      <p>
      <asp:Label id="Label1" 
           Font-Name="Verdana" 
           Font-Size="10pt" 
           runat="server"/>
   </form>
</body>
</html>

請參閱

Web 伺服器控制項 | ListBox 類別

  • Last updated on