一、技术选型与核心原理

在.NET生态中，处理Word文档的常见技术方案包括Open XML SDK、某文档处理库（已中立化）等。其中某文档处理库作为基于Apache POI的.NET移植版本，提供了更简洁的API封装，尤其适合需要动态生成复杂文档的场景。其核心原理是通过操作Word的XML结构，在指定书签位置插入表格元素，并通过样式对象控制视觉呈现。

1.1 基础环境准备

// 安装NuGet包
// Install-Package NPOI.OpenXmlFormats
// Install-Package NPOI.OOXML

需确保项目引用最新稳定版本，建议通过NuGet包管理器自动处理依赖关系。对于大型项目，推荐使用.NET 6+的跨平台版本以获得更好性能。

二、文档定位与表格插入

2.1 书签定位技术

Word文档中的书签（Bookmark）是实现精准插入的关键。首先需要在模板文档中预先设置书签：

在Word中选中目标位置
插入 → 书签 → 命名（如”TableAnchor”）
保存为.docx模板文件

using (var fs = new FileStream("template.docx", FileMode.Open, FileAccess.ReadWrite))
{
    var doc = new XWPFDocument(fs);
    // 查找书签节点
    var bookmark = doc.GetBookmark("TableAnchor");
    if (bookmark == null)
        throw new Exception("未找到指定书签");
    // 获取书签所在段落
    var paragraph = bookmark.BookmarkStart.Parent as XWPFParagraph;
    // 后续操作将在该段落后插入表格
}

2.2 动态表格创建

通过XWPFTable类创建表格对象，需特别注意行列索引从0开始：

// 创建3行4列表格
var table = doc.CreateTable(3, 4);
// 移动表格到书签位置（关键步骤）
var bookmarkParagraph = bookmark.BookmarkStart.Parent as XWPFParagraph;
var nextNode = bookmarkParagraph.GetCTP().NewCursor();
table.GetCTTbl().SetCnPr(new CT_TblPr()); // 初始化表格属性
bookmarkParagraph.CTP.InsertAfter(table.GetCTTbl(), nextNode);

三、样式精细化控制

3.1 字体与段落样式

// 单元格样式设置示例
var cell = table.GetRow(0).GetCell(0);
var paragraph = cell.GetParagraphArray(0);
var run = paragraph.CreateRun();
// 字体设置
run.SetFontFamily("Arial");
run.FontSize = 14;
run.SetBold(true);
run.SetColor("0000FF"); // 蓝色字体
// 段落对齐
paragraph.Alignment = ParagraphAlignment.CENTER;

3.2 表格布局控制

行高设置

// 设置第二行高度为500缇（1厘米≈567缇）
var row = table.GetRow(1);
row.Height = 500;
row.SetHeightRule(HeightRule.EXACT); // 精确高度模式

列宽调整

// 设置第一列宽度为2厘米
table.SetColumnWidth(0, 2 * 567); // 567缇=1厘米
// 或者使用百分比方式（需配合表格属性）
var tblPr = table.GetCTTbl().tblPr;
if (tblPr == null) tblPr = table.GetCTTbl().AddNewTblPr();
var tblW = tblPr.AddNewTblW();
tblW.w = "5000"; // 总宽度5000缇
tblW.type = ST_TblWidth.pct; // 百分比模式

3.3 边框样式定制

// 获取表格属性
var tblPr = table.GetCTTbl().tblPr;
var tblBorders = tblPr.AddNewTblBorders();
// 设置外边框
tblBorders.bottom = new CT_Border() { val = ST_Border.single, sz = 8 };
tblBorders.top = new CT_Border() { val = ST_Border.single, sz = 8 };
tblBorders.left = new CT_Border() { val = ST_Border.single, sz = 8 };
tblBorders.right = new CT_Border() { val = ST_Border.single, sz = 8 };
// 设置内部横线
var trPr = table.GetRow(0).GetCTTr().trPr;
var trBorders = trPr.AddNewTrBorders();
trBorders.bottom = new CT_Border() { val = ST_Border.dashed, sz = 4 };

四、完整实践案例

4.1 销售报表生成

public void GenerateSalesReport(string templatePath, string outputPath)
{
    using (var fs = new FileStream(templatePath, FileMode.Open))
    using (var doc = new XWPFDocument(fs))
    {
        // 查找书签
        var bookmark = doc.GetBookmark("SalesData");
        if (bookmark == null) return;
        // 创建表格（6行5列）
        var table = doc.CreateTable(6, 5);
        // 设置表头样式
        var headerRow = table.GetRow(0);
        headerRow.Height = 600;
        SetHeaderStyle(headerRow);
        // 填充数据（示例）
        var data = new[] {
            new[] { "Q1", "1200", "1500", "1800", "2100" },
            new[] { "Q2", "1350", "1620", "1890", "2250" }
        };
        for (int i = 0; i < data.Length; i++)
        {
            var row = table.GetRow(i + 1);
            for (int j = 0; j < data[i].Length; j++)
            {
                var cell = row.GetCell(j);
                cell.SetText(data[i][j]);
                SetCellStyle(cell, i == 0); // 首行特殊样式
            }
        }
        // 插入表格到书签位置
        InsertTableAtBookmark(doc, bookmark, table);
        // 保存文档
        using (var outFs = new FileStream(outputPath, FileMode.Create))
        {
            doc.Write(outFs);
        }
    }
}
private void SetHeaderStyle(XWPFTableRow row)
{
    for (int i = 0; i < row.GetTableCells().Count; i++)
    {
        var cell = row.GetCell(i);
        var paragraph = cell.GetParagraphArray(0);
        var run = paragraph.CreateRun();
        run.SetText(GetHeaderText(i)); // 假设有获取表头文本的方法
        run.SetBold(true);
        run.FontSize = 12;
        paragraph.Alignment = ParagraphAlignment.CENTER;
        cell.SetColor("D3D3D3"); // 浅灰色背景
    }
}

4.2 性能优化建议

样式复用：创建样式模板对象，避免重复设置
批量操作：将多个单元格操作合并为批量处理
内存管理：处理大文件时使用流式读写
异步处理：在ASP.NET环境中使用异步文件操作

五、常见问题解决方案

5.1 书签未找到错误

检查书签名称拼写是否完全匹配（包括大小写）
确认模板文档已保存为.docx格式
验证书签是否位于段落内部而非表格内

5.2 表格错位问题

确保在插入表格前清除书签位置的原有内容
检查表格属性中的布局模式设置
验证文档是否包含损坏的XML结构

5.3 样式不生效

确认样式设置顺序（先创建Run再设置属性）
检查是否覆盖了父元素的样式
验证字体名称是否系统已安装

通过本文介绍的完整技术方案，开发者可以轻松实现Word文档的自动化生成，特别适用于需要动态控制表格样式的财务报表、合同文档、数据分析报告等场景。建议在实际项目中结合模板引擎技术，进一步提升文档生成的灵活性和可维护性。

C# 使用通用文档库在Word中精准控制表格样式与布局