DataGridViewRowCollection.Add 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 una o más filas a la colección.
Sobrecargas
| Add() |
Agrega una nueva fila a la colección. |
| Add(Int32) |
Agrega el número especificado de filas nuevas a la colección. |
| Add(Object[]) |
Agrega una nueva fila a la colección y rellena las celdas con los objetos especificados. |
| Add(DataGridViewRow) |
Agrega el DataGridViewRow especificado a la colección. |
Add()
Agrega una nueva fila a la colección.
public:
virtual int Add();public virtual int Add ();abstract member Add : unit -> int
override this.Add : unit -> intPublic Overridable Function Add () As IntegerDevoluciones
Índice de la nueva fila.
Excepciones
El control DataGridView asociado está realizando una de las siguientes acciones que impide que se agreguen nuevas filas temporalmente:
Seleccionar todas las celdas del control.
Borrar la selección.
O bien
Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView:
O bien
La propiedad DataSource de DataGridView no es null.
O bien
DataGridView no tiene columnas.
o bien
Esta operación agregaría una fila inmovilizada después de filas inmovilizadas.
La fila devuelta por la propiedad RowTemplate tiene más celdas que columnas hay en el control.
Comentarios
La Add() sobrecarga agrega filas basadas en de RowTemplate .DataGridView La nueva fila se comparte, si es posible. Asegúrese de que la fila especificada en la RowTemplate propiedad se puede compartir para mejorar la escalabilidad. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.
Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas. Para ordenar nuevas filas en su posición correcta, llame al DataGridView.Sort método en un DataGridView.RowsAdded controlador de eventos. También puede llamar al DataGridView.Sort método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.
Consulte también
- DataGridView
- DataGridViewRow
- Procedimientos recomendados para ajustar la escala del control DataGridView en formularios Windows Forms
Se aplica a
Add(Int32)
Agrega el número especificado de filas nuevas a la colección.
public:
virtual int Add(int count);public virtual int Add (int count);abstract member Add : int -> int
override this.Add : int -> intPublic Overridable Function Add (count As Integer) As IntegerParámetros
- count
- Int32
Número de filas que desea agregar al DataGridViewRowCollection.
Devoluciones
Índice de la última fila que se ha agregado.
Excepciones
count es menor que 1.
El control DataGridView asociado está realizando una de las siguientes acciones que impide que se agreguen nuevas filas temporalmente:
Seleccionar todas las celdas del control.
Borrar la selección.
O bien
Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView:
O bien
La propiedad DataSource de DataGridView no es null.
O bien
DataGridView no tiene columnas.
o bien
La fila devuelta por la propiedad RowTemplate tiene más celdas que columnas hay en el control.
O bien
Esta operación agregaría filas inmovilizada después de las filas inmovilizadas.
Comentarios
El Add(Int32) método agrega filas compartidas a DataGridViewRowCollection. Las nuevas filas se basan en el RowTemplate de DataGridView. Asegúrese de que la fila especificada en la RowTemplate propiedad se puede compartir para mejorar la escalabilidad. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.
Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas. Para ordenar nuevas filas en su posición correcta, llame al DataGridView.Sort método en un DataGridView.RowsAdded controlador de eventos. También puede llamar al DataGridView.Sort método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.
Consulte también
Se aplica a
Add(Object[])
Agrega una nueva fila a la colección y rellena las celdas con los objetos especificados.
public:
virtual int Add(... cli::array <System::Object ^> ^ values);public virtual int Add (params object[] values);abstract member Add : obj[] -> int
override this.Add : obj[] -> intPublic Overridable Function Add (ParamArray values As Object()) As IntegerParámetros
- values
- Object[]
Un número variable de objetos que rellenan las celdas del nuevo DataGridViewRow.
Devoluciones
Índice de la nueva fila.
Excepciones
values es null.
El control DataGridView asociado está realizando una de las siguientes acciones que impide que se agreguen nuevas filas temporalmente:
Seleccionar todas las celdas del control.
Borrar la selección.
O bien
Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView:
O bien
La propiedad VirtualMode de DataGridView está establecida en true.
O bien
La propiedad DataSource de DataGridView no es null.
O bien
DataGridView no tiene columnas.
o bien
La fila devuelta por la propiedad RowTemplate tiene más celdas que columnas hay en el control.
O bien
Esta operación agregaría una fila inmovilizada después de filas inmovilizadas.
Comentarios
El Add(Object[]) método agrega una fila no compartida a .DataGridViewRowCollection Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.
Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas. Para ordenar nuevas filas en su posición correcta, llame al DataGridView.Sort método en un DataGridView.RowsAdded controlador de eventos. También puede llamar al DataGridView.Sort método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.
Consulte también
Se aplica a
Add(DataGridViewRow)
Agrega el DataGridViewRow especificado a la colección.
public:
virtual int Add(System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual int Add (System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Add : System.Windows.Forms.DataGridViewRow -> int
override this.Add : System.Windows.Forms.DataGridViewRow -> intPublic Overridable Function Add (dataGridViewRow As DataGridViewRow) As IntegerParámetros
- dataGridViewRow
- DataGridViewRow
DataGridViewRow que se va a agregar a DataGridViewRowCollection.
Devoluciones
Índice del DataGridViewRow nuevo.
Excepciones
El control DataGridView asociado está realizando una de las siguientes acciones que impide que se agreguen nuevas filas temporalmente:
Seleccionar todas las celdas del control.
Borrar la selección.
O bien
Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView:
O bien
La propiedad DataSource de DataGridView no es null.
O bien
DataGridView no tiene columnas.
o bien
La propiedad DataGridView de dataGridViewRow no es null.
o bien
dataGridViewRow tiene un valor de propiedad Selected de true.
O bien
Esta operación agregaría una fila inmovilizada después de filas inmovilizadas.
dataGridViewRow es null.
dataGridViewRow tiene más celdas que columnas existentes en el control.
Comentarios
El Add(DataGridViewRow) método agrega una fila compartida a , DataGridViewRowCollectionsi es posible. De lo contrario, la nueva fila no se comparte. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.
Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas. Para ordenar nuevas filas en su posición correcta, llame al DataGridView.Sort método en un DataGridView.RowsAdded controlador de eventos. También puede llamar al DataGridView.Sort método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.
Consulte también
- DataGridView
- DataGridViewRow
- DataGridViewColumn
- CellTemplate
- Procedimientos recomendados para ajustar la escala del control DataGridView en formularios Windows Forms
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de