IBindingList.AddNew Méthode

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Ajoute un nouvel élément à la liste.

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Retours

Object

Élément ajouté à la liste.

Exceptions

NotSupportedException

AllowNew a la valeur false.

Remarques

Cette méthode est prise en charge uniquement si AllowNew a la valeur true; sinon, un NotSupportedException est levée.

L’implémentation de cette méthode signifie que la IBindingList liste doit comprendre le type d’objets à ajouter à la liste et comprendre comment créer une nouvelle instance de ce type. Par exemple, si vous avez une collection d’objets myCustomer , la AddNew méthode doit ajouter un nouvel myCustomer objet à la liste.

Notes

Si les objets de cette liste implémentent l’interface IEditableObject , l’appel de la CancelEdit méthode doit ignorer un objet, et non l’ajouter à la liste, lorsque l’objet a été créé à l’aide de la AddNew méthode . L’objet ne doit être ajouté à la liste que lorsque la IEditableObject.EndEdit méthode est appelée. Par conséquent, vous devez synchroniser soigneusement l’objet et la liste.

Lorsque cette méthode est appelée, vous devez déclencher un ListChanged événement avec l’énumération ItemAdded contenant l’index approprié. La ligne ajoutée est dans un état où le fait d’appuyer sur Échap sur un DataGridView contrôle peut supprimer la nouvelle ligne. Le déclenchement de l’événement ListChanged avec l’énumération ItemAdded une deuxième fois sur cette ligne indique que l’élément est maintenant une ligne normale (pas dans un nouvel état).