Sdílet prostřednictvím

HtmlSelect.SelectedIndex Vlastnost

  • Reference

Definice

Obor názvů:
System.Web.UI.HtmlControls
Sestavení:
System.Web.dll

Získá nebo nastaví pořadový index vybrané položky v ovládacím HtmlSelect prvku.

public:
 virtual property int SelectedIndex { int get(); void set(int value); };
[System.ComponentModel.Browsable(false)]
public virtual int SelectedIndex { get; set; }
[<System.ComponentModel.Browsable(false)>]
member this.SelectedIndex : int with get, set
Public Overridable Property SelectedIndex As Integer

Hodnota vlastnosti

Int32

Pořadový index vybrané položky v ovládacím HtmlSelect prvku. Hodnota -1 označuje, že není vybrána žádná položka.

Atributy
BrowsableAttribute

Výjimky

ArgumentOutOfRangeException

Vlastnost byla nastavena na hodnotu větší než počet položek v ovládacím HtmlSelect prvku nebo menší než -1.

Příklady

Následující příklad kódu ukazuje, jak použít SelectedIndex vlastnost k určení indexu vybrané položky v ovládacím HtmlSelect prvku. Index se pak použije k načtení vybrané položky z Items kolekce.


<%@ Page Language="C#" AutoEventWireup="True" %>

<!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" >

<head>
    <title> HtmlSelect Example </title>
<script runat="server">

      void Button_Click (Object sender, EventArgs e)
      {
        
         Label1.Text = "You selected the item with index number " + 
                       Select1.SelectedIndex.ToString() + 
                       " and contains the value " +
                       Select1.Value + ".";

      }

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> HtmlSelect Example </h3>

      Select items from the list: <br /><br />

      <select id="Select1" 
              runat="server">

         <option value="Text for Item 1" selected="selected"> Item 1 </option>
         <option value="Text for Item 2"> Item 2 </option>
         <option value="Text for Item 3"> Item 3 </option>
         <option value="Text for Item 4"> Item 4 </option>
         <option value="Text for Item 5"> Item 5 </option>
         <option value="Text for Item 6"> Item 6 </option>

      </select>

      <br /><br />

      <button id="Button1"
              onserverclick="Button_Click"
              runat="server">

         Submit

      </button>

      <br /><br />

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>

</html>


<%@ Page Language="VB" AutoEventWireup="True" %>

<!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" >

<head>
    <title> HtmlSelect Example </title>
<script runat="server">

      Sub Button_Click (sender As Object, e As EventArgs)
        
         Label1.Text = "You selected the item with index number " & _
                       Select1.SelectedIndex.ToString() & _
                       " and contains the value " & _
                       Select1.Value & "."

      End Sub

   </script>

</head>

<body>

   <form id="form1" runat="server">

      <h3> HtmlSelect Example </h3>

      Select items from the list: <br /><br />

      <select id="Select1" 
              runat="server">

         <option value="Text for Item 1" selected="selected"> Item 1 </option>
         <option value="Text for Item 2"> Item 2 </option>
         <option value="Text for Item 3"> Item 3 </option>
         <option value="Text for Item 4"> Item 4 </option>
         <option value="Text for Item 5"> Item 5 </option>
         <option value="Text for Item 6"> Item 6 </option>

      </select>

      <br /><br />

      <button id="Button1"
              onserverclick="Button_Click"
              runat="server">

         Submit

      </button>

      <br /><br />

      <asp:Label id="Label1"
           runat="server"/>

   </form>

</body>

</html>

Poznámky

Vlastnost SelectedIndex se běžně používá k určení indexu vybrané položky v ovládacím prvku s jedním výběrem HtmlSelect . Tento index se pak dá použít k načtení položky z Items kolekce.

Multiple Pokud je vlastnost nastavena na true, označující, že může být současně vybráno více položek, SelectedIndex vlastnost obsahuje index první vybrané položky. Chcete-li určit vybrané položky z HtmlSelect ovládacího prvku, který umožňuje více souběžných výběrů, iterujte kolekci Items a otestujte ListItem.Selected vlastnost každé položky.

Upozornění

Není možné vybrat žádnou položku. Pokud není vybrána žádná položka, SelectedIndex vlastnost obsahuje hodnotu .-1 K tomu obvykle dochází, když se stránka poprvé načte a položka není ve výchozím nastavení vybraná. Před odkazem na položku v kolekci Items zadejte kód, který tuto hodnotu otestuje. Jinak dojde k výjimce, pokud je index mimo rozsah kolekce.

Ve výchozím nastavení HtmlSelect se ovládací prvek zobrazí jako rozevírací seznam. Pokud povolíte více výběrů (nastavením Multiple vlastnosti na true) nebo určíte výšku větší než jeden řádek (nastavením Size vlastnosti na hodnotu větší než 1), ovládací prvek se zobrazí jako seznam. Pokud se zobrazí rozevírací seznam, je položka vždy vybraná. Pokud se zobrazí seznam, můžete výběr ze všech položek programově vymazat nastavením SelectedIndex vlastnosti na -1.

Platí pro

Viz také