HtmlSelect.SelectedIndex Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o índice ordinal do item selecionado num HtmlSelect controlo.
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 Propriedade
O índice ordinal do item selecionado num HtmlSelect controlo. Um valor de -1 indica que nenhum item é selecionado.
- Atributos
Exceções
A propriedade foi definida para um valor superior ao número de itens no HtmlSelect controlo ou menor que -1.
Exemplos
O exemplo de código seguinte demonstra como usar a SelectedIndex propriedade para determinar o índice do item selecionado no HtmlSelect controlo. O índice é então 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>
Observações
A SelectedIndex propriedade é comumente usada para determinar o índice do item selecionado num controlo de seleção HtmlSelect única. Este índice pode então ser usado para recuperar o item da Items coleção.
Se a Multiple propriedade for definida para true, indicando que múltiplos itens podem ser selecionados simultaneamente, a SelectedIndex propriedade contém o índice do primeiro item selecionado. Para determinar os itens selecionados a partir de um HtmlSelect controlo que permite múltiplas seleções simultâneas, itere pela Items coleção e teste a ListItem.Selected propriedade de cada item.
Caution
É possível não ter nenhum item selecionado. Se nenhum item for selecionado, a SelectedIndex propriedade contém um valor de -1. Isto ocorre frequentemente quando a página carrega pela primeira vez e um item não é selecionado por defeito. Forneça código para testar este valor antes de referenciar o item da Items coleção. Caso contrário, é lançada uma exceção se o índice estiver fora do intervalo da coleção.
Por defeito, o HtmlSelect controlo é apresentado como uma caixa de lista suspensa. Se permitir múltiplas seleções (definindo a Multiple propriedade para true) ou especificar uma altura superior a uma linha (definindo a Size propriedade para um valor superior a 1), o controlo é apresentado como uma caixa de lista. Se for exibida uma caixa de lista suspensa, um item é sempre selecionado. Se uma caixa de lista for exibida, pode apagar programaticamente a seleção de todos os itens definindo a SelectedIndex propriedade para -1.