DataGridViewRowCollection.InsertCopies(Int32, Int32, Int32) 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í.
Inserta filas en la posición especificada de la colección.
public:
virtual void InsertCopies(int indexSource, int indexDestination, int count);
public virtual void InsertCopies (int indexSource, int indexDestination, int count);
abstract member InsertCopies : int * int * int -> unit
override this.InsertCopies : int * int * int -> unit
Public Overridable Sub InsertCopies (indexSource As Integer, indexDestination As Integer, count As Integer)
Parámetros
- indexSource
- Int32
Índice del elemento DataGridViewRow en el que basar las nuevas filas.
- indexDestination
- Int32
Posición en la que se insertarán las filas.
- count
- Int32
Número de objetos DataGridViewRow que desea agregar al elemento DataGridViewRowCollection.
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.
o bien
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
indexDestination
es igual al número de filas de la colección y AllowUserToAddRows es true
.
O bien
Esta operación insertaría filas inmovilizadas después de las filas que no estén inmovilizadas o filas que no estén inmovilizadas antes de las filas inmovilizadas.
Comentarios
La InheritedStyle propiedad de los nuevos DataGridViewRow objetos tiene los mismos valores que el InheritedStyleDataGridViewRow del situado en indexSource
. El InsertCopies método agrega filas compartidas a DataGridViewRowCollection, si es posible. De lo contrario, las nuevas filas no se compartirán. 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.