DataGridViewRowCollection.Insert 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 o más filas en la colección.
Sobrecargas
| Insert(Int32, DataGridViewRow) |
Inserta el elemento DataGridViewRow que se especificó en la colección. |
| Insert(Int32, Int32) |
Inserta el número de filas especificado en la colección en la ubicación especificada. |
| Insert(Int32, Object[]) |
Inserta una fila en la posición especificada de la colección y rellena las celdas con los objetos especificados. |
Insert(Int32, DataGridViewRow)
Inserta el elemento DataGridViewRow que se especificó en la colección.
public:
virtual void Insert(int rowIndex, System::Windows::Forms::DataGridViewRow ^ dataGridViewRow);public virtual void Insert (int rowIndex, System.Windows.Forms.DataGridViewRow dataGridViewRow);abstract member Insert : int * System.Windows.Forms.DataGridViewRow -> unit
override this.Insert : int * System.Windows.Forms.DataGridViewRow -> unitPublic Overridable Sub Insert (rowIndex As Integer, dataGridViewRow As DataGridViewRow)Parámetros
- rowIndex
- Int32
La posición en la que se insertará la fila.
- dataGridViewRow
- DataGridViewRow
Objeto DataGridViewRow que se va a insertar en DataGridViewRowCollection.
Excepciones
rowIndex es menor que cero o mayor que el número de filas de la colección.
dataGridViewRow 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
rowIndex 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 dataGridViewRow no es null.
o bien
dataGridViewRow 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.
dataGridViewRow tiene más celdas que columnas existentes en el control.
Comentarios
El Insert(Int32, DataGridViewRow) método agrega una fila compartida a , DataGridViewRowCollectionsi es posible. De lo contrario, la nueva fila no está compartida. 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.
Consulte también
Se aplica a
Insert(Int32, Int32)
Inserta el número de filas especificado en la colección en la ubicación especificada.
public:
virtual void Insert(int rowIndex, int count);public virtual void Insert (int rowIndex, int count);abstract member Insert : int * int -> unit
override this.Insert : int * int -> unitPublic Overridable Sub Insert (rowIndex As Integer, count As Integer)Parámetros
- rowIndex
- Int32
Posición en la que se insertarán las filas.
- count
- Int32
Número de filas para insertar en el DataGridViewRowCollection.
Excepciones
rowIndex 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
La propiedad DataSource de DataGridView no es null.
O bien
DataGridView no tiene columnas.
o bien
rowIndex es igual al número de filas de la colección y la propiedad AllowUserToAddRows de DataGridView se establece en true.
O bien
La fila devuelta por la propiedad RowTemplate tiene más celdas que columnas hay en el control.
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
El Insert(Int32, Int32) método agrega filas basadas en de RowTemplate .DataGridView La nueva fila se comparte, si es posible. Asegúrese de que la fila especificada en la RowTemplate propiedad se puede compartir para mejorar la escalabilidad. 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.
Consulte también
Se aplica a
Insert(Int32, Object[])
Inserta una fila en la posición especificada de la colección y rellena las celdas con los objetos especificados.
public:
virtual void Insert(int rowIndex, ... cli::array <System::Object ^> ^ values);public virtual void Insert (int rowIndex, params object[] values);abstract member Insert : int * obj[] -> unit
override this.Insert : int * obj[] -> unitPublic Overridable Sub Insert (rowIndex As Integer, ParamArray values As Object())Parámetros
- rowIndex
- Int32
La posición en la que se insertará la fila.
- values
- Object[]
Un número variable de objetos que rellenan las celdas de la nueva fila.
Excepciones
rowIndex es menor que cero o mayor que el número de filas de la colección.
values 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 VirtualMode de DataGridView está establecida en true.
O bien
La propiedad DataSource de DataGridView no es null.
O bien
DataGridView no tiene columnas.
o bien
rowIndex es igual al número de filas de la colección y la propiedad AllowUserToAddRows de DataGridView se establece en true.
O bien
La propiedad DataGridView de la fila devuelta por la propiedad RowTemplate del control no es null.
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.
La fila devuelta por la propiedad RowTemplate del control tiene más celdas que columnas hay en el control.
Comentarios
El Insert(Int32, Object[]) método agrega una fila no compartida a .DataGridViewRowCollection
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.
