IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew IBindingList.AddNew Method

Definición

Agrega un nuevo elemento a la lista.Adds a new item to the list.

public:
 System::Object ^ AddNew();
public object AddNew ();
abstract member AddNew : unit -> obj
Public Function AddNew () As Object

Devoluciones

El elemento agregado a la lista.The item added to the list.

Excepciones

Comentarios

Este método solo se admite si AllowNew es true; en caso contrario NotSupportedException , se produce una excepción.This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

La implementación de este método significa IBindingList que la lista debe comprender el tipo de objetos que se van a agregar a la lista y debe comprender cómo crear una nueva instancia de ese tipo.Implementing this method means that the IBindingList list must understand the type of objects to add to the list and must understand how to create a new instance of that type. Por ejemplo, si tiene una colección de myCustomer objetos, el AddNew método debe agregar un nuevo myCustomer objeto a la lista.For example, if you have a collection of myCustomer objects, the AddNew method should add a new myCustomer object to the list.

Nota

Si los objetos de esta lista implementan IEditableObject la interfaz, la CancelEdit llamada al método debe descartar un objeto, no agregarlo a la lista, cuando el objeto AddNew se creó utilizando el método.If the objects in this list implement the IEditableObject interface, calling the CancelEdit method should discard an object, not add it to the list, when the object was created using the AddNew method. El objeto solo se debe agregar a la lista cuando se IEditableObject.EndEdit llama al método.The object should only be added to the list when the IEditableObject.EndEdit method is called. Por lo tanto, debe sincronizar cuidadosamente el objeto y la lista.Therefore, you must synchronize the object and the list carefully.

Cuando se llama a este método, debe generar un ListChanged evento con la ItemAdded enumeración que lleva el índice adecuado.When this method is called, you should raise a ListChanged event with the ItemAdded enumeration carrying the appropriate index. La fila agregada se encuentra en un estado en el que DataGridView presionar ESC en un control puede quitar la nueva fila.The added row is in a state where hitting Esc on a DataGridView control can remove the new row. Al generar ListChanged el evento con ItemAdded la enumeración una segunda vez en esta fila, indica que el elemento es ahora una fila normal (no en el nuevo estado).Raising the ListChanged event with the ItemAdded enumeration a second time on this row indicates that the item is now a normal row (not in new state).

Se aplica a