Partager via

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

  • Article

Mise à jour : novembre 2007

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

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

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)