DataGridViewRowCollection.IList.Insert(Int32, Object) 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 clase DataGridViewRow en el índice especificado de la colección.
virtual void System.Collections.IList.Insert(int index, System::Object ^ value) = System::Collections::IList::Insert;
void IList.Insert (int index, object value);
void IList.Insert (int index, object? value);
abstract member System.Collections.IList.Insert : int * obj -> unit
override this.System.Collections.IList.Insert : int * obj -> unit
Sub Insert (index As Integer, value As Object) Implements IList.Insert
Parámetros
- index
- Int32
Índice basado en cero en el que debe insertarse value
.
- value
- Object
Objeto DataGridViewRow que se va a insertar en DataGridViewRowCollection.
Implementaciones
Excepciones
value
no es un DataGridViewRow.
index
es menor que cero o mayor que el número de filas de la colección.
value
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 DataSource de DataGridView no es null
.
o bien
index
es igual al número de filas de la colección y la propiedad AllowUserToAddRows de DataGridView se establece en true
.
O bien
DataGridView no tiene columnas.
o bien
La propiedad DataGridView de value
no es null
.
o bien
value
tiene un valor de propiedad Selected de 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.
value
tiene más celdas que columnas existentes en el control.
Comentarios
Este miembro es una implementación explícita de un miembro de interfaz. Solo se puede utilizar cuando la instancia de DataGridViewRowCollection se convierte en una interfaz IList.
Este método llama a la Insert(Int32, DataGridViewRow) sobrecarga, pasando el valor después de convertirlo en .DataGridViewRow
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.