DataGridViewRowCollection.InsertCopy(Int32, Int32) Método

Definición

Inserta una fila en la colección en la posición especificada, basándose en la fila de la posición especificada.

public virtual void InsertCopy (int indexSource, int indexDestination);

Parámetros

indexSource
Int32

El índice de la fila en la que se basará la nueva fila.

indexDestination
Int32

La posición en la que se insertará la fila.

Excepciones

indexSource es menor que cero o mayor que el número de filas de la colección menos uno.

O bien

indexDestination es menor que cero o mayor que el número de filas de la colección.

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

indexDestination es igual al número de filas de la colección y AllowUserToAddRows es true.

O bien

Esta operación insertaría una fila inmovilizada después de las filas que no estén inmovilizadas o una fila que no esté inmovilizada antes de las filas inmovilizadas.

Comentarios

Este método asigna la nueva fila al índice especificado en el indexDestination parámetro e incrementa los índices de todas las filas posteriores. La InheritedStyle propiedad del nuevo DataGridViewRow tiene los mismos valores que el InheritedStyleDataGridViewRow del situado en indexSource. El InsertCopy método agrega una fila compartida a DataGridViewRowCollection, si 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.

Se aplica a

Producto Versiones
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Consulte también