Compartir a través de


Utilizar la fila de nuevos registros en el control DataGridView de formularios Windows Forms

Actualización: noviembre 2007

Cuando utilice un control DataGridView para modificar datos en la aplicación, con frecuencia deseará ofrecer a los usuarios la posibilidad de agregar nuevas filas de datos al almacén de datos. El control DataGridView admite esta funcionalidad proporcionando una fila para nuevos registros, que siempre se muestra como última fila. Se marca con un símbolo del asterisco (*) en su encabezado de fila. En las secciones siguientes se explica todo lo que hay que tener en cuenta cuando se programa con la fila para nuevos registros habilitada.

Mostrar la fila para los nuevos registros

Utilice la propiedad AllowUserToAddRows para indicar si se muestra la fila para los nuevos registros. El valor predeterminado de esta propiedad es true.

En el caso de enlaces a datos, se mostrará la fila para los nuevos registros si la propiedad AllowUserToAddRows del control y la propiedad IBindingList.AllowNew del origen de datos son ambos true. Si alguno es false, no se mostrará la fila.

Rellenar la fila para los nuevos registros con datos predeterminados

Cuando el usuario selecciona la fila para los nuevos registros como la fila actual, el control DataGridView provoca el evento DefaultValuesNeeded.

Este evento proporciona acceso al nuevo control DataGridViewRow y le permite rellenar la nueva fila con datos predeterminados. Para obtener más información, vea Cómo: Especificar valores predeterminados para nuevas filas en el control DataGridView de formularios Windows Forms

La colección de filas

La fila para los nuevos registros se encuentra en la colección Rows del control DataGridView pero se comporta de manera diferente en dos aspectos:

  • La fila para los nuevos registros no se puede quitar mediante programación de la colección Rows. Se produce una InvalidOperationException si se intenta. El usuario tampoco puede eliminar la fila para los nuevos registros. El método DataGridViewRowCollection.Clear no quita esta fila de la colección Rows.

  • No se puede agregar ninguna fila después de la fila para los nuevos registros. Se produce una InvalidOperationException si se intenta. Como resultado, la fila para los nuevos registros siempre es la última fila en el control DataGridView. Los métodos en DataGridViewRowCollection que agregan filas son: Add, AddCopy y AddCopies. Todos ellos llaman internamente a métodos de inserción cuando está presente la fila para los nuevos registros.

Personalización visual de la fila para los nuevos registros

Cuando se crea la fila para los nuevos registros, se basa en la fila especificada por la propiedad RowTemplate. Los estilos de celda que no se hayan especificado para esta fila se heredan de otras propiedades. Para obtener más información sobre herencia de estilos de celda, vea Estilos de celda en el control DataGridView de formularios Windows Forms.

Los valores iniciales mostrados por las celdas en la fila para los nuevos registros se recuperan de la propiedad DefaultNewRowValue de cada celda. Para las celdas de tipo DataGridViewImageCell, esta propiedad devuelve una imagen del marcador de posición. En caso contrario, esta propiedad devuelve null. Puede reemplazar esta propiedad para devolver un valor personalizado. Sin embargo, el controlador de eventos DefaultValuesNeeded puede reemplazar a estos valores iniciales cuando el foco escribe la fila para los nuevos registros.

No se exponen públicamente los iconos estándar para el encabezado de esta fila, que son una flecha o un asterisco. Si desea personalizar los iconos, necesitará crear una clase DataGridViewRowHeaderCell personalizada.

Los iconos estándar utilizan la propiedad ForeColor de DataGridViewCellStyle en uso por la celda del encabezado de fila. Los iconos estándar no se representan si no hay suficiente espacio para mostrarlos por completo.

Si la celda del encabezado de fila tiene establecido un valor de cadena, y si no hay suficiente espacio para el texto y el icono, éste se quita primero.

Ordenar

En modo sin enlace, se agregan siempre los nuevos registros al final del control DataGridView aunque el usuario haya ordenado el contenido de DataGridView. El usuario necesitará aplicar de nuevo la ordenación para que la fila ocupe la posición correcta. Este comportamiento es similar al del control ListView.

En los modos de enlace a datos y virtuales, el comportamiento de inserción al aplicar una ordenación es dependiente en la implementación del modelo de datos. En ADO.NET, la fila se ordena inmediatamente en la posición correcta.

Otras notas en la fila para los nuevos registros

No puede establecer la propiedad Visible de esta fila en false. Se produce una InvalidOperationException si se intenta.

La fila para los nuevos registros siempre se crea en estado no seleccionado.

Modo virtual

Si está implementando el modo virtual, necesitará saber si se necesita una fila de nuevos registros en el modelo de datos y si hay que deshacer la adición de la fila. La implementación exacta de esta funcionalidad depende de la implementación del modelo de datos y de la semántica de la transacción, por ejemplo, si el ámbito de confirmación se encuentra a nivel de la celda o de la fila. Para obtener más información, vea Modo virtual del control DataGridView de formularios Windows Forms.

Vea también

Tareas

Cómo: Especificar valores predeterminados para nuevas filas en el control DataGridView de formularios Windows Forms

Referencia

DataGridView

DataGridView.DefaultValuesNeeded

Otros recursos

Entrada de datos en el control DataGridView de formularios Windows Forms