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();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 elle AllowNew est true; sinon, une 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 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.
Note
Si les objets de cette liste implémentent l’interface IEditableObject , l’appel de la CancelEdit méthode doit ignorer un objet, et ne pas 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 l’objet et la liste avec soin.
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ù l’accès à é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).