Compartir vía


DataGridViewRowCollection.Insert Método

Definición

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 -> unit
Public 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 -> unit
Public 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[] -> unit
Public 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.

Consulte también

Se aplica a