HtmlSelect.SelectedIndex Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.HtmlControls
Assembly:
System.Web.dll

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, set
Public Overridable Property SelectedIndex As Integer

Valeur de propriété

Int32

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
BrowsableAttribute

Exceptions

ArgumentOutOfRangeException

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 .

S’applique à

Voir aussi