IBindingList.AddNew Método

Definición

Espacio de nombres:

System.ComponentModel

Ensamblado:

System.ComponentModel.TypeConverter.dll

Agrega un nuevo elemento a la lista.

public:
 System::Object ^ AddNew();

public object? AddNew ();

abstract member AddNew : unit -> obj

Public Function AddNew () As Object

Devoluciones

Object

El elemento agregado a la lista.

Excepciones

NotSupportedException

AllowNew es false.

Comentarios

Este método solo se admite si AllowNew es true; de lo contrario, se produce una NotSupportedException excepción .

La implementación de este método significa que la IBindingList 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. Por ejemplo, si tiene una colección de myCustomer objetos , el AddNew método debe agregar un nuevo myCustomer objeto a la lista.

Nota

Si los objetos de esta lista implementan la IEditableObject interfaz , al llamar al CancelEdit método se debe descartar un objeto, no agregarlo a la lista, cuando se creó el objeto mediante el AddNew método . El objeto solo se debe agregar a la lista cuando se llama al IEditableObject.EndEdit método . Por lo tanto, debe sincronizar cuidadosamente el objeto y la lista.

Cuando se llama a este método, debe generar un ListChanged evento con la ItemAdded enumeración que lleva el índice adecuado. La fila agregada está en un estado en el que presionar Esc en un DataGridView control puede quitar la nueva fila. Generar el ListChanged evento con la ItemAdded enumeración una segunda vez en esta fila indica que el elemento es ahora una fila normal (no en estado nuevo).