Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

ListControl.SelectedIndex Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Web.UI.WebControls
Zestaw:
System.Web.dll

Pobiera lub ustawia najniższy indeks porządkowy wybranych elementów na liście.

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
public virtual int SelectedIndex { get; set; }
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.Browsable(false)]
[System.Web.UI.Themeable(false)]
public virtual int SelectedIndex { get; set; }

Wartość właściwości

Int32

Najniższy indeks porządkowy wybranych elementów na liście. Wartość domyślna to -1, która wskazuje, że nic nie jest zaznaczone.

Atrybuty
BindableAttribute BrowsableAttribute ThemeableAttribute

Wyjątki

ArgumentOutOfRangeException

Indeks został ustawiony na wartość mniejszą niż -1 lub większą lub równą liczbie elementów na liście w momencie renderowania listy.

Przykłady

W poniższym przykładzie pokazano, jak użyć SelectedIndex metody określania najniższego indeksu wybranych elementów w elemecie CheckBoxList.

<%@ Page Language="C#" AutoEventWireup="True" %>
<%@ Import Namespace="System.Data" %>
 
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
 <script language="c#" runat="server">
 
    ICollection CreateDataSource() {
       DataTable dt = new DataTable();
       DataRow dr;
 
       dt.Columns.Add(new DataColumn("IntegerValue", typeof(Int32)));
       dt.Columns.Add(new DataColumn("StringValue", typeof(string)));
       dt.Columns.Add(new DataColumn("DateTimeValue", typeof(DateTime)));
       dt.Columns.Add(new DataColumn("BoolValue", typeof(bool)));
       dt.Columns.Add(new DataColumn("CurrencyValue", typeof(double)));
 
       for (int i = 0; i < 9; i++) {
          dr = dt.NewRow();
 
          dr[0] = i;
          dr[1] = "Item " + i.ToString();
          dr[2] = DateTime.Now;
          dr[3] = (i % 2 != 0) ? true : false;
          dr[4] = 1.23 * (i+1);
 
          dt.Rows.Add(dr);
       }
 
       DataView dv = new DataView(dt);
       return dv;
    }
 
    void Page_Load(Object sender, EventArgs e) {
       if (!IsPostBack) {
          CheckBoxList1.DataSource = CreateDataSource();
          CheckBoxList1.DataTextField="StringValue";
          CheckBoxList1.DataValueField="CurrencyValue";
          CheckBoxList1.DataBind();
       }
    }
 
    void Index_Changed(Object sender, EventArgs e) {
 
       Label1.Text = "The index of the first item selected is: " + 
                     CheckBoxList1.SelectedIndex.ToString(); 
 
    }
 
 </script>
 
 <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
 
    <form id="form1" runat="server">
 
       <asp:CheckBoxList id="CheckBoxList1" 
            OnSelectedIndexChanged="Index_Changed"
            AutoPostBack="true"
            runat="server"/>
 
       <br />
 
       <asp:Label id="Label1" runat="server"/>
 
    </form>
 
 </body>
 </html>

Uwagi

Użyj tej właściwości, aby określić indeks aktualnie wybranego elementu na liście, jeśli kontrolka listy zezwala tylko na jeden wybór. Jeśli kontrolka listy obsługuje wiele wyborów, użyj tej właściwości, aby określić najniższy indeks wybranych elementów.

Wartość SelectedIndex właściwości nie jest specjalnie zapisana podczas wycofywania. Jest przywracany po powrocie zwrotnym SelectedValue przy użyciu właściwości . Jeśli na przykład SelectedValue właściwość ma wartość 4, po powrocie zwrotnym SelectedIndex właściwość jest ustawiona na indeks ListItem obiektu, który ma Value właściwość 4. Jeśli więcej niż jeden ListItem obiekt ma Value właściwość 4, zostanie wybrany pierwszy element w Items kolekcji.

Nie można ustawić tej właściwości według motywów ani motywów arkusza stylów. Aby uzyskać więcej informacji, zobacz ThemeableAttributei ASP.NET Motywy i skóry.

Dotyczy

Produkt Wersje
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Zobacz też