DataGridViewRowCollection.InsertCopy(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 una fila en la colección en la posición especificada, en función de la fila en la posición especificada.
public:
virtual void InsertCopy(int indexSource, int indexDestination);public virtual void InsertCopy(int indexSource, int indexDestination);abstract member InsertCopy : int * int -> unit
override this.InsertCopy : int * int -> unitPublic Overridable Sub InsertCopy (indexSource As Integer, indexDestination As Integer)Parámetros
- indexSource
- Int32
Índice de la fila en la que se va a basar la nueva fila.
- indexDestination
- Int32
Posición en la que se va a 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 asociado DataGridView está realizando una de las siguientes acciones que impide temporalmente que se agreguen nuevas filas:
Selección de todas las celdas del control.
Borrar la selección.
O bien
Se llama a este método desde un controlador para uno de los eventos siguientes 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 desfrozen o una fila desenfrozen 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 InheritedStyle de la DataGridViewRow posición 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, vea Procedimientos recomendados para escalar el control DataGridView de formularios 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.
