C# 使用NPOI生成Word文档「按照模板」

1. 简介

在实际工作中，我们经常需要生成Word或Excel文档，以便于数据的导出和打印。NPOI是一个开源的.NET库，它可以帮助我们完成对Excel、Word等文件的读取和写入操作。NPOI可以通过直接操作模板文件，将数据填充到模板中，从而生成符合要求的Word文档。下面，我们将介绍如何使用NPOI生成Word文档。

2. 准备工作

2.1 引用NPOI.dll库

首先，我们需要在我们的项目中引用NPOI.dll库。在Visual Studio中，右键点击项目，选择“添加引用”。在弹出的“添加引用”窗口中，点击“浏览”按钮，找到并选择NPOI.dll文件，点击“确定”即可添加NPOI.dll库到我们的项目中。

using NPOI.HWPF;
using NPOI.HWPF.UserModel;

2.2 准备Word文档模板

在使用NPOI生成Word文档时，我们需要一个Word文档模板，以便于向其中填充数据。如果您已经有Word文档模板了，那么您可以直接使用它。如果没有，您可以通过直接在Word中创建一个模板文档，并在其中设置好文档的格式、样式等，然后将其保存为Word 97-2003格式的文档（.doc）。需要注意的是，模板文档中需要留出相应的位置，以便于填充数据。我们以一个简单的模板文档为例，如下图所示：


3. 使用NPOI生成Word文档

3.1 创建Word文档对象

首先，我们需要创建一个Word文档对象，代码如下：

string templatePath = "template.doc";
using (FileStream fs = File.OpenRead(templatePath))
{
    // 创建Word文档对象
    HWPFDocument doc = new HWPFDocument(fs);
    // 获取文档区域
    Range range = doc.GetRange();
}

代码中，我们通过文件流的方式读取模板文件，然后创建一个Word文档对象，并获取文档区域。

3.2 填充模板中的数据

接着，我们需要填充模板中的数据，代码如下：

// 填充文档中的数据
range.ReplaceText("${title}", "测试文档");
range.ReplaceText("${date}", DateTime.Now.ToString("yyyy-MM-dd"));
range.ReplaceText("${name}", "张三");
range.ReplaceText("${age}", "30");
range.ReplaceText("${sex}", "男");

代码中，我们通过“${}”的方式来标识我们要填充的内容，然后通过调用Range对象的“ReplaceText()”方法来替换文档中的数据。

需要注意的是，如果要填充的数据内容较多，建议使用数据模板和数据绑定的方式，以提高代码的可读性和维护性。

3.3 保存Word文档

最后，我们需要将生成的Word文档保存到本地，代码如下：

string newFilePath = "new.doc";
using (FileStream fsNew = File.Create(newFilePath))
{
    // 将文档写入磁盘
    doc.Write(fsNew);
}

代码中，我们通过调用HWPFDocument对象的“Write()”方法，将生成的Word文档写入磁盘中。

4. 总结

NPOI是一个非常好用的.NET库，它可以帮助我们完成对Excel、Word等文件的读取和写入操作。在实际工作中，我们常常需要生成Word文档模板，并将数据填充到模板中，以便于数据的导出和打印。本文通过一个简单的例子，介绍了如何使用NPOI生成Word文档。希望对大家有所帮助。