DataGridViewRowCollection.Add DataGridViewRowCollection.Add DataGridViewRowCollection.Add DataGridViewRowCollection.Add Method

Definición

Agrega una o más filas a la colección.Adds one or more rows to the collection.

Sobrecargas

Add() Add() Add() Add()

Agrega una nueva fila a la colección.Adds a new row to the collection.

Add(Int32) Add(Int32) Add(Int32) Add(Int32)

Agrega a la colección el número especificado de nuevas filas.Adds the specified number of new rows to the collection.

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Agrega una nueva fila a la colección y rellena las celdas con los objetos especificados.Adds a new row to the collection, and populates the cells with the specified objects.

Add(DataGridViewRow) Add(DataGridViewRow) Add(DataGridViewRow)

Agrega el DataGridViewRow especificado a la colección.Adds the specified DataGridViewRow to the collection.

Add() Add() Add() Add()

Agrega una nueva fila a la colección.Adds a new row to the collection.

public:
 virtual int Add();
public virtual int Add ();
abstract member Add : unit -> int
override this.Add : unit -> int
Public Overridable Function Add () As Integer

Devoluciones

Índice de la nueva fila.The index of the new row.

Excepciones

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas filas:The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - Seleccionar todas las celdas del control.- Selecting all cells in the control.

- Borrar la selección.- Clearing the selection.

o bien-or- Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView :This method is being called from a handler for one of the following DataGridView events:

O bien-or- La propiedad DataSource del objeto DataGridView no es null.The DataSource property of the DataGridView is not null.

o bien-or- DataGridView no tiene columnas.The DataGridView has no columns.

O bien-or- Esta operación agregaría una fila inmovilizada después de las filas que no están inmovilizadas.This operation would add a frozen row after unfrozen rows.

La fila devuelta por la propiedad RowTemplate tiene más celdas que columnas hay en el control.The row returned by the RowTemplate property has more cells than there are columns in the control.

Comentarios

La Add() sobrecarga agrega filas basadas en el RowTemplate de DataGridView.The Add() overload adds rows that are based on the RowTemplate of the DataGridView. Si es posible, se comparte la nueva fila.The new row is shared, if possible. Asegúrese de que se puede compartir la fila RowTemplate especificada en la propiedad para obtener la mejor escalabilidad.Be sure that the row specified in the RowTemplate property can be shared for best scalability. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas.Rows in the control are not automatically sorted when new rows are added. Para ordenar las nuevas filas en su posición correcta, llame DataGridView.Sort al método en DataGridView.RowsAdded un controlador de eventos.To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. También puede llamar DataGridView.Sort al método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

Consulte también:

Add(Int32) Add(Int32) Add(Int32) Add(Int32)

Agrega a la colección el número especificado de nuevas filas.Adds the specified number of new rows to the collection.

public:
 virtual int Add(int count);
public virtual int Add (int count);
abstract member Add : int -> int
override this.Add : int -> int
Public Overridable Function Add (count As Integer) As Integer

Parámetros

count
Int32 Int32 Int32 Int32

El número de filas que agregar a la colección DataGridViewRowCollection.The number of rows to add to the DataGridViewRowCollection.

Devoluciones

El índice de la última fila que se agregó.The index of the last row that was added.

Excepciones

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas filas:The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - Seleccionar todas las celdas del control.- Selecting all cells in the control.

- Borrar la selección.- Clearing the selection.

o bien-or- Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView :This method is being called from a handler for one of the following DataGridView events:

O bien-or- La propiedad DataSource del objeto DataGridView no es null.The DataSource property of the DataGridView is not null.

O bien-or- DataGridView no tiene columnas.The DataGridView has no columns.

o bien-or- La fila devuelta por la propiedad RowTemplate tiene más celdas que columnas hay en el control.The row returned by the RowTemplate property has more cells than there are columns in the control.

o bien-or- Esta operación agregaría filas inmovilizadas después de las filas que no están inmovilizadas.This operation would add frozen rows after unfrozen rows.

Comentarios

El Add(Int32) método agrega filas compartidas DataGridViewRowCollectiona.The Add(Int32) method adds shared rows to the DataGridViewRowCollection. Las nuevas filas se basan en el RowTemplate DataGridViewdel.The new rows are based on the RowTemplate of the DataGridView. Asegúrese de que se puede compartir la fila RowTemplate especificada en la propiedad para obtener la mejor escalabilidad.Be sure that the row specified in the RowTemplate property can be shared for best scalability. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas.Rows in the control are not automatically sorted when new rows are added. Para ordenar las nuevas filas en su posición correcta, llame DataGridView.Sort al método en DataGridView.RowsAdded un controlador de eventos.To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. También puede llamar DataGridView.Sort al método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

