How to Add Rows to Table in MS Word Document Using C#

How to Add Rows to Table in MS Word Document Using C#

In this tutorial, you’ll learn how to programmatically add rows to a table in an MS Word document using C#. You’ll add rows at a specified index and insert multiple empty rows at the end of the table.

Benefits of Adding Rows to Tables in Word Documents

  1. Dynamic Content Management:
    • Easily modify existing tables to fit new data.
  2. Flexibility:
    • Adjust table structures programmatically without manual edits.
  3. Automation:
    • Efficiently manage table data through automated scripts.

Prerequisites: Preparing the Environment

  1. Have Visual Studio or any .NET IDE installed.
  2. Ensure the Aspose.Words library is available via NuGet.

Step-by-Step Guide to Add Rows to a Table in Word

Step 1: Install Aspose.Words Library

Install the Aspose.Words package using the NuGet package manager.

Install-Package Aspose.Words

Step 2: Import Necessary Namespaces

Include Aspose.Words and Aspose.Words.Tables namespaces in your project.

using Aspose.Words;
using Aspose.Words.Tables;

Step 3: Open the Word Document

Load the existing MS Word document.

Document MSWordDocument = new Document(@"MS Word.docx");

Step 4: Access the Table

Get the Table by its index from the document.

Table tableToAddRowsTo = MSWordDocument.FirstSection.Body.Tables[0];

Step 5: Create or Clone a Row

Create a new Row or clone an existing one from the Table.

Row row = new Row(MSWordDocument);

Step 6: Add Cells to the Row

Add Cells and text to the Row.

for (int i = 0; i < 3; i++) 
{
    Cell cell = new Cell(MSWordDocument);
    cell.AppendChild(new Paragraph(MSWordDocument));
    cell.FirstParagraph.Runs.Add(new Run(MSWordDocument, "Text in Cell " + i));
    row.Cells.Add(cell);
}

Step 7: Add Rows to the End

Use RowCollection.Add to append Rows to the Table.

tableToAddRowsTo.Rows.Add(row);

Step 8: Insert Rows at a Specific Index

Insert Rows at a specific index using RowCollection.Insert.

tableToAddRowsTo.Rows.Insert(1, row);

Step 9: Save the Updated Document

Resave the document with the added rows.

MSWordDocument.Save(@"Added Rows to Table in MS Word.docx");

Example Code to Add Rows to Table in Word

Below is the complete code for adding rows to a table:

// Open MS Word Document
Document MSWordDocument = new Document(@"input.docx");

// Get the Table by index
Table tableToAddRowsTo = MSWordDocument.FirstSection.Body.Tables[0];

// Create a new Row class object
Row row = new Row(MSWordDocument);

// Add three Cells to Row's cells collection
for (int i = 0; i < 3; i++)
{
    Cell cell = new Cell(MSWordDocument);
    cell.AppendChild(new Paragraph(MSWordDocument));
    cell.FirstParagraph.Runs.Add(new Run(MSWordDocument, "Text in Cell " + i));
    row.Cells.Add(cell);
}

// Insert new Row after the first Row
tableToAddRowsTo.Rows.Insert(1, row);

// Clone an existing Row from Table
Row cloneOfRow = (Row)tableToAddRowsTo.FirstRow.Clone(true);

// Remove all content from all Cells
foreach (Cell cell in cloneOfRow)
{
    cell.RemoveAllChildren();
    cell.EnsureMinimum();
}

// Add multiple empty rows to the end of table
for (int i = 0; i < 10; i++)
{
    Row emptyRow = (Row)cloneOfRow.Clone(true);
    tableToAddRowsTo.Rows.Add(emptyRow);
}

// Save updated document
MSWordDocument.Save(@"output.docx");

Conclusion

This tutorial has demonstrated how to add rows to a table in an MS Word document using C#. By following these steps, you can effectively manage and modify tables within Word documents programmatically.

 English