title	Working with Tables in .NET Word (DocIO) Library \| Syncfusion
description	Learn how to work with tables, rows, cells, and their formatting in a Word document using the .NET Word (DocIO) library.
platform	file-formats
control	DocIO
documentation	UG

Working with Tables in Word document

A table in Word document is used to arrange document content in rows and columns. WTable instance represents a table in Word document. A table must contain at least one row.

A row is a collection of cells and it is represented by an instance of WTableRow. Each row must contain at least one cell.
A cell can contain one or more paragraphs and tables. An instance of WTableCell represents a table cell. Each table cell must contain at least one paragraph.

N> Adding more than 63 columns not supported in Word document using Microsoft Word application. It shows alert when you attempt to insert table with more than 64 columns, which is a one of the behaviors of Microsoft Word and Essential DocIO does the same.

The following image illustrates how a table in Word document is organized in EssentialDocIO’s DOM:

The following code example illustrates how to create a simple table with predefined number of rows and cells.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); //Adds a section into Word document IWSection section = document.AddSection(); //Adds a new paragraph into Word document and appends text into paragraph IWTextRange textRange = section.AddParagraph().AppendText("Price Details"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 12; textRange.CharacterFormat.Bold = true; section.AddParagraph(); //Adds a new table into Word document IWTable table = section.AddTable(); //Specifies the total number of rows & columns table.ResetCells(3, 2); //Accesses the instance of the cell (first row, first cell) and adds the content into cell textRange = table[0, 0].AddParagraph().AppendText("Item"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 12; textRange.CharacterFormat.Bold = true; //Accesses the instance of the cell (first row, second cell) and adds the content into cell textRange = table[0, 1].AddParagraph().AppendText("Price($)"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 12; textRange.CharacterFormat.Bold = true; //Accesses the instance of the cell (second row, first cell) and adds the content into cell textRange = table[1, 0].AddParagraph().AppendText("Apple"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Accesses the instance of the cell (second row, second cell) and adds the content into cell textRange = table[1, 1].AddParagraph().AppendText("50"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Accesses the instance of the cell (third row, first cell) and adds the content into cell textRange = table[2, 0].AddParagraph().AppendText("Orange"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Accesses the instance of the cell (third row, second cell) and adds the content into cell textRange = table[2, 1].AddParagraph().AppendText("30"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); //Adds a section into Word document IWSection section = document.AddSection(); //Adds a new paragraph into Word document and appends text into paragraph IWTextRange textRange = section.AddParagraph().AppendText("Price Details"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 12; textRange.CharacterFormat.Bold = true; section.AddParagraph(); //Adds a new table into Word document IWTable table = section.AddTable(); //Specifies the total number of rows & columns table.ResetCells(3, 2); //Accesses the instance of the cell (first row, first cell) and adds the content into cell textRange = table[0, 0].AddParagraph().AppendText("Item"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 12; textRange.CharacterFormat.Bold = true; //Accesses the instance of the cell (first row, second cell) and adds the content into cell textRange = table[0, 1].AddParagraph().AppendText("Price($)"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 12; textRange.CharacterFormat.Bold = true; //Accesses the instance of the cell (second row, first cell) and adds the content into cell textRange = table[1, 0].AddParagraph().AppendText("Apple"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Accesses the instance of the cell (second row, second cell) and adds the content into cell textRange = table[1, 1].AddParagraph().AppendText("50"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Accesses the instance of the cell (third row, first cell) and adds the content into cell textRange = table[2, 0].AddParagraph().AppendText("Orange"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Accesses the instance of the cell (third row, second cell) and adds the content into cell textRange = table[2, 1].AddParagraph().AppendText("30"); textRange.CharacterFormat.FontName = "Arial"; textRange.CharacterFormat.FontSize = 10; //Saves the document in the given name and format document.Save("Table.docx", FormatType.Docx); //Releases the resources occupied by WordDocument instance document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() 'Adds a section into Word document Dim section As IWSection = document.AddSection() 'Adds a new paragraph into Word document and appends text into paragraph Dim textRange As IWTextRange = section.AddParagraph().AppendText("Price Details") textRange.CharacterFormat.FontName = "Arial" textRange.CharacterFormat.FontSize = 12 textRange.CharacterFormat.Bold = True section.AddParagraph() 'Adds a new table into Word document Dim table As IWTable = section.AddTable() 'Specifies the total number of rows and columns table.ResetCells(3, 2) 'Accesses the instance of the cell (first row, first cell) and adds the content into cell textRange = table(0, 0).AddParagraph().AppendText("Item") textRange.CharacterFormat.FontName = "Arial" textRange.CharacterFormat.FontSize = 12 textRange.CharacterFormat.Bold = True 'Accesses the instance of the cell (first row, second cell) and adds the content into cell textRange = table(0, 1).AddParagraph().AppendText("Price($)") textRange.CharacterFormat.FontName = "Arial" textRange.CharacterFormat.FontSize = 12 textRange.CharacterFormat.Bold = True 'Accesses the instance of the cell (second row, first cell) and adds the content into cell textRange = table(1, 0).AddParagraph().AppendText("Apple") textRange.CharacterFormat.FontName = "Arial" textRange.CharacterFormat.FontSize = 10 'Accesses the instance of the cell (second row, second cell) and adds the content into cell textRange = table(1, 1).AddParagraph().AppendText("50") textRange.CharacterFormat.FontName = "Arial" textRange.CharacterFormat.FontSize = 10 'Accesses the instance of the cell (third row, first cell) and adds the content into cell textRange = table(2, 0).AddParagraph().AppendText("Orange") textRange.CharacterFormat.FontName = "Arial" textRange.CharacterFormat.FontSize = 10 'Accesses the instance of the cell (third row, second cell) and adds the content into cell textRange = table(2, 1).AddParagraph().AppendText("30") textRange.CharacterFormat.FontName = "Arial" textRange.CharacterFormat.FontSize = 10 'Saves the document in the given name and format document.Save("Table.docx", FormatType.Docx) 'Releases the resources occupied by WordDocument instance document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

The following code example illustrates how to create a simple table by dynamically adding rows.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Price Details"); section.AddParagraph(); //Adds a new table into Word document IWTable table = section.AddTable(); //Adds the first row into table WTableRow row = table.AddRow(); //Adds the first cell into first row WTableCell cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Item"); //Adds the second cell into first row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Price($)"); //Adds the second row into table row = table.AddRow(true, false); //Adds the first cell into second row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Apple"); //Adds the second cell into second row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("50"); //Adds the third row into table row = table.AddRow(true, false); //Adds the first cell into third row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Orange"); //Adds the second cell into third row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("30"); //Adds the fourth row into table row = table.AddRow(true, false); //Adds the first cell into fourth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Banana"); //Adds the second cell into fourth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("20"); //Adds the fifth row to table row = table.AddRow(true, false); //Adds the first cell into fifth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Grapes"); //Adds the second cell into fifth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("70"); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Price Details"); section.AddParagraph(); //Adds a new table into Word document IWTable table = section.AddTable(); //Adds the first row into table WTableRow row = table.AddRow(); //Adds the first cell into first row WTableCell cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Item"); //Adds the second cell into first row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Price($)"); //Adds the second row into table row = table.AddRow(true, false); //Adds the first cell into second row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Apple"); //Adds the second cell into second row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("50"); //Adds the third row into table row = table.AddRow(true, false); //Adds the first cell into third row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Orange"); //Adds the second cell into third row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("30"); //Adds the fourth row into table row = table.AddRow(true, false); //Adds the first cell into fourth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Banana"); //Adds the second cell into fourth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("20"); //Adds the fifth row to table row = table.AddRow(true, false); //Adds the first cell into fifth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("Grapes"); //Adds the second cell into fifth row cell = row.AddCell(); //Specifies the cell width cell.Width = 200; cell.AddParagraph().AppendText("70"); //Saves and closes the document instance document.Save("Table.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() Dim section As IWSection = document.AddSection() section.AddParagraph().AppendText("Price Details") section.AddParagraph() 'Adds a new table into Word document Dim table As IWTable = section.AddTable() 'Adds the first row into table Dim row As WTableRow = table.AddRow() 'Adds the first cell into first row Dim cell As WTableCell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("Item") 'Adds the second cell into first row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("Price($)") 'Adds the second row into table row = table.AddRow(True, False) 'Adds the first cell into second row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("Apple") 'Adds the second cell into second row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("50") 'Adds the third row into table row = table.AddRow(True, False) 'Adds the first cell into third row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("Orange") 'Adds the second cell into third row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("30") 'Adds the fourth row into table row = table.AddRow(True, False) 'Adds the first cell into fourth row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("Banana") 'Adds the second cell into fourth row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("20") 'Adds the fifth row to table row = table.AddRow(True, False) 'Adds the first cell into fifth row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("Grapes") 'Adds the second cell into fifth row cell = row.AddCell() 'Specifies the cell width cell.Width = 200 cell.AddParagraph().AppendText("70") 'Saves and closes the document instance document.Save("Table.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Nested Table

