ComboBox.ObjectCollection.Add(Object) Méthode

Définition

Ajoute un élément à la liste d'éléments pour ComboBox.Adds an item to the list of items for a ComboBox.

public:
 int Add(System::Object ^ item);
public int Add (object item);
member this.Add : obj -> int
Public Function Add (item As Object) As Integer

Paramètres

item
Object

Objet représentant l'élément à ajouter à la collection.An object representing the item to add to the collection.

Retours

Index de base zéro de l'élément dans la collection.The zero-based index of the item in the collection.

Implémente

Exceptions

La valeur du paramètre item était null.The item parameter was null.

Remarques

Cette méthode ajoute un élément à la zone de liste déroulante.This method adds an item to the combo box. Si la propriété Sorted du ComboBox a la valeur true, l’élément est inséré dans la liste par ordre alphabétique.If the Sorted property of the ComboBox is set to true, the item is inserted into the list alphabetically. Dans le cas contraire, l’élément est inséré à la fin de la liste.Otherwise, the item is inserted at the end of the list.

Une représentation visuelle de l’élément est affichée dans la zone de liste déroulante.A visual representation of the item is displayed in the combo box. Cette représentation de contenu est spécifiée par la propriété DisplayMember.This content representation is specified by the DisplayMember property. Si la propriété DisplayMember est null, la méthode ToString de l’élément est appelée pour obtenir la chaîne affichée dans la zone de liste déroulante. Sinon, la propriété de l’objet stocké tel que spécifié par la propriété DisplayMember est affichée.If the DisplayMember property is null, the item's ToString method is called to obtain the string that is displayed in the combo box; otherwise, the property of the stored object as specified by the DisplayMember property is displayed. Une SystemException se produit si l’espace disponible est insuffisant pour stocker le nouvel élément.A SystemException occurs if there is insufficient space available to store the new item. Pour ajouter un ensemble d’éléments à la zone de liste déroulante, il est préférable d’utiliser la méthode AddRange.To add a set of items to the combo box it is best to use the AddRange method. Si vous choisissez d’utiliser la méthode Add pour ajouter un certain nombre d’éléments à la zone de liste déroulante, utilisez la méthode BeginUpdate pour interrompre la redessination pendant votre ajout et la méthode EndUpdate pour reprendre la redessination.If you choose to use the Add method to add a number of items to the combo box, use the BeginUpdate method to suspend repainting during your add and the EndUpdate method to resume repainting. Vous pouvez utiliser la méthode Insert pour spécifier l’emplacement dans la liste où un élément est ajouté.You can use the Insert method to specify the location in the list where an item is added. Lorsqu’un objet est ajouté à la collection, le ComboBox appelle la méthode ToString de l’objet pour obtenir la chaîne à afficher dans la liste.When an object is added to the collection, the ComboBox calls the object's ToString method to obtain the string to display in the list.

S’applique à

Voir aussi