IBindingList.AddNew Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Agrega un nuevo elemento a la lista.
public:
System::Object ^ AddNew();public object AddNew ();public object? AddNew ();abstract member AddNew : unit -> objPublic Function AddNew () As ObjectDevoluciones
El elemento agregado a la lista.
Excepciones
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).