You can create a nested table by adding a new table into a cell. The following code example illustrates how to add a table into a cell.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Price Details"); IWTable table = section.AddTable(); table.ResetCells(3, 2); table[0, 0].AddParagraph().AppendText("Item"); table[0, 1].AddParagraph().AppendText("Price($)"); table[1, 0].AddParagraph().AppendText("Items with same price"); //Adds a nested table into the cell (second row, first cell). IWTable nestTable = table[1, 0].AddTable(); //Creates the specified number of rows and columns to nested table nestTable.ResetCells(3, 1); //Accesses the instance of the nested table cell (first row, first cell) WTableCell nestedCell = nestTable.Rows[0].Cells[0]; //Specifies the width of the nested cell nestedCell.Width = 200; //Adds the content into nested cell nestedCell.AddParagraph().AppendText("Apple"); //Accesses the instance of the nested table cell (second row, first cell) nestedCell = nestTable.Rows[1].Cells[0]; //Specifies the width of the nested cell nestedCell.Width = 200; //Adds the content into nested cell nestedCell.AddParagraph().AppendText("Orange"); //Accesses the instance of the nested table cell (third row, first cell) nestedCell = nestTable.Rows[2].Cells[0]; //Specifies the width of the nested cell nestedCell.Width = 200; //Adds the content into nested cell nestedCell.AddParagraph().AppendText("Mango"); //Accesses the instance of the cell (second row, second cell) nestedCell = table.Rows[1].Cells[1]; table[1, 1].AddParagraph().AppendText("85"); table[2, 0].AddParagraph().AppendText("Pomegranate"); table[2, 1].AddParagraph().AppendText("70"); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Price Details"); IWTable table = section.AddTable(); table.ResetCells(3, 2); table[0, 0].AddParagraph().AppendText("Item"); table[0, 1].AddParagraph().AppendText("Price($)"); table[1, 0].AddParagraph().AppendText("Items with same price"); //Adds a nested table into the cell (second row, first cell). IWTable nestTable = table[1, 0].AddTable(); //Creates the specified number of rows and columns to nested table nestTable.ResetCells(3, 1); //Accesses the instance of the nested table cell (first row, first cell) WTableCell nestedCell = nestTable.Rows[0].Cells[0]; //Specifies the width of the nested cell nestedCell.Width = 200; //Adds the content into nested cell nestedCell.AddParagraph().AppendText("Apple"); //Accesses the instance of the nested table cell (second row, first cell) nestedCell = nestTable.Rows[1].Cells[0]; //Specifies the width of the nested cell nestedCell.Width = 200; //Adds the content into nested cell nestedCell.AddParagraph().AppendText("Orange"); //Accesses the instance of the nested table cell (third row, first cell) nestedCell = nestTable.Rows[2].Cells[0]; //Specifies the width of the nested cell nestedCell.Width = 200; //Adds the content into nested cell nestedCell.AddParagraph().AppendText("Mango"); //Accesses the instance of the cell (second row, second cell) nestedCell = table.Rows[1].Cells[1]; table[1, 1].AddParagraph().AppendText("85"); table[2, 0].AddParagraph().AppendText("Pomegranate"); table[2, 1].AddParagraph().AppendText("70"); //Saves and closes the document instance document.Save("NestedTable.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() Dim section As IWSection = document.AddSection() section.AddParagraph().AppendText("Price Details") Dim table As IWTable = section.AddTable() table.ResetCells(3, 2) table(0, 0).AddParagraph().AppendText("Item") table(0, 1).AddParagraph().AppendText("Price($)") table(1, 0).AddParagraph().AppendText("Items with same price") 'Adds a nested table into the cell (second row, first cell). Dim nestTable As IWTable = table(1, 0).AddTable() 'Creates the specified number of rows and columns to nested table nestTable.ResetCells(3, 1) 'Accesses the instance of the nested table cell (first row, first cell) Dim nestedCell As WTableCell = nestTable.Rows(0).Cells(0) 'Specifies the width of the nested cell nestedCell.Width = 200 'Adds the content into nested cell nestedCell.AddParagraph().AppendText("Apple") 'Accesses the instance of the nested table cell (second row, first cell) nestedCell = nestTable.Rows(1).Cells(0) 'Specifies the width of the nested cell nestedCell.Width = 200 'Adds the content into nested cell nestedCell.AddParagraph().AppendText("Orange") 'Accesses the instance of the nested table cell (third row, first cell) nestedCell = nestTable.Rows(2).Cells(0) 'Specifies the width of the nested cell nestedCell.Width = 200 'Adds the content into nested cell nestedCell.AddParagraph().AppendText("Mango") 'Accesses the instance of the cell (second row, second cell) nestedCell = table.Rows(1).Cells(1) table(1, 1).AddParagraph().AppendText("85") table(2, 0).AddParagraph().AppendText("Pomegranate") table(2, 1).AddParagraph().AppendText("70") 'Saves and closes the document instance document.Save("NestedTable.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Align text within a table

You can iterate the cells within a table and align text for each cell. Find more information about iterating the cells from here

The following code example illustrates how to align text within a table.

{% tabs %}

{% highlight c# tabtitle="C# [Windows-specific]" %} private void AlignCellContent(WTableCell tableCell, VerticalAlignment verticalAlignment, HorizontalAlignment horizontalAlignment) { //Sets vertical alignment to the cell. tableCell.CellFormat.VerticalAlignment = verticalAlignment; //Iterates body items in table cell and set horizontal alignment. AlignCellContentForTextBody(tableCell, horizontalAlignment); } private void AlignCellContentForTextBody(WTextBody textBody, HorizontalAlignment horizontalAlignment) { for (int i = 0; i < textBody.ChildEntities.Count; i++) { //IEntity is the basic unit in DocIO DOM. //Accesses the body items as IEntity IEntity bodyItemEntity = textBody.ChildEntities[i]; //A Text body has 3 types of elements - Paragraph, Table and Block Content Control //Decides the element type by using EntityType switch (bodyItemEntity.EntityType) { case EntityType.Paragraph: WParagraph paragraph = bodyItemEntity as WParagraph; //Sets horizontal alignment for paragraph. paragraph.ParagraphFormat.HorizontalAlignment = horizontalAlignment; break; case EntityType.Table: //Table is a collection of rows and cells //Iterates through table's DOM and set horizontal alignment. AlignCellContentForTable(bodyItemEntity as WTable, horizontalAlignment); break; case EntityType.BlockContentControl: BlockContentControl blockContentControl = bodyItemEntity as BlockContentControl; //Iterates to the body items of Block Content Control and set horizontal alignment. AlignCellContentForTextBody(blockContentControl.TextBody, horizontalAlignment); break; } } } private void AlignCellContentForTable(WTable table, Syncfusion.DocIO.DLS.HorizontalAlignment horizontalAlignment) { //Iterates the row collection in a table foreach (WTableRow row in table.Rows) { //Iterates the cell collection in a table row foreach (WTableCell cell in row.Cells) { //Iterate items in cell and set horizontal alignment AlignCellContentForTextBody(cell, horizontalAlignment); } } } {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Insert Image to Table Cell

You can insert an image into the table cell by accessing the paragraph in that cell. The following code example illustrates how to insert an image into a table cell.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of the WordDocument class. using (WordDocument document = new WordDocument()) { IWSection section = document.AddSection(); //Adds a new table into the Word document. IWTable table = section.AddTable(); //Specifies the total number of rows & columns. table.ResetCells(2, 2); table[0, 0].AddParagraph().AppendText("Product Name"); table[0, 1].AddParagraph().AppendText("Product Image"); table[1, 0].AddParagraph().AppendText("Apple Juice"); //Adds the image into the cell. FileStream imageStream = new FileStream(@"Image.png", FileMode.Open, FileAccess.ReadWrite); IWPicture picture = table[1, 1].AddParagraph().AppendPicture(imageStream); picture.Height = 75; picture.Width = 60; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the Word document document.Close(); } {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class. using (WordDocument document = new WordDocument()) { IWSection section = document.AddSection(); //Adds a new table into the Word document. IWTable table = section.AddTable(); //Specifies the total number of rows & columns. table.ResetCells(2, 2); table[0, 0].AddParagraph().AppendText("Product Name"); table[0, 1].AddParagraph().AppendText("Product Image"); table[1, 0].AddParagraph().AppendText("Apple Juice"); //Adds the image into the cell. IWPicture picture = table[1, 1].AddParagraph().AppendPicture(Image.FromFile("Image.png")); picture.Height = 75; picture.Width = 60; //Saves the Word document. document.Save("Sample.docx", FormatType.Docx); } {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of the WordDocument class. Using document As New WordDocument() Dim section As IWSection = document.AddSection() 'Adds a new table into the Word document. Dim table As IWTable = section.AddTable() 'Specifies the total number of rows and columns. table.ResetCells(2, 2) table(0, 0).AddParagraph().AppendText("Product Name") table(0, 1).AddParagraph().AppendText("Product Image") table(1, 0).AddParagraph().AppendText("Apple Juice") 'Adds an image to the cell. Dim picture As IWPicture = table(1, 1).AddParagraph().AppendPicture(Image.FromFile("Image.png")) picture.Height = 75 picture.Width = 60 'Saves the Word document. document.Save("Sample.docx", FormatType.Docx) End Using {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Apply formatting to Table, Row and Cell

The following code example illustrates how to load an existing document and apply table formatting options such as Borders, LeftIndent, Paddings, IsAutoResized, etc.

N> 1. BorderStyle.None is the default value of BorderType property in Borders class which will not show borders for the table or cell. It is equivalent to border style not defined and borders can be inherited from style or parent formats. N> 2. To hide border for a table or cell in the Word Document, you can set BorderType property with BorderStyle.Cleared. It means border style defined as no border (Don’t show border) and shouldn’t inherit from style or parent formats. N> 3. To show/display border for a table or cell in the Word Document, you can set BorderType property with BorderStyle values (except BorderStyle.None and BorderStyle.Cleared). N> 4. As in the Microsoft Word, DocIO supports RowFormat.Borders in DOC format alone.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class (Empty Word Document) FileStream fileStreamPath = new FileStream("Table.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); //Opens an existing Word document into DocIO instance WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Specifies the title for the table table.Title ="PriceDetails"; //Specifies the description of the table table.Description = "This table shows the price details of various fruits"; //Specifies the left indent of the table table.IndentFromLeft = 50; //Specifies the background color of the table table.TableFormat.BackColor = Color.FromArgb(192, 192, 192); //Specifies the horizontal alignment of the table table.TableFormat.HorizontalAlignment = RowAlignment.Left; //Specifies the left, right, top and bottom padding of all the cells in the table table.TableFormat.Paddings.All = 10; //Specifies the auto resize of table to automatically resize all cell width based on its content table.TableFormat.IsAutoResized = true; //Specifies the table top, bottom, left and right border line width table.TableFormat.Borders.LineWidth = 2f; //Specifies the table horizontal border line width table.TableFormat.Borders.Horizontal.LineWidth = 2f; //Specifies the table vertical border line width table.TableFormat.Borders.Vertical.LineWidth = 2f; //Specifies the tables top, bottom, left and right border color table.TableFormat.Borders.Color = Color.Red; //Specifies the table Horizontal border color table.TableFormat.Borders.Horizontal.Color = Color.Red; //Specifies the table vertical border color table.TableFormat.Borders.Vertical.Color = Color.Red; //Specifies the table borders border type table.TableFormat.Borders.BorderType = BorderStyle.Double; //Accesses the instance of the first row in the table WTableRow row = table.Rows[0]; //Specifies the row height row.Height = 20; //Specifies the row height type row.HeightType = TableRowHeightType.AtLeast; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class (Empty Word Document) WordDocument document = new WordDocument(); //Opens an existing Word document into DocIO instance document.Open("Table.docx", FormatType.Docx); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Specifies the title for the table table.Title ="PriceDetails"; //Specifies the description of the table table.Description = "This table shows the price details of various fruits"; //Specifies the left indent of the table table.IndentFromLeft = 50; //Specifies the background color of the table table.TableFormat.BackColor = Color.FromArgb(192, 192, 192); //Specifies the horizontal alignment of the table table.TableFormat.HorizontalAlignment = RowAlignment.Left; //Specifies the left, right, top and bottom padding of all the cells in the table table.TableFormat.Paddings.All = 10; //Specifies the auto resize of table to automatically resize all cell width based on its content table.TableFormat.IsAutoResized = true; //Specifies the table top, bottom, left and right border line width table.TableFormat.Borders.LineWidth = 2f; //Specifies the table horizontal border line width table.TableFormat.Borders.Horizontal.LineWidth = 2f; //Specifies the table vertical border line width table.TableFormat.Borders.Vertical.LineWidth = 2f; //Specifies the tables top, bottom, left and right border color table.TableFormat.Borders.Color = Color.Red; //Specifies the table Horizontal border color table.TableFormat.Borders.Horizontal.Color = Color.Red; //Specifies the table vertical border color table.TableFormat.Borders.Vertical.Color = Color.Red; //Specifies the table borders border type table.TableFormat.Borders.BorderType = BorderStyle.Double; //Accesses the instance of the first row in the table WTableRow row = table.Rows[0]; //Specifies the row height row.Height = 20; //Specifies the row height type row.HeightType = TableRowHeightType.AtLeast; //Saves and closes the document instance document.Save("TableFormatting.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class (Empty Word Document) Dim document As New WordDocument() 'Opens an existing Word document into DocIO instance document.Open("Table.docx", FormatType.Docx) 'Accesses the instance of the first section in the Word document Dim section As WSection = document.Sections(0) 'Accesses the instance of the first table in the section Dim table As WTable = TryCast(section.Tables(0), WTable) 'Specifies the title for the table table.Title = "PriceDetails" 'Specifies the description of the table table.Description = "This table shows the price details of various fruits" 'Specifies the left indent of the table table.IndentFromLeft = 50 'Specifies the background color of the table table.TableFormat.BackColor = Color.FromArgb(192, 192, 192) 'Specifies the horizontal alignment of the table table.TableFormat.HorizontalAlignment = RowAlignment.Left 'Specifies the left, right, top and bottom padding of all the cells in the table table.TableFormat.Paddings.All = 10 'Specifies the auto resize of table to automatically resize all cell width based on its content table.TableFormat.IsAutoResized = True 'Specifies the table top, bottom, left and right border line width table.TableFormat.Borders.LineWidth = 2.0F 'Specifies the table horizontal border line width table.TableFormat.Borders.Horizontal.LineWidth = 2.0F 'Specifies the table vertical border line width table.TableFormat.Borders.Vertical.LineWidth = 2.0F 'Specifies the tables top, bottom, left and right border color table.TableFormat.Borders.Color = Color.Red 'Specifies the table Horizontal border color table.TableFormat.Borders.Horizontal.Color = Color.Red 'Specifies the table vertical border color table.TableFormat.Borders.Vertical.Color = Color.Red 'Specifies the table borders border type table.TableFormat.Borders.BorderType = BorderStyle.[Double] 'Access the instance of the first row in the table Dim row As WTableRow = table.Rows(0) 'Specifies the row height row.Height = 20 'Specifies the row height type row.HeightType = TableRowHeightType.AtLeast 'Saves and closes the document instance document.Save("TableFormatting.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Applying cell formatting

The following code example illustrates how to load an existing document and apply cell formatting options such as VerticalAlignment, TextDirection, Paddings, Borders, etc.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Loads an existing Word document into DocIO instance FileStream fileStreamPath = new FileStream("Table.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); WSection section = document.Sections[0]; WTable table = section.Tables[0] as WTable; //Accesses the instance of the first row in the table WTableRow row = table.Rows[0]; //Specifies the row height row.Height = 20; //Specifies the row height type row.HeightType = TableRowHeightType.AtLeast; //Accesses the instance of the first cell in the row WTableCell cell = row.Cells[0]; //Specifies the cell back ground color cell.CellFormat.BackColor = Color.FromArgb(192, 192, 192); //Specifies the same padding as table option as false to preserve current cell padding cell.CellFormat.SamePaddingsAsTable = false; //Specifies the left, right, top and bottom padding of the cell cell.CellFormat.Paddings.Left = 5; cell.CellFormat.Paddings.Right = 5; cell.CellFormat.Paddings.Top = 5; cell.CellFormat.Paddings.Bottom = 5; //Specifies the vertical alignment of content of text cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle; //Disables the text wrap option to avoid displaying longer text on multiple lines cell.CellFormat.TextWrap = false; //Sets the text direction for cell cell.CellFormat.TextDirection = TextDirection.VerticalBottomToTop; //Accesses the instance of the second cell in the row cell = row.Cells[1]; cell.CellFormat.BackColor = Color.FromArgb(192, 192, 192); cell.CellFormat.SamePaddingsAsTable = false; //Specifies the left, right, top and bottom padding of the cell cell.CellFormat.Paddings.All = 5; cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle; //Disables the text wrap option to avoid displaying longer text on multiple lines cell.CellFormat.TextWrap = false; //Access the instance of the third cell in the row cell = row.Cells[2]; //Set color for tablecell borders cell.CellFormat.Borders.BorderType = BorderStyle.Thick; cell.CellFormat.Borders.Color = Color.Red; cell.CellFormat.Borders.Top.Color = Color.Red; cell.CellFormat.Borders.Bottom.Color = Color.Red; cell.CellFormat.Borders.Right.Color = Color.Red; cell.CellFormat.Borders.Left.Color = Color.Red; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); document.Open("Table.docx", FormatType.Docx); WSection section = document.Sections[0]; WTable table = section.Tables[0] as WTable; //Accesses the instance of the first row in the table WTableRow row = table.Rows[0]; //Specifies the row height row.Height = 20; //Specifies the row height type row.HeightType = TableRowHeightType.AtLeast; //Accesses the instance of the first cell in the row WTableCell cell = row.Cells[0]; //Specifies the cell back ground color cell.CellFormat.BackColor = Color.FromArgb(192, 192, 192); //Specifies the same padding as table option as false to preserve current cell padding cell.CellFormat.SamePaddingsAsTable = false; //Specifies the left, right, top and bottom padding of the cell cell.CellFormat.Paddings.Left = 5; cell.CellFormat.Paddings.Right = 5; cell.CellFormat.Paddings.Top = 5; cell.CellFormat.Paddings.Bottom = 5; //Specifies the vertical alignment of content of text cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle; //Disables the text wrap option to avoid displaying longer text on multiple lines cell.CellFormat.TextWrap = false; //Sets text direction for cell cell.CellFormat.TextDirection = TextDirection.VerticalBottomToTop; //Accesses the instance of the second cell in the row cell = row.Cells[1]; cell.CellFormat.BackColor = Color.FromArgb(192, 192, 192); cell.CellFormat.SamePaddingsAsTable = false; //Specifies the left, right, top and bottom padding of the cell cell.CellFormat.Paddings.All = 5; cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle; //Disables the text wrap option to avoid displaying longer text on multiple lines cell.CellFormat.TextWrap = false; //Access the instance of the third cell in the row cell = row.Cells[2]; //Set color for tablecell borders cell.CellFormat.Borders.BorderType = BorderStyle.Thick; cell.CellFormat.Borders.Color = Color.Red; cell.CellFormat.Borders.Top.Color = Color.Red; cell.CellFormat.Borders.Bottom.Color = Color.Red; cell.CellFormat.Borders.Right.Color = Color.Red; cell.CellFormat.Borders.Left.Color = Color.Red; //Saves and closes the document instance document.Save("TableCellFormatting.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() document.Open("Table.docx", FormatType.Docx) Dim section As WSection = document.Sections(0) Dim table As WTable = TryCast(section.Tables(0), WTable) 'Accesses the instance of the first row in the table Dim row As WTableRow = table.Rows(0) 'Specifies the row height row.Height = 20 'Specifies the row height type row.HeightType = TableRowHeightType.AtLeast 'Accesses the instance of the first cell in the row Dim cell As WTableCell = row.Cells(0) 'Specifies the cell back ground color cell.CellFormat.BackColor = Color.FromArgb(192, 192, 192) 'Specifies the same padding as table option as false to preserve current cell padding cell.CellFormat.SamePaddingsAsTable = False 'Specifies the left, right, top and bottom padding of the cell cell.CellFormat.Paddings.Left = 5 cell.CellFormat.Paddings.Right = 5 cell.CellFormat.Paddings.Top = 5 cell.CellFormat.Paddings.Bottom = 5 'Specifies the vertical alignment of content of text cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle 'Disables the text wrap option to avoid displaying longer text on multiple lines cell.CellFormat.TextWrap = False 'Sets text direction for cell cell.CellFormat.TextDirection = TextDirection.VerticalBottomToTop 'Accesses the instance of the second cell in the row cell = row.Cells(1) cell.CellFormat.BackColor = Color.FromArgb(192, 192, 192) cell.CellFormat.SamePaddingsAsTable = False 'Specifies the left, right, top and bottom padding of the cell cell.CellFormat.Paddings.All = 5 cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle 'Disables the text wrap option to avoid displaying longer text on multiple lines cell.CellFormat.TextWrap = False 'Access the instance of the third cell in the row cell = row.Cells(2) 'Set color for tablecell borders cell.CellFormat.Borders.BorderType = BorderStyle.Thick cell.CellFormat.Borders.Color = Color.Red cell.CellFormat.Borders.Top.Color = Color.Red cell.CellFormat.Borders.Bottom.Color = Color.Red cell.CellFormat.Borders.Right.Color = Color.Red cell.CellFormat.Borders.Left.Color = Color.Red 'Saves and closes the document instance document.Save("TableCellFormatting.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Resize table

You can automatically resize the table cell to fit its contents based on the given autofit options such as FitToContent, FitToWindow, FixedColumnWidth.

The following code example shows how to resize the table in a Word document.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Loads an existing Word document into DocIO instance FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Resizes the table to fit the contents respect to the contents table.AutoFit(AutoFitType.FitToContent); //Accesses the instance of the second table in the section table = section.Tables[1] as WTable; //Resizes the table to fit the contents respect to window/page width table.AutoFit(AutoFitType.FitToWindow); //Accesses the instance of the third table in the section table = section.Tables[2] as WTable; //Resizes the table to fit the contents respect to fixed column width table.AutoFit(AutoFitType.FixedColumnWidth); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class (Empty Word Document)*'| markdownify }} WordDocument document = new WordDocument(); //Opens an existing Word document into DocIO instance document.Open("Template", FormatType.Docx); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Resizes the table to fit the contents respect to the contents table.AutoFit(AutoFitType.FitToContent); //Accesses the instance of the second table in the section table = section.Tables[1] as WTable; //Resizes the table to fit the contents respect to window/page width table.AutoFit(AutoFitType.FitToWindow); //Accesses the instance of the third table in the section table = section.Tables[2] as WTable; //Resizes the table to fit the contents respect to fixed column width table.AutoFit(AutoFitType.FixedColumnWidth); //Saves and closes the document instance document.Save("Sample.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class (Empty Word Document) Dim document As WordDocument = New WordDocument 'Opens an existing Word document into DocIO instance document.Open("Template", FormatType.Docx) Dim section As WSection = document.Sections(0) Dim table As WTable = CType(section.Tables(0), WTable) 'Resizes the table to fit the contents respect to the contents table.AutoFit(AutoFitType.FitToContent) 'Accesses the instance of the second table in the section table = CType(section.Tables(1), WTable) 'Resizes the table to fit the contents respect to window/page width table.AutoFit(AutoFitType.FitToWindow) 'Accesses the instance of the third table in the section table = CType(section.Tables(2), WTable) 'Resizes the table to fit the contents respect to fixed column width table.AutoFit(AutoFitType.FixedColumnWidth) 'Saves and closes the document instance document.Save("Sample.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

N> In ASP.NET Core, UWP, and Xamarin platforms, to apply autofit for table in a Word document we recommend you to use Word to PDF assemblies or NuGet packages as a reference in your application.

Working with Table Style

A table style defines a set of table, row, cell and paragraph level formatting that can be applied to a table. WTableStyle instance represents table style in a Word document.

N> Essential DocIO currently provides support for table styles in DOCX and WordML formats alone. The visual appearance is also preserved in Word to PDF, Word to Image, and Word to HTML conversions.

The following code example illustrates how to apply the built-in table styles to the table.

{% tabs %}

{% endtabs %}

You can download a complete working sample from GitHub.

Table style options

Once you have applied a table style, you can enable or disable the special formatting of the table. There are six options: first column, last column, banded rows, banded columns, header row and last row.

The following code example illustrates how to enable and disable the special table formatting options of the table styles

{% tabs %}

{% endtabs %}

You can download a complete working sample from GitHub.

Custom table style

The following code example illustrates how to apply a custom table style to table.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class FileStream fileStreamPath = new FileStream("Table.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); WSection section = document.Sections[0]; WTable table = section.Tables[0] as WTable; //Adds a new custom table style WTableStyle tableStyle = document.AddTableStyle("CustomStyle") as WTableStyle; //Applies formatting for whole table tableStyle.TableProperties.RowStripe = 1; tableStyle.TableProperties.ColumnStripe = 1; tableStyle.TableProperties.Paddings.Top = 0; tableStyle.TableProperties.Paddings.Bottom = 0; tableStyle.TableProperties.Paddings.Left = 5.4f; tableStyle.TableProperties.Paddings.Right = 5.4f; //Applies conditional formatting for first row ConditionalFormattingStyle firstRowStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow); firstRowStyle.CharacterFormat.Bold = true; firstRowStyle.CharacterFormat.TextColor = Color.FromArgb(255, 255, 255, 255); firstRowStyle.CellProperties.BackColor = Color.Blue; //Applies conditional formatting for first column ConditionalFormattingStyle firstColumnStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstColumn); firstColumnStyle.CharacterFormat.Bold = true; //Applies conditional formatting for odd row ConditionalFormattingStyle oddRowBandingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding); oddRowBandingStyle.CellProperties.BackColor = Color.WhiteSmoke; //Applies the custom table style to the table table.ApplyStyle("CustomStyle"); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument("Table.docx", FormatType.Docx); WSection section = document.Sections[0]; WTable table = section.Tables[0] as WTable; //Adds a new custom table style WTableStyle tableStyle = document.AddTableStyle("CustomStyle") as WTableStyle; //Applies formatting for whole table tableStyle.TableProperties.RowStripe = 1; tableStyle.TableProperties.ColumnStripe = 1; tableStyle.TableProperties.Paddings.Top = 0; tableStyle.TableProperties.Paddings.Bottom = 0; tableStyle.TableProperties.Paddings.Left = 5.4f; tableStyle.TableProperties.Paddings.Right = 5.4f; //Applies conditional formatting for first row ConditionalFormattingStyle firstRowStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow); firstRowStyle.CharacterFormat.Bold = true; firstRowStyle.CharacterFormat.TextColor = Color.FromArgb(255, 255, 255, 255); firstRowStyle.CellProperties.BackColor = Color.Blue; //Applies conditional formatting for first column ConditionalFormattingStyle firstColumnStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstColumn); firstColumnStyle.CharacterFormat.Bold = true; //Applies conditional formatting for odd row ConditionalFormattingStyle oddRowBandingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding); oddRowBandingStyle.CellProperties.BackColor = Color.WhiteSmoke; //Applies the custom table style to the table table.ApplyStyle("CustomStyle"); //Saves and closes the document instance document.Save("TableStyle.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument("Table.docx", FormatType.Docx) Dim section As WSection = document.Sections(0) Dim table As WTable = TryCast(section.Tables(0), WTable) 'Adds a new custom table style Dim tableStyle As WTableStyle = TryCast(document.AddTableStyle("CustomStyle"), WTableStyle) 'Applies formatting for whole table tableStyle.TableProperties.RowStripe = 1 tableStyle.TableProperties.ColumnStripe = 1 tableStyle.TableProperties.Paddings.Top = 0 tableStyle.TableProperties.Paddings.Bottom = 0 tableStyle.TableProperties.Paddings.Left = 5.4F tableStyle.TableProperties.Paddings.Right = 5.4F 'Applies conditional formatting for first row Dim firstRowStyle As ConditionalFormattingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow) firstRowStyle.CharacterFormat.Bold = True firstRowStyle.CharacterFormat.TextColor = Color.FromArgb(255, 255, 255, 255) firstRowStyle.CellProperties.BackColor = Color.Blue 'Applies conditional formatting for first column Dim firstColumnStyle As ConditionalFormattingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstColumn) firstColumnStyle.CharacterFormat.Bold = True 'Applies conditional formatting for odd row Dim oddRowBandingStyle As ConditionalFormattingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding) oddRowBandingStyle.CellProperties.BackColor = Color.WhiteSmoke 'Applies the custom table style to the table table.ApplyStyle("CustomStyle") 'Saves and closes the document instance document.Save("TableStyle.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Apply Base Style

Table styles can be based on other table styles also. When applying a base style, the new style will inherit the values of the base style that are not explicitly redefined in the new style. You can apply a custom table style or a built-in table style as a base for the table style.

The following code example illustrates how to apply built-in and custom table styles as base styles for another custom table.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Create a new Word document. using (WordDocument document = new WordDocument()) { //Add one section and paragraph to the document. document.EnsureMinimal(); //Add a table to the Word document. WTable table = document.LastSection.AddTable() as WTable; table.ResetCells(3, 2); table[0, 0].AddParagraph().AppendText("Row 1 Cell 1"); table[0, 1].AddParagraph().AppendText("Row 1 Cell 2"); table[1, 0].AddParagraph().AppendText("Row 2 Cell 1"); table[1, 1].AddParagraph().AppendText("Row 2 Cell 2"); table[2, 0].AddParagraph().AppendText("Row 3 Cell 1"); table[2, 1].AddParagraph().AppendText("Row 3 Cell2"); //Add a new custom table style. WTableStyle tableStyle = document.AddTableStyle("CustomStyle1") as WTableStyle; tableStyle.TableProperties.RowStripe = 1; //Apply conditional formatting for the first row. ConditionalFormattingStyle firstRowStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow); firstRowStyle.CharacterFormat.Bold = true; //Apply conditional formatting for the odd row. ConditionalFormattingStyle oddRowBandingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding); oddRowBandingStyle.CharacterFormat.Italic = true; // Apply built in table style as base style for CustomStyle1. tableStyle.ApplyBaseStyle(BuiltinTableStyle.TableContemporary); //Apply the custom table style to the table. table.ApplyStyle("CustomStyle1");

document.LastSection.AddParagraph();
//Create another table in the Word document.
table = document.LastSection.AddTable() as WTable;
table.ResetCells(3, 2);
table[0, 0].AddParagraph().AppendText("Row 1 Cell 1");
table[0, 1].AddParagraph().AppendText("Row 1 Cell 2");
table[1, 0].AddParagraph().AppendText("Row 2 Cell 1");
table[1, 1].AddParagraph().AppendText("Row 2 Cell 2");
table[2, 0].AddParagraph().AppendText("Row 3 Cell 1");
table[2, 1].AddParagraph().AppendText("Row 3 Cell2");

//Add a new custom table style.
tableStyle = document.AddTableStyle("CustomStyle2") as WTableStyle;
tableStyle.TableProperties.RowStripe = 1;
//Apply conditional formatting for the first row.
firstRowStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow);
firstRowStyle.ParagraphFormat.HorizontalAlignment = HorizontalAlignment.Center;
//Apply conditional formatting for the odd row.
oddRowBandingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding);
oddRowBandingStyle.CharacterFormat.TextColor = Color.Red;

//Add a new custom table style.
WTableStyle tableStyle2 = document.AddTableStyle("CustomStyle3") as WTableStyle;
tableStyle2.TableProperties.RowStripe = 1;
//Apply conditional formatting for the first row.
ConditionalFormattingStyle firstRowStyle2 = tableStyle2.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow);
firstRowStyle2.CellProperties.BackColor = Color.Blue;
//Apply conditional formatting for the odd row.
ConditionalFormattingStyle oddRowStyle2 = tableStyle2.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding);
oddRowStyle2.CellProperties.BackColor = Color.Yellow;
//Apply custom table style as base style for another custom table style.
tableStyle2.ApplyBaseStyle("CustomStyle2");
//Apply the custom table style to the table.
table.ApplyStyle("CustomStyle3");

//Save the Word document to the MemoryStream.
MemoryStream outputStream = new MemoryStream();
document.Save(outputStream, FormatType.Docx);
//Closes the document
document.Close();

} {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Create a new Word document. using (WordDocument document = new WordDocument()) { //Add one section and paragraph to the document. document.EnsureMinimal(); //Add a table to the Word document. WTable table = document.LastSection.AddTable() as WTable; table.ResetCells(3, 2); table[0, 0].AddParagraph().AppendText("Row 1 Cell 1"); table[0, 1].AddParagraph().AppendText("Row 1 Cell 2"); table[1, 0].AddParagraph().AppendText("Row 2 Cell 1"); table[1, 1].AddParagraph().AppendText("Row 2 Cell 2"); table[2, 0].AddParagraph().AppendText("Row 3 Cell 1"); table[2, 1].AddParagraph().AppendText("Row 3 Cell2"); //Add a new custom table style. WTableStyle tableStyle = document.AddTableStyle("CustomStyle1") as WTableStyle; tableStyle.TableProperties.RowStripe = 1; //Apply conditional formatting for the first row. ConditionalFormattingStyle firstRowStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow); firstRowStyle.CharacterFormat.Bold = true; //Apply conditional formatting for the odd row. ConditionalFormattingStyle oddRowBandingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding); oddRowBandingStyle.CharacterFormat.Italic = true; // Apply built-in table style as base style for CustomStyle1. tableStyle.ApplyBaseStyle(BuiltinTableStyle.TableContemporary); //Apply the custom table style to the table. table.ApplyStyle("CustomStyle1");

document.LastSection.AddParagraph();
//Create another table in the Word document.
table = document.LastSection.AddTable() as WTable;
table.ResetCells(3, 2);
table[0, 0].AddParagraph().AppendText("Row 1 Cell 1");
table[0, 1].AddParagraph().AppendText("Row 1 Cell 2");
table[1, 0].AddParagraph().AppendText("Row 2 Cell 1");
table[1, 1].AddParagraph().AppendText("Row 2 Cell 2");
table[2, 0].AddParagraph().AppendText("Row 3 Cell 1");
table[2, 1].AddParagraph().AppendText("Row 3 Cell2");

//Add a new custom table style.
tableStyle = document.AddTableStyle("CustomStyle2") as WTableStyle;
tableStyle.TableProperties.RowStripe = 1;
//Apply conditional formatting for the first row.
firstRowStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow);
firstRowStyle.ParagraphFormat.HorizontalAlignment = HorizontalAlignment.Center;
//Apply conditional formatting for the odd row.
oddRowBandingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding);
oddRowBandingStyle.CharacterFormat.TextColor = Color.Red;

//Add a new custom table style.
WTableStyle tableStyle2 = document.AddTableStyle("CustomStyle3") as WTableStyle;
tableStyle2.TableProperties.RowStripe = 1;
//Apply conditional formatting for the first row.
ConditionalFormattingStyle firstRowStyle2 = tableStyle2.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow);
firstRowStyle2.CellProperties.BackColor = Color.Blue;
//Apply conditional formatting for the odd row.
ConditionalFormattingStyle oddRowStyle2 = tableStyle2.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding);
oddRowStyle2.CellProperties.BackColor = Color.Yellow;
//Apply custom table style as base style for another custom table style.
tableStyle2.ApplyBaseStyle("CustomStyle2");
//Apply the custom table style to the table.
table.ApplyStyle("CustomStyle3");

//Save a Word document.
document.Save("Sample.docx", FormatType.Docx);

} {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Create a new Word document. Using document As WordDocument = New WordDocument() 'Add one section and paragraph to the document. document.EnsureMinimal() 'Add a table to the Word document. Dim table As WTable = TryCast(document.LastSection.AddTable(), WTable) table.ResetCells(3, 2) table(0, 0).AddParagraph().AppendText("Row 1 Cell 1") table(0, 1).AddParagraph().AppendText("Row 1 Cell 2") table(1, 0).AddParagraph().AppendText("Row 2 Cell 1") table(1, 1).AddParagraph().AppendText("Row 2 Cell 2") table(2, 0).AddParagraph().AppendText("Row 3 Cell 1") table(2, 1).AddParagraph().AppendText("Row 3 Cell2") 'Add a new custom table style. Dim tableStyle As WTableStyle = TryCast(document.AddTableStyle("CustomStyle1"), WTableStyle) tableStyle.TableProperties.RowStripe = 1 'Apply conditional formatting for the first row. Dim firstRowStyle As ConditionalFormattingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow) firstRowStyle.CharacterFormat.Bold = True 'Apply conditional formatting for the odd row. Dim oddRowBandingStyle As ConditionalFormattingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding) oddRowBandingStyle.CharacterFormat.Italic = True ' Apply built in table style as base style for CustomStyle1. tableStyle.ApplyBaseStyle(BuiltinTableStyle.TableContemporary) 'Apply the custom table style to the table. table.ApplyStyle("CustomStyle1")

document.LastSection.AddParagraph()
'Create another table in the Word document.
table = TryCast(document.LastSection.AddTable(), WTable)
table.ResetCells(3, 2)
table(0, 0).AddParagraph().AppendText("Row 1 Cell 1")
table(0, 1).AddParagraph().AppendText("Row 1 Cell 2")
table(1, 0).AddParagraph().AppendText("Row 2 Cell 1")
table(1, 1).AddParagraph().AppendText("Row 2 Cell 2")
table(2, 0).AddParagraph().AppendText("Row 3 Cell 1")
table(2, 1).AddParagraph().AppendText("Row 3 Cell2")

'Add a new custom table style.
tableStyle = TryCast(document.AddTableStyle("CustomStyle2"), WTableStyle)
tableStyle.TableProperties.RowStripe = 1
'Apply conditional formatting for the first row.
firstRowStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow)
firstRowStyle.ParagraphFormat.HorizontalAlignment = HorizontalAlignment.Center
'Apply conditional formatting for the odd row.
oddRowBandingStyle = tableStyle.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding)
oddRowBandingStyle.CharacterFormat.TextColor = Color.Red

'Add a new custom table style.
Dim tableStyle2 As WTableStyle = TryCast(document.AddTableStyle("CustomStyle3"), WTableStyle)
tableStyle2.TableProperties.RowStripe = 1
'Apply conditional formatting for the first row.
Dim firstRowStyle2 As ConditionalFormattingStyle = tableStyle2.ConditionalFormattingStyles.Add(ConditionalFormattingType.FirstRow)
firstRowStyle2.CellProperties.BackColor = Color.Blue
'Apply conditional formatting for the odd row.
Dim oddRowStyle2 As ConditionalFormattingStyle = tableStyle2.ConditionalFormattingStyles.Add(ConditionalFormattingType.OddRowBanding)
oddRowStyle2.CellProperties.BackColor = Color.Yellow
'Apply custom table style as base style for another custom table style.
tableStyle2.ApplyBaseStyle("CustomStyle2")
'Apply the custom table style to the table.
table.ApplyStyle("CustomStyle3")

'Save a Word document.
document.Save("Sample.docx", FormatType.Docx)

End Using {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Merging cells vertically and horizontally

You can combine two or more table cells located in the same row or column into a single cell.

The following code example illustrates how to apply horizontal merge to specified range of cells in a specified row.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Horizontal merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(5, 5); //Specifies the horizontal merge from second cell to fifth cell in third row table.ApplyHorizontalMerge(2, 1, 4); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Horizontal merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(5, 5); //Specifies the horizontal merge from second cell to fifth cell in third row table.ApplyHorizontalMerge(2, 1, 4); //Saves and closes the document instance document.Save("HorizontalMerge.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() Dim section As IWSection = document.AddSection() section.AddParagraph().AppendText("Horizontal merging of Table cells") Dim table As IWTable = section.AddTable() table.ResetCells(5, 5) 'Specifies the horizontal merge from second cell to fifth cell in third row table.ApplyHorizontalMerge(2, 1, 4) 'Saves and closes the document instance document.Save("HorizontalMerge.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

The following code example illustrates how to apply vertical merge to specified range of rows in a specified column.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Vertical merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(5, 5); // Specifies the vertical merge to the third cell, from second row to fifth row table.ApplyVerticalMerge(2, 1, 4); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Vertical merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(5, 5); //Specifies the vertical merge to the third cell, from second row to fifth row table.ApplyVerticalMerge(2, 1, 4); //Saves and closes the document instance document.Save("VerticalMerge.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() Dim section As IWSection = document.AddSection() section.AddParagraph().AppendText("Vertical merging of Table cells") Dim table As IWTable = section.AddTable() table.ResetCells(5, 5) 'Specifies the vertical merge to the third cell, from second row to fifth row table.ApplyVerticalMerge(2, 1, 4) 'Saves and closes the document instance document.Save("VerticalMerge.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

The following code example illustrate how to create a table that contains horizontal merged cells.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Horizontal merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(2, 2); //Adds content to table cell table[0, 0].AddParagraph().AppendText("First row, First cell"); table[0, 1].AddParagraph().AppendText("First row, Second cell"); table[1, 0].AddParagraph().AppendText("Second row, First cell"); table[1, 1].AddParagraph().AppendText("Second row, Second cell"); //Specifies the horizontal merge start to first row, first cell table[0, 0].CellFormat.HorizontalMerge = CellMerge.Start; //Modifies the cell content table[0, 0].Paragraphs[0].Text = "Horizontally merged cell"; //Specifies the horizontal merge continue to second row second cell table[0, 1].CellFormat.HorizontalMerge = CellMerge.Continue; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Horizontal merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(2, 2); //Adds content to table cell table[0, 0].AddParagraph().AppendText("First row, First cell"); table[0, 1].AddParagraph().AppendText("First row, Second cell"); table[1, 0].AddParagraph().AppendText("Second row, First cell"); table[1, 1].AddParagraph().AppendText("Second row, Second cell"); //Specifies the horizontal merge start to first row, first cell table[0, 0].CellFormat.HorizontalMerge = CellMerge.Start; //Modifies the cell content table[0, 0].Paragraphs[0].Text = "Horizontally merged cell"; //Specifies the horizontal merge continue to second row second cell table[0, 1].CellFormat.HorizontalMerge = CellMerge.Continue; //Saves and closes the document instance document.Save("HorizontalMerge.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() Dim section As IWSection = document.AddSection() section.AddParagraph().AppendText("Horizontal merging of Table cells") Dim table As IWTable = section.AddTable() table.ResetCells(2, 2) 'Adds content to table cell table(0, 0).AddParagraph().AppendText("First row, First cell") table(0, 1).AddParagraph().AppendText("First row, Second cell") table(1, 0).AddParagraph().AppendText("Second row, First cell") table(1, 1).AddParagraph().AppendText("Second row, Second cell") 'Specifies the horizontal merge start to first row, first cell table(0, 0).CellFormat.HorizontalMerge = CellMerge.Start 'Modifies the cell content table(0, 0).Paragraphs(0).Text = "Horizontally merged cell" 'Specifies the horizontal merge continue to second row second cell table(0, 1).CellFormat.HorizontalMerge = CellMerge.[Continue] 'Saves and closes the document instance document.Save("HorizontalMerge.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

The following code example illustrates how to create a table with vertical merged cells.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Vertical merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(2, 2); //Adds content to table cells table[0, 0].AddParagraph().AppendText("First row, First cell"); table[0, 1].AddParagraph().AppendText("First row, Second cell"); table[1, 0].AddParagraph().AppendText("Second row, First cell"); table[1, 1].AddParagraph().AppendText("Second row, Second cell"); //Specifies the vertical merge start to first row first cell table[0, 0].CellFormat.VerticalMerge = CellMerge.Start; //Modifies the cell content table[0, 0].Paragraphs[0].Text = "Vertically merged cell"; //Specifies the vertical merge continue to second row first cell table[1, 0].CellFormat.VerticalMerge = CellMerge.Continue; //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); section.AddParagraph().AppendText("Vertical merging of Table cells"); IWTable table = section.AddTable(); table.ResetCells(2, 2); //Adds content to table cells table[0, 0].AddParagraph().AppendText("First row, First cell"); table[0, 1].AddParagraph().AppendText("First row, Second cell"); table[1, 0].AddParagraph().AppendText("Second row, First cell"); table[1, 1].AddParagraph().AppendText("Second row, Second cell"); //Specifies the vertical merge start to first row first cell table[0, 0].CellFormat.VerticalMerge = CellMerge.Start; //Modifies the cell content table[0, 0].Paragraphs[0].Text = "Vertically merged cell"; //Specifies the vertical merge continue to second row first cell table[1, 0].CellFormat.VerticalMerge = CellMerge.Continue; //Saves and closes the document instance document.Save("VerticalMerge.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() Dim section As IWSection = document.AddSection() section.AddParagraph().AppendText("Vertical merging of Table cells") Dim table As IWTable = section.AddTable() table.ResetCells(2, 2) 'Adds content to table cells table(0, 0).AddParagraph().AppendText("First row, First cell") table(0, 1).AddParagraph().AppendText("First row, Second cell") table(1, 0).AddParagraph().AppendText("Second row, First cell") table(1, 1).AddParagraph().AppendText("Second row, Second cell") 'Specifies the vertical merge start to first row first cell table(0, 0).CellFormat.VerticalMerge = CellMerge.Start 'Modifies the cell content table(0, 0).Paragraphs(0).Text = "Vertically merged cell" 'Specifies the vertical merge continue to second row first cell table(1, 0).CellFormat.VerticalMerge = CellMerge.[Continue] 'Saves and closes the document instance document.Save("VerticalMerge.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Specifying table header row to repeat on each page

You can specify one or more rows in a table to be repeated as header row at the top of each page, when the table spans across multiple pages.

In the case of a single header row, it must be the first row in the table.
In the case of multiple header rows, then header rows must be consecutive from the first row of the table.

N> Heading rows do not have any effect with nested tables in Microsoft Word as well as DocIO

The following code example illustrates how to create a table with a single header row.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); IWTable table = section.AddTable(); table.ResetCells(50, 1); WTableRow row = table.Rows[0]; //Specifies the first row as a header row of the table row.IsHeader = true; row.Height = 20; row.HeightType = TableRowHeightType.AtLeast; row.Cells[0].AddParagraph().AppendText("Header Row"); for (int i = 1; i < 50; i++) { row = table.Rows[i]; row.Height = 20; row.HeightType = TableRowHeightType.AtLeast; row.Cells[0].AddParagraph().AppendText("Text in Row" + i.ToString()); } //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument(); IWSection section = document.AddSection(); IWTable table = section.AddTable(); table.ResetCells(50, 1); WTableRow row = table.Rows[0]; //Specifies the first row as a header row of the table row.IsHeader = true; row.Height = 20; row.HeightType = TableRowHeightType.AtLeast; row.Cells[0].AddParagraph().AppendText("Header Row"); for (int i = 1; i < 50; i++) { row = table.Rows[i]; row.Height = 20; row.HeightType = TableRowHeightType.AtLeast; row.Cells[0].AddParagraph().AppendText("Text in Row" + i.ToString()); } //Saves and closes the document instance document.Save("TableWithHeaderRow.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument() Dim section As IWSection = document.AddSection() Dim table As IWTable = section.AddTable() table.ResetCells(50, 1) Dim row As WTableRow = table.Rows(0) 'Specifies the first row as a header row of the table row.IsHeader = True row.Height = 20 row.HeightType = TableRowHeightType.AtLeast row.Cells(0).AddParagraph().AppendText("Header Row") For i As Integer = 1 To 49 row = table.Rows(i) row.Height = 20 row.HeightType = TableRowHeightType.AtLeast row.Cells(0).AddParagraph().AppendText("Text in Row" + i.ToString()) Next 'Saves and closes the document instance document.Save("TableWithHeaderRow.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Keeping rows from breaking across pages

You can enable or disable the table row content to split across multiple pages, when the row contents do not fit in a previous page.

The following code example illustrates how to disable all the table rows from splitting across multiple pages.

{% tabs %}

{% endtabs %}

You can download a complete working sample from GitHub.

Iterating through table elements

The following code example illustrates how to iterate through the table and apply back color to a particular cell.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); WSection section = document.Sections[0]; WTable table = section.Tables[0] as WTable; //Iterates the rows of the table foreach (WTableRow row in table.Rows) { //Iterates through the cells of rows foreach (WTableCell cell in row.Cells) { //Iterates through the paragraphs of the cell foreach (WParagraph paragraph in cell.Paragraphs) { //When the paragraph contains text Panda then apply green as back color to cell if (paragraph.Text.Contains("panda")) cell.CellFormat.BackColor = Color.Green; } } } //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument("Template.docx"); WSection section = document.Sections[0]; WTable table = section.Tables[0] as WTable; //Iterates the rows of the table foreach (WTableRow row in table.Rows) { //Iterates through the cells of rows foreach (WTableCell cell in row.Cells) { //Iterates through the paragraphs of the cell foreach (WParagraph paragraph in cell.Paragraphs) { //When the paragraph contains text Panda then apply green as back color to cell if (paragraph.Text.Contains("panda")) cell.CellFormat.BackColor = Color.Green; } } } //Saves and closes the document instance document.Save("Sample.docx", FormatType.Docx); document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument("Template.docx") Dim section As WSection = document.Sections(0) Dim table As WTable = TryCast(section.Tables(0), WTable) 'Iterates the rows of the table For Each row As WTableRow In table.Rows 'Iterates through the cells of rows For Each cell As WTableCell In row.Cells 'Iterates through the paragraphs of the cell For Each paragraph As WParagraph In cell.Paragraphs 'When the paragraph contains text Panda then apply green as back color to cell If paragraph.Text.Contains("panda") Then cell.CellFormat.BackColor = Color.Green End If Next Next Next 'Saves and closes the document instance document.Save("Sample.docx", FormatType.Docx) document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Removing the table

You can remove a table from a text body by its instance or by its index position in the text body item collection. The following code example shows how to remove a table in Word document.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Removes a table from the text body section.Body.ChildEntities.Remove(table); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument("Template.docx"); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Removes a table from the text body section.Body.ChildEntities.Remove(table); //Saves the Word document document.Save("Sample.docx", FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument("Template.docx") 'Accesses the instance of the first section in the Word document Dim section As WSection = document.Sections(0) 'Accesses the instance of the first table in the section Dim table As WTable = TryCast(section.Tables(0), WTable) 'Removes a table from the text body section.Body.ChildEntities.Remove(table) 'Saves the Word document document.Save("Sample.docx", FormatType.Docx) 'Closes the document document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Removing the table rows

You can remove a particular table row from a table rows collection by its instance or by its index position in the collection. The following code example shows how to remove a particular row from table in the Word document.

{% tabs %}

{% highlight c# tabtitle="C# [Cross-platform]" %} //Creates an instance of WordDocument class FileStream fileStreamPath = new FileStream("Template.docx", FileMode.Open, FileAccess.Read, FileShare.ReadWrite); WordDocument document = new WordDocument(fileStreamPath, FormatType.Docx); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Remove particular row from the table table.Rows.RemoveAt(6); //Saves the Word document to MemoryStream MemoryStream stream = new MemoryStream(); document.Save(stream, FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight c# tabtitle="C# [Windows-specific]" %} //Creates an instance of WordDocument class WordDocument document = new WordDocument("Template.docx"); //Accesses the instance of the first section in the Word document WSection section = document.Sections[0]; //Accesses the instance of the first table in the section WTable table = section.Tables[0] as WTable; //Remove particular row from the table table.Rows.RemoveAt(6); //Saves the Word document document.Save("Sample.docx", FormatType.Docx); //Closes the document document.Close(); {% endhighlight %}

{% highlight vb.net tabtitle="VB.NET [Windows-specific]" %} 'Creates an instance of WordDocument class Dim document As New WordDocument("Template.docx") 'Accesses the instance of the first section in the Word document Dim section As WSection = document.Sections(0) 'Accesses the instance of the first table in the section Dim table As WTable = TryCast(section.Tables(0), WTable) 'Remove particular row from the table table.Rows.RemoveAt(6) 'Saves the Word document document.Save("Sample.docx", FormatType.Docx) 'Closes the document document.Close() {% endhighlight %}

{% endtabs %}

You can download a complete working sample from GitHub.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Working with Tables in Word document

Nested Table

Align text within a table

Insert Image to Table Cell

Apply formatting to Table, Row and Cell

Applying cell formatting

Resize table

Working with Table Style

Table style options

Custom table style

Apply Base Style

Merging cells vertically and horizontally

Specifying table header row to repeat on each page

Keeping rows from breaking across pages

Iterating through table elements

Removing the table

Removing the table rows

See Also

FilesExpand file tree

Working-with-Tables.md

Latest commit

History

Working-with-Tables.md

File metadata and controls

Working with Tables in Word document

Nested Table

Align text within a table

Insert Image to Table Cell

Apply formatting to Table, Row and Cell

Applying cell formatting

Resize table

Working with Table Style

Table style options

Custom table style

Apply Base Style

Merging cells vertically and horizontally

Specifying table header row to repeat on each page

Keeping rows from breaking across pages

Iterating through table elements

Removing the table

Removing the table rows

See Also