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, un NotSupportedException se produce.This method is supported only if AllowNew is true; otherwise, a NotSupportedException is thrown.

Implementación de este método significa que la IBindingList lista debe conocer el tipo de objetos que se agregarán a la lista y debe aprender a 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 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 implementan los objetos de esta lista el IEditableObject interfaz, una llamada a la CancelEdit método debería descartar un objeto, no agregue a la lista, cuando se creó el objeto con el AddNew 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 sólo debe agregarse a la lista cuando la IEditableObject.EndEdit se 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 el objeto y la lista detenidamente.Therefore, you must synchronize the object and the list carefully.

Cuando se llama a este método, debe generar un ListChanged evento con el ItemAdded enumeración incluya 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 está en un estado donde presionando Esc en un DataGridView 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. Generar el ListChanged evento con el ItemAdded enumeración una segunda vez en esta fila indica que el elemento es ahora una fila normal (no en el estado nueva).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