HtmlSelect.SelectedIndex Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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, setPublic Overridable Property SelectedIndex As IntegerValore della proprietà
Indice ordinale dell'elemento selezionato in un controllo HtmlSelect. Un valore pari a -1 indica che non è selezionato alcun elemento.
- Attributi
Eccezioni
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.
