HtmlSelect.SelectedIndex Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit l'index ordinal de l'élément sélectionné dans un contrôle 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 IntegerValeur de propriété
Index ordinal de l'élément sélectionné dans un contrôle HtmlSelect. La valeur -1 indique qu'aucun élément n'est sélectionné.
- Attributs
Exceptions
La propriété a une valeur supérieure au nombre d'éléments contenus dans le contrôle HtmlSelect ou inférieure à -1.
Exemples
L’exemple de code suivant montre comment utiliser la SelectedIndex propriété pour déterminer l’index de l’élément sélectionné dans le HtmlSelect contrôle. L’index est ensuite utilisé pour récupérer l’élément sélectionné de la Items collection.
<%@ 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>
Remarques
La SelectedIndex propriété est couramment utilisée pour déterminer l’index de l’élément sélectionné dans un contrôle de sélection HtmlSelect unique. Cet index peut ensuite être utilisé pour récupérer l’élément de la Items collection.
Si la Multiple propriété est définie truesur , indiquant que plusieurs éléments peuvent être sélectionnés simultanément, la SelectedIndex propriété contient l’index du premier élément sélectionné. Pour déterminer les éléments sélectionnés à partir d’un HtmlSelect contrôle qui autorise plusieurs sélections simultanées, effectuez une itération dans la Items collection et testez la ListItem.Selected propriété de chaque élément.
Attention
Il est possible d’avoir aucun élément sélectionné. Si aucun élément n’est sélectionné, la SelectedIndex propriété contient la valeur -1. Cela se produit généralement lorsque la page se charge pour la première fois et qu’un élément n’est pas sélectionné par défaut. Fournissez du code pour tester cette valeur avant de référencer l’élément dans la Items collection. Sinon, une exception est levée si l’index est hors de la plage de la collection.
Par défaut, le HtmlSelect contrôle s’affiche sous la forme d’une zone de liste déroulante. Si vous autorisez plusieurs sélections (en définissant la Multiple propriété truesur ) ou spécifiez une hauteur supérieure à une ligne (en définissant la Size propriété sur une valeur supérieure 1à ), le contrôle s’affiche sous la forme d’une zone de liste. Si une zone de liste déroulante s’affiche, un élément est toujours sélectionné. Si une zone de liste s’affiche, vous pouvez effacer par programmation la sélection de tous les éléments en définissant la SelectedIndex propriété -1sur .