HtmlSelect.SelectedIndex Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

Ottiene o imposta l’indice ordinale dell'elemento selezionato in un controllo 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

Valore della proprietà

Int32

Indice ordinale dell'elemento selezionato in un controllo HtmlSelect. Un valore pari a -1 indica che non è selezionato alcun elemento.

Attributi
BrowsableAttribute

Eccezioni

ArgumentOutOfRangeException

La proprietà è stata impostata su un valore maggiore del numero di elementi presenti nel controllo HtmlSelect o minore di -1.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare la SelectedIndex proprietà per determinare l'indice dell'elemento selezionato nel HtmlSelect controllo . L'indice viene quindi utilizzato per recuperare l'elemento selezionato dalla Items raccolta.


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

Commenti

La SelectedIndex proprietà viene comunemente utilizzata per determinare l'indice dell'elemento selezionato in un controllo a selezione HtmlSelect singola. Questo indice può quindi essere utilizzato per recuperare l'elemento dalla Items raccolta.

Se la Multiple proprietà è impostata su true, a indicare che è possibile selezionare simultaneamente più elementi, la SelectedIndex proprietà contiene l'indice del primo elemento selezionato. Per determinare gli elementi selezionati da un HtmlSelect controllo che consente più selezioni simultanee, scorrere la Items raccolta e testare la ListItem.Selected proprietà di ogni elemento.

Attenzione

Non è possibile selezionare alcun elemento. Se non è selezionato alcun elemento, la SelectedIndex proprietà contiene un valore .-1 Ciò si verifica in genere quando la pagina viene caricata per la prima volta e un elemento non è selezionato per impostazione predefinita. Specificare il codice per testare questo valore prima di fare riferimento all'elemento nella Items raccolta. In caso contrario, viene generata un'eccezione se l'indice non è compreso nell'intervallo della raccolta.

Per impostazione predefinita, il HtmlSelect controllo viene visualizzato come casella di riepilogo a discesa. Se si consentono più selezioni (impostando la Multiple proprietà su true) o specificando un'altezza maggiore di una riga (impostando la Size proprietà su un valore maggiore di 1), il controllo viene visualizzato come casella di riepilogo. Se viene visualizzata una casella di riepilogo a discesa, viene sempre selezionato un elemento. Se viene visualizzata una casella di riepilogo, è possibile cancellare la selezione a livello di codice da tutti gli elementi impostando la SelectedIndex proprietà su -1.

Si applica a

Vedi anche