Add Table to Word Document

On this page we will look at how to add a table to a document in a Word format using Aspose.Words or Open XML SDK.

Aspose.Words

In Aspose.Words a table is normally inserted using DocumentBuilder. Use its methods to build a table and insert content into table cells, for example, the following:

• StartTable
• InsertCell
• EndRow
• EndTable
• Write

The following code example shows how to add a table to a document:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.StartTable();
builder.InsertCell();
builder.Write("Row 1, Cell 1 Content.");
builder.InsertCell();
builder.Write("Row 1, Cell 2 Content.");
builder.EndRow();

builder.InsertCell();
builder.Write("Row 2, Cell 1 Content");
builder.InsertCell();
builder.Write("Row 2, Cell 2 Content.");
builder.EndRow();
builder.EndTable();

doc.Save(ArtifactsDir + "Table - Aspose.Words.docx");

Open XML SDK

The basic structure of a WordProcessingML document consists of document and body elements, followed by one or more block-level elements, such as paragraphs. A paragraph contains one or more run elements, which is a region of text with a common set of properties, such as formatting. A run contains one or more table elements. A table element contains a range of text.

The following code example shows how to add a table to a document:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-.NET.git.
string[,] data = { { "Mike", "Amy" }, { "Mary", "Albert" } };

using WordprocessingDocument wordDocument = WordprocessingDocument.Create(ArtifactsDir + "Table - OpenXML.docx", WordprocessingDocumentType.Document);

MainDocumentPart mainPart = wordDocument.AddMainDocumentPart();
mainPart.Document = new Document();

Body body = mainPart.Document.AppendChild(new Body());
Paragraph para = body.AppendChild(new Paragraph());

Run run = para.AppendChild(new Run());
run.AppendChild(new Text("Create text in body - Create wordprocessing document"));

Table table = new Table();
TableProperties props = new TableProperties(
    new TableBorders(
        new TopBorder
        {
            Val = new EnumValue<BorderValues>(BorderValues.Single),
            Size = 12
        },
        new BottomBorder
        {
            Val = new EnumValue<BorderValues>(BorderValues.Single),
            Size = 12
        },
        new LeftBorder
        {
            Val = new EnumValue<BorderValues>(BorderValues.Single),
            Size = 12
        },
        new RightBorder
        {
            Val = new EnumValue<BorderValues>(BorderValues.Single),
            Size = 12
        },
        new InsideHorizontalBorder
        {
            Val = new EnumValue<BorderValues>(BorderValues.Single),
            Size = 12
        },
        new InsideVerticalBorder
        {
            Val = new EnumValue<BorderValues>(BorderValues.Single),
            Size = 12
        }));

table.AppendChild(props);

for (var i = 0; i <= data.GetUpperBound(0); i++)
{
    var tr = new TableRow();
    for (var j = 0; j <= data.GetUpperBound(1); j++)
    {
        var tc = new TableCell();
        tc.Append(new Paragraph(new Run(new Text(data[i, j]))));

        // Assume you want automatically sized columns.
        tc.Append(new TableCellProperties(
            new TableCellWidth { Type = TableWidthUnitValues.Auto }));

        tr.Append(tc);
    }

    table.Append(tr);
}

mainPart.Document.Body.Append(table);
mainPart.Document.Save();

You can download the sample file of this example from Aspose.Words GitHub.

For more information about Aspose.Words features please visit Working with Tables.