IBindingList.AddNew Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un nouvel élément à la liste.
public:
System::Object ^ AddNew();public object AddNew ();public object? AddNew ();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectRetours
Élément ajouté à la liste.
Exceptions
AllowNew a la valeur false.
Remarques
Cette méthode est prise en charge uniquement si AllowNew est 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 doit comprendre comment créer un 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, l’appel IEditableObject 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 portant 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 désormais une ligne normale (pas dans un nouvel état).
