The requested page is not available for the requested platform. You are viewing the content for .NET Framework 4.5.2+ platform.
.NET Framework 4.5.2+
.NET Framework 4.5.2+
.NET Standard 2.0+
.NET Core 3.0+

Row.Insert() Method

Inserts a new row into the worksheet.

Namespace: DevExpress.Spreadsheet

Assembly: DevExpress.Spreadsheet.v19.2.Core.dll

Declaration

void Insert()
Sub Insert
void Insert()
Sub Insert
void Insert()
Sub Insert

Remarks

Use the Insert method to add a new row above the current row. To add more than one row, use the RowCollection.Insert method.

Note

The number of rows in a worksheet is unchanged - 1,048,576. When you add new rows, the equivalent number of rows at the end are automatically removed from the worksheet.

To copy data (for example, values, formulas, formatting, etc.) from one row to another one, use the CellRange.CopyFrom method. For details, see the How to: Copy a Row or Column example.

Examples

This example demonstrates how to insert new rows into a worksheet.

  • Use the Row.Insert method to add a new row above the current row.
  • Call the RowCollection.Insert method of the Worksheet.Rows collection to insert a row at the specified position or add multiple rows at once.
  • To insert empty rows above the specified cell range, use the Worksheet.InsertCells method with the InsertCellsMode.EntireRow enumeration member passed as a parameter. This method inserts the same number of rows as the specified cell range contains.

Enclose your code in the Workbook.BeginUpdate - Workbook.EndUpdate method calls to improve performance when you add multiple rows to a document.

// Insert a new row 3.
worksheet.Rows["3"].Insert();

// Insert a new row into the worksheet at the 5the position.
worksheet.Rows.Insert(4);

// Insert five rows into the worksheet at the 9th position.
worksheet.Rows.Insert(8, 5);

// Insert two rows above the "L15:M16" cell range.
worksheet.InsertCells(worksheet.Range["L15:M16"], InsertCellsMode.EntireRow);
See Also