Consulte también:

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Agrega una nueva fila a la colección y rellena las celdas con los objetos especificados.Adds a new row to the collection, and populates the cells with the specified objects.

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[] -> int
Public Overridable Function Add (ParamArray values As Object()) As Integer

Parámetros

values
Object[]

Un número variable de objetos que rellenan las celdas de la nueva fila DataGridViewRow.A variable number of objects that populate the cells of the new DataGridViewRow.

Devoluciones

Índice de la nueva fila.The index of the new row.

Excepciones

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas filas:The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - Seleccionar todas las celdas del control.- Selecting all cells in the control.

- Borrar la selección.- Clearing the selection.

o bien-or- Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView :This method is being called from a handler for one of the following DataGridView events:

O bien-or- La propiedad VirtualMode de DataGridView se establece en true.The VirtualMode property of the DataGridView is set to true.

o bien-or- La propiedad DataSource del objeto DataGridView no es null.The DataSource property of the DataGridView is not null.

O bien-or- DataGridView no tiene columnas.The DataGridView has no columns.

O bien-or- La fila devuelta por la propiedad RowTemplate tiene más celdas que columnas hay en el control.The row returned by the RowTemplate property has more cells than there are columns in the control.

O bien-or- Esta operación agregaría una fila inmovilizada después de las filas que no están inmovilizadas.This operation would add a frozen row after unfrozen rows.

Comentarios

El Add(Object[]) método agrega una fila no compartida DataGridViewRowCollectiona.The Add(Object[]) method adds an unshared row to the DataGridViewRowCollection. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas.Rows in the control are not automatically sorted when new rows are added. Para ordenar las nuevas filas en su posición correcta, llame DataGridView.Sort al método en DataGridView.RowsAdded un controlador de eventos.To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. También puede llamar DataGridView.Sort al método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

Consulte también:

Add(DataGridViewRow) Add(DataGridViewRow) Add(DataGridViewRow)

Agrega el DataGridViewRow especificado a la colección.Adds the specified DataGridViewRow to the collection.

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 -> int

Parámetros

Devoluciones

Índice del DataGridViewRow nuevo.The index of the new DataGridViewRow.

Excepciones

El control DataGridView asociado está realizando una de las acciones siguientes que impide temporalmente que se agreguen nuevas filas:The associated DataGridView control is performing one of the following actions that temporarily prevents new rows from being added: - Seleccionar todas las celdas del control.- Selecting all cells in the control.

- Borrar la selección.- Clearing the selection.

O bien-or- Se llama a este método desde un controlador para uno de los siguientes eventos DataGridView :This method is being called from a handler for one of the following DataGridView events:

O bien-or- La propiedad DataSource del objeto DataGridView no es null.The DataSource property of the DataGridView is not null.

O bien-or- DataGridView no tiene columnas.The DataGridView has no columns.

O bien-or- La propiedad DataGridView del objeto dataGridViewRow no es null.The DataGridView property of the dataGridViewRow is not null.

O bien-or- dataGridViewRow tiene un valor de propiedad Selected de true.dataGridViewRow has a Selected property value of true.

o bien-or- Esta operación agregaría una fila inmovilizada después de las filas que no están inmovilizadas.This operation would add a frozen row after unfrozen rows.

dataGridViewRow tiene más celdas que columnas hay en el control.dataGridViewRow has more cells than there are columns in the control.

Comentarios

El Add(DataGridViewRow) método agrega una fila compartida DataGridViewRowCollectiona, si es posible.The Add(DataGridViewRow) method adds a shared row to the DataGridViewRowCollection, if possible. De lo contrario, la nueva fila no está compartida.Otherwise, the new row is unshared. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Las filas del control no se ordenan automáticamente cuando se agregan nuevas filas.Rows in the control are not automatically sorted when new rows are added. Para ordenar las nuevas filas en su posición correcta, llame DataGridView.Sort al método en DataGridView.RowsAdded un controlador de eventos.To sort new rows into their correct position, call the DataGridView.Sort method in a DataGridView.RowsAdded event handler. También puede llamar DataGridView.Sort al método en un CellValueChanged controlador de eventos para ordenar las filas cuando el usuario modifica una celda.You might also want to call the DataGridView.Sort method in a CellValueChanged event handler to sort the rows when the user modifies a cell.

Consulte también:

Se aplica a