Udostępnij za pośrednictwem

HtmlSelect.SelectedIndex Właściwość

  • Odwołanie

Definicja

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

Pobiera lub ustawia indeks porządkowy wybranego elementu w kontrolce HtmlSelect .

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

Wartość właściwości

Int32

Indeks porządkowy wybranego elementu w kontrolce HtmlSelect . Wartość oznacza -1 , że nie wybrano żadnego elementu.

Atrybuty
BrowsableAttribute

Wyjątki

ArgumentOutOfRangeException

Właściwość została ustawiona na wartość większą niż liczba elementów w kontrolce HtmlSelect lub mniejsza niż -1.

Przykłady

W poniższym przykładzie kodu pokazano, jak za pomocą SelectedIndex właściwości określić indeks wybranego elementu w kontrolce HtmlSelect . Następnie indeks jest używany do pobierania wybranego elementu z kolekcji Items .


<%@ 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>

Uwagi

Właściwość SelectedIndex jest często używana do określania indeksu wybranego elementu w kontrolce pojedynczego wyboru HtmlSelect . Za pomocą tego indeksu można pobrać element z kolekcji Items .

Jeśli właściwość jest ustawiona Multiple na truewartość , wskazując, że można jednocześnie wybrać wiele elementów, SelectedIndex właściwość zawiera indeks pierwszego wybranego elementu. Aby określić wybrane elementy z HtmlSelect kontrolki, która zezwala na wiele równoczesnych wyborów, iteruj po Items kolekcji i przetestuj ListItem.Selected właściwość każdego elementu.

Przestroga

Nie można wybrać żadnego elementu. Jeśli żaden element nie jest zaznaczony, SelectedIndex właściwość zawiera wartość -1. Dzieje się tak często, gdy strona jest ładowana jako pierwsza, a element nie jest domyślnie zaznaczony. Podaj kod, aby przetestować tę wartość przed odwołaniem się do elementu w kolekcji Items . W przeciwnym razie zgłaszany jest wyjątek, jeśli indeks jest poza zakresem kolekcji.

Domyślnie kontrolka HtmlSelect jest wyświetlana jako pole listy rozwijanej. Jeśli zezwalasz na wiele wyborów (przez ustawienie Multiple właściwości na true) lub określ wysokość większą niż jeden wiersz (ustawiając Size właściwość na wartość większą niż 1), kontrolka jest wyświetlana jako pole listy. Jeśli zostanie wyświetlone pole listy rozwijanej, zawsze jest zaznaczony element. Jeśli zostanie wyświetlone pole listy, można programowo wyczyścić zaznaczenie ze wszystkich elementów, ustawiając SelectedIndex właściwość na -1.

Dotyczy

Zobacz też