HtmlSelect.SelectedIndex Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o índice ordinal do item selecionado no controle 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 da propriedade
O índice ordinal do item selecionado em um controle HtmlSelect. Um valor de -1 indica que nenhum item está selecionado.
- Atributos
Exceções
A propriedade foi definida com um valor maior que o número de itens no controle HtmlSelect ou menor que -1.
Exemplos
O exemplo de código a HtmlSelect seguir demonstra como usar a SelectedIndex propriedade para determinar o índice do item selecionado no controle. Em seguida, o índice é usado para recuperar o item selecionado da Items coleção.
<%@ 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>
Comentários
A SelectedIndex propriedade é comumente usada para determinar o índice do item selecionado em um controle de seleção HtmlSelect única. Esse índice pode ser usado para recuperar o item da Items coleção.
Se a Multiple propriedade estiver definida como true, indicando que vários itens podem ser selecionados simultaneamente, a SelectedIndex propriedade conterá o índice do primeiro item selecionado. Para determinar os itens selecionados de um HtmlSelect controle que permite várias seleções simultâneas, iterar por meio da Items coleção e testar a ListItem.Selected propriedade de cada item.
Cuidado
É possível não ter nenhum item selecionado. Se nenhum item for selecionado, a SelectedIndex propriedade conterá um valor de -1. Isso geralmente ocorre quando a página é carregada pela primeira vez e um item não é selecionado por padrão. Forneça código para testar esse valor antes de referenciar o item na Items coleção. Caso contrário, uma exceção será gerada se o índice estiver fora do intervalo da coleção.
Por padrão, o HtmlSelect controle é exibido como uma caixa de listagem suspensa. Se você permitir várias seleções (definindo a Multiple propriedade como true) ou especificar uma altura maior que uma linha (definindo a Size propriedade como um valor maior que 1), o controle será exibido como uma caixa de listagem. Se uma caixa de listagem suspensa for exibida, um item será sempre selecionado. Se uma caixa de listagem for exibida, você poderá desmarcar programaticamente a seleção de todos os itens definindo a SelectedIndex propriedade como -1.