HtmlSelect.SelectedIndex Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene o establece el índice ordinal del elemento seleccionado en un control 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 IntegerValor de propiedad
Índice ordinal del elemento seleccionado en un control HtmlSelect. El valor -1 indica que no hay ningún elemento seleccionado.
- Atributos
Excepciones
La propiedad se ha establecido en un valor mayor que el número de elementos en el control HtmlSelect o menor que -1.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar la SelectedIndex propiedad para determinar el índice del elemento seleccionado en el HtmlSelect control . A continuación, el índice se usa para recuperar el elemento seleccionado de la Items colección.
<%@ 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>
Comentarios
La SelectedIndex propiedad se usa normalmente para determinar el índice del elemento seleccionado en un control de selección HtmlSelect única. A continuación, este índice se puede usar para recuperar el elemento de la Items colección.
Si la Multiple propiedad se establece trueen , que indica que se pueden seleccionar simultáneamente varios elementos, la SelectedIndex propiedad contiene el índice del primer elemento seleccionado. Para determinar los elementos seleccionados de un HtmlSelect control que permite varias selecciones simultáneas, recorra en iteración la Items colección y pruebe la ListItem.Selected propiedad de cada elemento.
Precaución
No se puede seleccionar ningún elemento. Si no se selecciona ningún elemento, la SelectedIndex propiedad contiene un valor de -1. Esto suele ocurrir cuando la página se carga por primera vez y un elemento no está seleccionado de forma predeterminada. Proporcione código para probar este valor antes de hacer referencia al elemento de la Items colección. De lo contrario, se produce una excepción si el índice está fuera del intervalo de la colección.
De forma predeterminada, el HtmlSelect control se muestra como un cuadro de lista desplegable. Si permite varias selecciones (estableciendo la Multiple propiedad trueen ) o especifica un alto mayor que una fila (estableciendo la Size propiedad en un valor mayor que 1), el control se muestra como un cuadro de lista. Si se muestra un cuadro de lista desplegable, siempre se selecciona un elemento. Si se muestra un cuadro de lista, puede borrar mediante programación la selección de todos los elementos estableciendo la SelectedIndex propiedad -1en .
