Comment : ajouter des éléments dans des contrôles serveur Web List (Visual Studio)

Mise à jour : novembre 2007

Les informations de cette rubrique s'appliquent aux contrôles serveur Web suivants :

• ListBox

• DropDownList

• CheckBoxList

• RadioButtonList

• BulletedList

Vous pouvez ajouter des éléments à un contrôle serveur Web de liste des trois façons suivantes :

• Ajoutez des éléments statiques au moment du design.

• Ajoutez des éléments par programme au moment de l'exécution.

• Ajoutez des éléments en utilisant la liaison de données. Pour plus d'informations, consultez Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio).

Lorsque vous ajoutez un élément de liste, vous spécifiez jusqu'à trois propriétés possibles de l'élément. Le tableau suivant décrit ces propriétés.

Propriété	Description
Text	Spécifie le texte affiché dans la liste.
Value	Spécifie une valeur qui est associée à un élément mais qui n'est pas affichée. Par exemple, la propriété Text peut avoir pour valeur le nom d'un élément chimique et la propriété Value le symbole de cet élément.
Selected	Indique si l'élément est sélectionné. Dans un contrôle CheckBoxList et dans un contrôle ListBox à sélection multiple, plusieurs éléments peuvent être sélectionnés. Dans un contrôle DropDownList, RadioButtonList et ListBox à sélection unique, un seul élément peut être sélectionné à la fois. Si vous définissez plusieurs éléments sélectionnés dans ces contrôles, le navigateur détermine quel élément apparaît comme sélectionné. Dans un contrôle BulletedList, ce paramètre n'a aucun effet.

Pour ajouter des éléments statiques au moment du design.

1. En mode Design, sélectionnez le contrôle de liste auquel vous souhaitez ajouter des éléments.

   Dans la fenêtre Propriétés, cliquez sur le bouton de sélection () dans la zone Items.

   La boîte de dialogue Éditeur de collections ListItem s'affiche.

2. Cliquez sur Ajouter pour ajouter un nouvel élément.

3. Sélectionnez le nouvel élément puis, dans la grille de propriétés, entrez les valeurs de ses propriétés Text, Value et Selected.

4. Répétez les étapes 2 à 3 pour chaque élément que vous souhaitez ajouter, puis cliquez sur OK.

Pour ajouter des éléments par programme

1. Créez un nouvel objet de type ListItem et définissez ses propriétés Text et Value. En général, vous créez le nouveau ListItem en appelant la méthode Add.

2. Appelez la méthode Add de la collection Items du contrôle et transmettez-lui le nouvel objet.

   L'exemple suivant montre comment ajouter les objets ListItem à un contrôle ListBox, mais la procédure est identique pour tous les contrôles serveur Web de liste.

   Protected Sub Button1_Click(ByVal sender As System.Object, _
           ByVal e As System.EventArgs) Handles Button1.Click
       ListBox1.Items.Add(New ListItem("Carbon", "C"))
       ListBox1.Items.Add(New ListItem("Oxygen", "O"))
   End Sub
   

   Protected void Button1_Click (object sender, System.EventArgs e)
   {
       ListBox1.Items.Add(new ListItem("Carbon", "C"));
       ListBox1.Items.Add(new ListItem("Oxygen", "O"));
   }
   

Voir aussi

Tâches

Comment : remplir des contrôles serveur Web List à partir d'une source de données (Visual Studio)