IBindingList.AddNew (Método)

Object AddNew ()

Object AddNew ()

function AddNew () : Object

Valor devuelto

Este método es compatible únicamente si AllowNew está establecido en true; en caso contrario, se produce una excepción NotSupportedException.

La implementación de este método significa que la lista IBindingList debe entender el tipo de objetos que se van a agregar a la lista y debe saber cómo crear una nueva instancia de ese tipo. Por ejemplo, si dispone de una colección de objetos myCustomer, el método AddNew debería agregar un nuevo objeto myCustomer a la lista.

Nota
Si los objetos en la lista implementan la interfaz IEditableObject, al llamar al método CancelEdit se deberá descartar un objeto y no agregarlo a la lista cuando se crea el objeto mediante el método AddNew. El objeto debe agregarse a la lista únicamente cuando se llama al método IEditableObject.EndEdit. Por tanto, es preciso sincronizar minuciosamente el objeto y la lista.

Cuando llame a este método, deberá provocar un evento ListChanged con la enumeración ItemAdded que incluya el índice adecuado. La fila agregada se encuentra en un estado en el que, presionando Esc en un control DataGridView, es posible quitar dicha fila nueva. El hecho de provocar por segunda vez el evento ListChanged con la enumeración ItemAdded en esta fila indica que el elemento es, en estos momentos, una fila normal (que no se encuentra en el estado "nuevo").

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

.NET Compact Framework