Cette page vous a-t-elle été utile ?
Votre avis sur ce contenu est important. N'hésitez pas à nous faire part de vos commentaires.
Vous avez d'autres commentaires ?
1500 caractères restants
Add, méthode
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

ListBox.ObjectCollection.Add, méthode

Ajoute un élément à la liste d'éléments pour ListBox.

Espace de noms :  System.Windows.Forms
Assembly :  System.Windows.Forms (dans System.Windows.Forms.dll)

public int Add(
	Object item
)

Paramètres

item
Type : System.Object
Objet représentant l'élément à ajouter à la collection.

Valeur de retour

Type : System.Int32
Index de base zéro de l'élément dans la collection ; sinon, -1, si BeginUpdate a été appelé.

ExceptionCondition
SystemException

L'espace disponible est insuffisant pour ajouter le nouvel élément à la liste.

ArgumentNullException

item a la valeur null.

Si la propriété Sorted de ListBox a la valeur true, l'élément est inséré dans l'ordre alphabétique dans la liste. Sinon, il est inséré à la fin de la liste. Pour insérer un élément dans la zone de liste à la position spécifiée, utilisez la méthode Insert. Pour ajouter un jeu d'éléments à la zone de liste en une seule opération, utilisez la méthode AddRange. Si vous souhaitez utiliser la méthode Add pour ajouter un grand nombre d'éléments à la liste, utilisez les méthodes BeginUpdate et EndUpdate pour éviter de repeindre ListBox chaque fois qu'un élément est ajouté à la liste tant que tous les éléments n'ont pas été ajoutés à la liste. Quand des éléments sont ajoutés à ListBox, il est plus efficace de trier les éléments dans un premier temps, puis d'ajouter de nouveaux éléments.

Quand un objet est ajouté à la collection, ListBox vérifie d'abord si la propriété DisplayMember de la classe ListControl a le nom d'un membre de l'objet spécifié à référencer quand le texte de l'élément est extrait. Si aucun membre n'est spécifié dans la propriété DisplayMember, ListBox appelle alors la méthode ToString de l'objet pour obtenir le texte à afficher dans la liste.

L'exemple de code suivant illustre la création d'un contrôle ListBox qui affiche plusieurs éléments dans des colonnes et dans lequel plusieurs éléments peuvent être sélectionnés dans la liste. Le code de l'exemple ajoute 50 éléments à ListBox en utilisant la méthode Add de la classe ListBox.ObjectCollection puis sélectionne trois éléments dans la liste avec la méthode SetSelected. Le code affiche ensuite les valeurs de la collection ListBox.SelectedObjectCollection (par l'intermédiaire de la propriété SelectedItems) et de ListBox.SelectedIndexCollection (par l'intermédiaire de la propriété SelectedIndices). Cet exemple requiert que le code se trouve dans et soit appelé à partir de Form.


private void button1_Click(object sender, System.EventArgs e)
{
   // Create an instance of the ListBox.
   ListBox listBox1 = new ListBox();
   // Set the size and location of the ListBox.
   listBox1.Size = new System.Drawing.Size(200, 100);
   listBox1.Location = new System.Drawing.Point(10,10);
   // Add the ListBox to the form.
   this.Controls.Add(listBox1);
   // Set the ListBox to display items in multiple columns.
   listBox1.MultiColumn = true;
   // Set the selection mode to multiple and extended.
   listBox1.SelectionMode = SelectionMode.MultiExtended;

   // Shutdown the painting of the ListBox as items are added.
   listBox1.BeginUpdate();
   // Loop through and add 50 items to the ListBox.
   for (int x = 1; x <= 50; x++)
   {
      listBox1.Items.Add("Item " + x.ToString());
   }
   // Allow the ListBox to repaint and display the new items.
   listBox1.EndUpdate();

   // Select three items from the ListBox.
   listBox1.SetSelected(1, true);
   listBox1.SetSelected(3, true);
   listBox1.SetSelected(5, true);

   // Display the second selected item in the ListBox to the console.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedItems[1].ToString());
   // Display the index of the first selected item in the ListBox.
   System.Diagnostics.Debug.WriteLine(listBox1.SelectedIndices[0].ToString());             
}



.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft