使用C#實現插入各種表格到Word文檔

更新時間：2025年11月27日 08:27:19 作者：Eiceblue

在許多企業(yè)應用場景中,Word 文檔依舊是最常用的信息呈現與內容輸出格式,下面將介紹在 C# 中如何以編程方式創(chuàng)建 Word 文檔、插入表格、設置樣式,并擴展到動態(tài)行列與嵌套表格等高級操作,希望對大家有所幫助

在許多企業(yè)應用場景中，Word 文檔依舊是最常用的信息呈現與內容輸出格式。批量生成合同、輸出數據報表、構建結構化文檔時，表格往往是不可或缺的組成部分。為了提高效率，使用 C# 自動創(chuàng)建、插入并格式化 Word 表格，已經成為許多系統(tǒng)中的標準能力。

本文將介紹在 C# 中如何以編程方式創(chuàng)建 Word 文檔、插入表格、設置樣式，并擴展到動態(tài)行列與嵌套表格等高級操作。

文中示例基于 Free Spire.Doc for .NET 實現，如需使用，可通過 NuGet 安裝：Install-Package FreeSpire.Doc。

1. Word 文檔對象模型（基于 Free Spire.Doc for .NET）

要熟練操作表格，了解 Word 文檔的對象結構十分重要。Free Spire.Doc for .NET 的 DOM（Document Object Model）與 Microsoft Word 文檔結構基本一致，主要對象包括：

Document：表示整個 Word 文檔
Section：文檔的分節(jié)區(qū)域，每個 Section 內可以包含多個內容塊
Body：Section 的主體內容區(qū)域
Table：表格對象
TableRow：表格中的一行
TableCell：表格單元格
Paragraph：單元格或正文中的段落
TextRange：段落中的實際文本
ParagraphStyle：段落樣式，用于統(tǒng)一設置字體、字號、對齊方式等

理解這些對象的層級關系，可以幫助你更靈活地控制表格結構、樣式與數據填充。

2. 創(chuàng)建并插入基礎表格

下面示例演示如何創(chuàng)建 Word 文檔、插入一個固定行列的表格，并填充表頭與數據內容。

using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;

public class TableInsertion
{
    public static void InsertBasicTable(string filePath)
    {
        // 創(chuàng)建一個新的Word文檔
        Document document = new Document();
        Section section = document.AddSection();

        // 添加一個段落作為表格的標題
        Paragraph titleParagraph = section.AddParagraph();
        TextRange tr = titleParagraph.AppendText("產品銷售數據表");
        titleParagraph.Format.HorizontalAlignment = HorizontalAlignment.Center;
        tr.CharacterFormat.FontName = "微軟雅黑";
        tr.CharacterFormat.FontSize = 16;
        tr.CharacterFormat.Bold = true;

        // 添加一個普通段落作為表格前的間距
        section.AddParagraph().AppendText("\n");

        // 創(chuàng)建一個表格，指定行數和列數
        Table table = section.AddTable();
        table.ResetCells(5, 4); // 5行4列

        // 設置表格的默認邊框
        table.TableFormat.Borders.BorderType = BorderStyle.Single;
        table.TableFormat.Borders.LineWidth = 1f;

        // 創(chuàng)建表頭和數據行樣式
        ParagraphStyle headerStyle = document.AddParagraphStyle("headerStyle");
        headerStyle.ParagraphFormat.HorizontalAlignment = HorizontalAlignment.Center;
        headerStyle.CharacterFormat.FontName = "微軟雅黑";
        headerStyle.CharacterFormat.FontSize = 14;
        headerStyle.CharacterFormat.Bold = true;
        ParagraphStyle dataStyle = document.AddParagraphStyle("dataStyle");
        dataStyle.ParagraphFormat.HorizontalAlignment = HorizontalAlignment.Center;
        dataStyle.CharacterFormat.FontName = "微軟雅黑";
        dataStyle.CharacterFormat.FontSize = 12;

        // 填充表格數據
        string[] headers = { "產品ID", "產品名稱", "銷售數量", "銷售額" };
        string[,] data = {
            { "P001", "筆記本電腦", "150", "150000" },
            { "P002", "智能手機", "300", "210000" },
            { "P003", "平板電腦", "100", "80000" },
            { "P004", "智能手表", "200", "40000" }
        };

        // 填充表頭
        for (int i = 0; i < headers.Length; i++)
        {
            TableCell cell = table.Rows[0].Cells[i];
            Paragraph p = cell.AddParagraph();
            p.AppendText(headers[i]);
            p.ApplyStyle(headerStyle.Name);
            cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle;
        }

        // 填充數據行
        for (int r = 0; r < data.GetLength(0); r++)
        {
            for (int c = 0; c < data.GetLength(1); c++)
            {
                TableCell cell = table.Rows[r + 1].Cells[c]; // 從第二行開始填充數據
                Paragraph p = cell.AddParagraph();
                p.AppendText(data[r, c]);
                p.ApplyStyle(dataStyle.Name);
                cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle;
            }
        }

        // 保存文檔
        document.SaveToFile(filePath, FileFormat.Docx);
        Console.WriteLine($"文檔已保存到: {filePath}");
    }
    static void Main(string[] args)
    {
        InsertBasicTable("Table.docx");
    }
}

結果文檔預覽

說明

Document → 創(chuàng)建文檔對象
Section → 在文檔中添加分節(jié)
AddTable() → 創(chuàng)建表格
ResetCells(rows, columns) → 指定初始行列數
cell.AddParagraph().AppendText() → 填充單元格文本
table.TableFormat.Borders → 設置表格整體邊框

該示例適用于結構固定的報表，如月度統(tǒng)計表、產品清單等。

3. 設置表格格式與樣式

實際項目中，僅插入表格是不夠的，還需要對布局和樣式進行控制，以提升可讀性。以下示例展示了更復雜的表格格式化過程，包括列寬、行高、背景色、合并單元格和應用段落樣式等。

using System.Drawing; // 引入System.Drawing命名空間處理顏色
using Spire.Doc;
using Spire.Doc.Documents;
using Spire.Doc.Fields;

public class TableFormatting
{
    public static void FormatComplexTable(string filePath)
    {
        Document document = new Document();
        Section section = document.AddSection();

        TextRange tr = section.AddParagraph().AppendText("\n復雜表格示例");
        tr.CharacterFormat.FontName = "宋體";
        tr.CharacterFormat.FontSize = 16;
        section.AddParagraph().AppendText("\n");

        Table table = section.AddTable();
        table.ResetCells(5, 5); // 5行4列

        // 設置表格的默認邊框
        table.TableFormat.Borders.BorderType = BorderStyle.Single;
        table.TableFormat.Borders.LineWidth = 0.5f;
        table.TableFormat.Borders.Color = Color.LightGray;

        // 設置列寬
        foreach (TableRow row in table.Rows)
        {
            row.Cells[0].SetCellWidth(100, CellWidthType.Point);
            row.Cells[1].SetCellWidth(150, CellWidthType.Point);
            row.Cells[2].SetCellWidth(80, CellWidthType.Point);
            row.Cells[3].SetCellWidth(120, CellWidthType.Point);
            row.Cells[4].SetCellWidth(100, CellWidthType.Point);
        }

        // 設置第一行（表頭）的格式
        TableRow headerRow = table.Rows[0];
        headerRow.Height = 25;
        headerRow.HeightType = TableRowHeightType.Exactly;
        ParagraphStyle headerStyle = document.AddParagraphStyle("headerStyle");
        headerStyle.CharacterFormat.Bold = true;
        headerStyle.CharacterFormat.FontName = "黑體";
        headerStyle.CharacterFormat.FontSize = 13;
        headerStyle.ParagraphFormat.HorizontalAlignment = HorizontalAlignment.Center;
        foreach (TableCell cell in headerRow.Cells)
        {
            cell.CellFormat.BackColor = Color.FromArgb(192, 192, 192); // 灰色背景
            cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle;
            Paragraph p = cell.AddParagraph();
            p.ApplyStyle(headerStyle.Name);
        }
        headerRow.Cells[0].Paragraphs[0].AppendText("區(qū)域");
        headerRow.Cells[1].Paragraphs[0].AppendText("銷售經理");
        headerRow.Cells[2].Paragraphs[0].AppendText("Q1銷售");
        headerRow.Cells[3].Paragraphs[0].AppendText("Q2銷售");
        headerRow.Cells[4].Paragraphs[0].AppendText("總銷售額");

        // 單元格合并示例：合并第一列的第2、3行
        table.ApplyVerticalMerge(0, 1, 2);
        table.Rows[1].Cells[0].CellFormat.VerticalAlignment = VerticalAlignment.Middle;
        table.Rows[1].Cells[0].AddParagraph().AppendText("華北區(qū)");

        // 填充數據行
        string[,] data = {
            { "張三", "12000", "15000", "27000" },
            { "李四", "10000", "13000", "23000" },
            { "王五", "18000", "20000", "38000" },
            { "趙六", "16000", "19000", "35000" }
        };

        for (int r = 0; r < data.GetLength(0); r++)
        {
            TableRow dataRow = table.Rows[r + 1]; // 從第二行開始，跳過已合并的行
            if (r == 0) // 第一行數據對應華北區(qū)合并單元格的第二行
            {
                dataRow.Cells[1].AddParagraph().AppendText(data[r, 0]);
                dataRow.Cells[2].AddParagraph().AppendText(data[r, 1]);
                dataRow.Cells[3].AddParagraph().AppendText(data[r, 2]);
                dataRow.Cells[4].AddParagraph().AppendText(data[r, 3]);
            }
            else if (r == 1) // 第二行數據對應華北區(qū)合并單元格的第三行
            {
                dataRow.Cells[1].AddParagraph().AppendText(data[r, 0]);
                dataRow.Cells[2].AddParagraph().AppendText(data[r, 1]);
                dataRow.Cells[3].AddParagraph().AppendText(data[r, 2]);
                dataRow.Cells[4].AddParagraph().AppendText(data[r, 3]);
            }
            else // 其他行正常填充
            {
                // 合并"華南區(qū)"
                table.ApplyVerticalMerge(0, r + 1, 4);
                table.Rows[r + 1].Cells[0].CellFormat.VerticalAlignment = VerticalAlignment.Middle;
                table.Rows[r + 1].Cells[0].AddParagraph().AppendText("華南區(qū)");
                table.Rows[r + 1].Cells[0].AddParagraph().Format.HorizontalAlignment = HorizontalAlignment.Center;

                dataRow = table.Rows[r + 1];
                dataRow.Cells[1].AddParagraph().AppendText(data[r, 0]);
                dataRow.Cells[2].AddParagraph().AppendText(data[r, 1]);
                dataRow.Cells[3].AddParagraph().AppendText(data[r, 2]);
                dataRow.Cells[4].AddParagraph().AppendText(data[r, 3]);
            }

            foreach (TableCell cell in dataRow.Cells)
            {
                cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle;
                if (cell.Paragraphs.Count > 0)
                    cell.Paragraphs[0].Format.HorizontalAlignment = HorizontalAlignment.Center;
            }
        }

        // 確保所有單元格都有段落
        foreach (TableRow row in table.Rows)
        {
            foreach (TableCell cell in row.Cells)
            {
                if (cell.Paragraphs.Count == 0)
                {
                    cell.AddParagraph();
                }
            }
        }
        // 創(chuàng)建并應用數據行樣式
        ParagraphStyle dataStyle = document.AddParagraphStyle("dataStyle");
        dataStyle.CharacterFormat.FontSize = 12;
        dataStyle.CharacterFormat.FontName = "黑體";
        for (int rowIndex = 1; rowIndex < table.Rows.Count; rowIndex++)
        {
            TableRow row = table.Rows[rowIndex];
            foreach (TableCell cell in row.Cells)
            {
                cell.Paragraphs[0].ApplyStyle(dataStyle.Name);
            }
        }

        document.SaveToFile(filePath, FileFormat.Docx);
        Console.WriteLine($"格式化文檔已保存到: {filePath}");
    }
    static void Main(string[] args)
    {
        FormatComplexTable("ComplexTable.docx");
    }
}

結果文檔預覽

說明

列寬設置：通過 SetCellWidth() 精確設置列寬，使整體布局更整齊。
行高控制：TableRow.Height 與 HeightType 允許使用固定行高或自適應高度。
背景色與邊框：使用 CellFormat.BackColor 和 Borders 提升表格視覺層次。
合并單元格：ApplyVerticalMerge() 和 ApplyHorizontalMerge() 可用于制作更復雜的表頭結構。注意：合并后只有左上角有效單元格可以繼續(xù)填充內容。
段落樣式統(tǒng)一管理：使用 ParagraphStyle 可以對字體、字號、加粗、對齊方式進行統(tǒng)一配置，再通過 p.ApplyStyle() 應用于多個單元格，避免重復設置。

4. 更多表格操作：動態(tài)行/列操作與嵌套表格

在數據量不固定的場景（如根據數據庫記錄生成報表）中，動態(tài)添加刪除行列、插入嵌套表格等是非常常見的需求。

動態(tài)添加/刪除行/列

我們可以通過直接操作table.Rows和table.Rows[rowIndex].Cells集合來實現表格行與列的插入、刪除等操作。

代碼示例

// 動態(tài)添加行
public static void AddRowToTable(Table table, string[] rowData)
{
    TableRow newRow = table.AddRow(); // 在表格末尾添加新行
    newRow.Height = 20;
    newRow.HeightType = TableRowHeightType.Auto;

    for (int i = 0; i < rowData.Length; i++)
    {
        TableCell cell = newRow.Cells[i];
        Paragraph p = cell.AddParagraph();
        p.AppendText(rowData[i]);
        p.Format.HorizontalAlignment = HorizontalAlignment.Center;
        cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle;
    }
}

// 動態(tài)刪除行
public static void RemoveRowFromTable(Table table, int rowIndex)
{
    if (rowIndex >= 0 && rowIndex < table.Rows.Count)
    {
        table.Rows.RemoveAt(rowIndex);
    }
}

// 動態(tài)添加列 (邏輯更復雜，需要遍歷所有行)
public static void AddColumnToTable(Table table, int columnIndex, string[] columnData)
{
    for (int r = 0; r < table.Rows.Count; r++)
    {
        TableCell newCell = new TableCell(table.Document);
        table.Rows[r].Cells.Insert(columnIndex, newCell); // 插入新單元格

        Paragraph p = newCell.AddParagraph();
        if (r < columnData.Length) // 填充數據
        {
            p.AppendText(columnData[r]);
        }
        p.Format.HorizontalAlignment = HorizontalAlignment.Center;
        newCell.CellFormat.VerticalAlignment = VerticalAlignment.Middle;
    }
}

// 動態(tài)刪除列 (邏輯更復雜，需要遍歷所有行)
public static void RemoveColumnFromTable(Table table, int columnIndex)
{
    for (int r = 0; r < table.Rows.Count; r++)
    {
        if (columnIndex >= 0 && columnIndex < table.Rows[r].Cells.Count)
        {
            table.Rows[r].Cells.RemoveAt(columnIndex);
        }
    }
}

這種方法適用于對已有表格進行行列操作等場景。

創(chuàng)建嵌套表格

在復雜文檔結構中（如合同條款、問卷、嵌套布局），可能需要在單元格內部再嵌入一個表格。操作方式與普通表格一致，只是嵌套表格通過：

public static void InsertNestedTable(string filePath)
{
    Document document = new Document();
    Section section = document.AddSection();

    section.AddParagraph().AppendText("嵌套表格示例").Format.Font.Size = 16;
    section.AddParagraph().AppendText("\n");

    Table outerTable = section.AddTable();
    outerTable.ResetCells(2, 2);
    outerTable.TableFormat.Borders.BorderType = BorderStyle.Single;

    // 在外層表格的第一個單元格中插入文本
    outerTable.Rows[0].Cells[0].AddParagraph().AppendText("外部表格 - 單元格 (0,0)");

    // 在外層表格的第二個單元格中插入嵌套表格
    TableCell nestedTableCell = outerTable.Rows[0].Cells[1];
    nestedTableCell.AddParagraph().AppendText("嵌套表格在此："); // 添加一個描述文本

    Table innerTable = nestedTableCell.AddTable(); // 在單元格中添加一個新表格
    innerTable.ResetCells(3, 2);
    innerTable.TableFormat.Borders.BorderType = BorderStyle.Dot; // 內部表格邊框樣式不同

    // 填充內部表格數據
    innerTable.Rows[0].Cells[0].AddParagraph().AppendText("內部表頭1");
    innerTable.Rows[0].Cells[1].AddParagraph().AppendText("內部表頭2");
    innerTable.Rows[1].Cells[0].AddParagraph().AppendText("數據A");
    innerTable.Rows[1].Cells[1].AddParagraph().AppendText("數據B");
    innerTable.Rows[2].Cells[0].AddParagraph().AppendText("數據C");
    innerTable.Rows[2].Cells[1].AddParagraph().AppendText("數據D");

    // 設置內部表格單元格格式
    foreach (TableRow row in innerTable.Rows)
    {
        foreach (TableCell cell in row.Cells)
        {
            cell.CellFormat.VerticalAlignment = VerticalAlignment.Middle;
            if (cell.Paragraphs.Count > 0)
                cell.Paragraphs[0].Format.HorizontalAlignment = HorizontalAlignment.Center;
        }
    }

    // 繼續(xù)填充外層表格的其他單元格
    outerTable.Rows[1].Cells[0].AddParagraph().AppendText("外部表格 - 單元格 (1,0)");
    outerTable.Rows[1].Cells[1].AddParagraph().AppendText("外部表格 - 單元格 (1,1)");

    document.SaveToFile(filePath, FileFormat.Docx);
    Console.WriteLine($"嵌套表格文檔已保存到: {filePath}");
}

插入結果預覽：

嵌套表格常用于：

條款編號 + 內容的雙層結構
表格內的說明性結構
帶標題欄的小型信息塊

適當使用嵌套表格可以極大提升復雜文檔的布局靈活性。

5. 總結

本文通過多個示例展示了如何使用 C# 和 Free Spire.Doc for .NET 操作 Word 表格，包括：

創(chuàng)建文檔與插入基礎表格
控制表格格式、布局和樣式
動態(tài)行列生成適配數據量變化
在單元格中嵌套表格構建更靈活的結構

這些功能覆蓋了大多數實際業(yè)務場景，無論是自動生成合同、構建數據報表，還是制作結構化文檔，都可以輕松實現。

如需進一步擴展（如圖片插入、分頁控制、導出 PDF 等），也可以在此基礎上繼續(xù)組合更多 API 功能。

以上就是使用C#實現插入各種表格到Word文檔的詳細內容，更多關于C# Word表格插入的資料請關注腳本之家其它相關文章！

您可能感興趣的文章:

C#
Word

C#實現的json序列化和反序列化代碼實例
這篇文章主要介紹了C#實現的json序列化和反序列化代碼實例,本文講解了兩種實現方法,并直接給出代碼示例,需要的朋友可以參考下
2015-06-06
C#驗證身份證的函數
因做項目需要，參考網上資料寫了一個身份證驗證的C#方法，本方法是在VS2005[C/S] 下寫的。前面2個是網友們的實現方法，第三個才是項目中使用的哦，小伙伴們參考下吧。
2015-05-05
C#判斷ip地址是否可以ping的通
這篇文章主要介紹了ip地址是否可以ping的通的方法，使用到了C#,需要的朋友可以參考下
2014-06-06
c#中winform根據郵箱地址和密碼一鍵發(fā)送email的實現
本文主要介紹了c#winform根據郵箱地址和密碼一鍵發(fā)送email的實現，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧
2022-07-07
C#中foreach原理以及模擬的實現
這篇文章主要介紹了C#中foreach原理以及模擬的實現方法,備有詳盡的注釋,便于深入理解C#原理,需要的朋友可以參考下
2014-10-10
C#使用LINQ查詢操作符實例代碼(二)
這篇文章介紹了C#使用LINQ查詢操作符的方法，文中通過示例代碼介紹的非常詳細。對大家的學習或工作具有一定的參考借鑒價值，需要的朋友可以參考下
2022-06-06
C#獲取硬盤編號的方法
這篇文章主要介紹了C#獲取硬盤編號的方法,涉及C#獲取硬件屬性的相關技巧,非常簡單實用,需要的朋友可以參考下
2015-05-05
C#實現異步連接Sql Server數據庫的方法
這篇文章主要介紹了C#實現異步連接Sql Server數據庫的方法,涉及C#中await方法的相關使用技巧,具有一定參考借鑒價值,需要的朋友可以參考下
2015-04-04
c#使用wmi查詢usb設備信息示例
這篇文章主要介紹了c#使用wmi查詢usb設備信息示例,大家參考使用吧
2014-01-01
C#中的類繼承詳解
大家好，本篇文章主要講的是C#中的類繼承詳解，感興趣的同學趕快來看一看吧，對你有幫助的話記得收藏一下
2022-02-02