Word文档的自动生成已被企业广泛用于创建大量报告。在某些情况下,文档是从头开始创建的。另一方面,预定义的模板用于通过填充占位符来生成Word文档。在本文中,我将演示如何在C#中从模板动态地以编程方式生成Word文档。您将了解如何从不同类型的数据源填充Word模板。
本文将介绍以下方案以及代码示例:
C#Word自动化API
我们将使用Aspose.Words for .NET-一种Word自动化API,可让您从头开始或通过填充预定义的Word模板来生成Word文档。您可以下载API的二进制文件,也可以使用以下方法之一安装它。
使用NuGet软件包管理器
使用软件包管理器控制台
PM> Install-Package Aspose.Words
使用C#对象从模板生成Word文档
首先,让我们看看如何使用C#对象填充Word模板。为此,我们将创建具有以下占位符的Word文档(DOC / DOCX)作为文档的内容:
<<[sender.Name]>> says: "<<[sender.Message]>>."
在这里,发送者是以下类的对象,我们将使用该类来填充模板。
现在,我们将使用Aspose.Words的报告引擎,按照以下步骤从Sender类的模板和对象生成Word文档。
- 创建Document类的对象,并使用Word模板的路径对其进行初始化。
- 创建并初始化Sender类的对象。
- 实例化ReportingEngine类。
- 使用ReportingEngine.BuildReport()填充模板,该模板将Document的对象,数据源和数据源的名称作为参数。
- 使用Document.Save()方法保存生成的Word文档。
下面的代码示例演示如何从C#中的模板生成Word文档。
输出
从C#中的XML数据源生成Word文档
为了从XML数据源生成Word文档,我们将使用带有以下占位符的更为复杂的Word模板:
<<foreach [in persons]>>Name: <<[Name]>>, Age: <<[Age]>>, Date of Birth: <<[Birth]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Age)]>>
下面给出了我在此示例中使用的XML数据源。
以下是从XML数据源生成Word文档的步骤:
- 创建Document类的实例,并使用Word模板的路径对其进行初始化。
- 创建XmlDataSource类的实例,并使用XML文件的路径对其进行初始化。
- 实例化ReportingEngine类。
- 以与之前填充Word模板相同的方式使用ReportingEngine.BuildReport()方法。
- 使用Document.Save()方法保存生成的Word文档。
下面的代码示例演示如何从C#中的XML数据源生成Word文档。
输出
在C#中从JSON数据源生成Word文档
现在,让我们看看如何使用JSON数据源生成Word文档。在此示例中,我们将生成按其经理分组的客户列表。在这种情况下,以下为Word模板:
<<foreach [in managers]>>Manager: <<[Name]>>
Contracts:
<<foreach [in Contract]>>- <<[Client.Name]>> ($<<[Price]>>)
<</foreach>>
<</foreach>>
以下是我们将用来填充模板的JSON数据源:
为了从JSON生成Word文档,我们将使用JsonDataSource类加载和使用JSON数据源,其余步骤将保持不变。下面的代码示例演示如何使用C#中的JSON从模板生成Word文档。
输出
在C#中从CSV数据源生成Word文档
为了从CSV生成Word文档,我们将使用以下Word模板:
<<foreach [in persons]>>Name: <<[Column1]>>, Age: <<[Column2]>>, Date of Birth: <<[Column3]:"dd.MM.yyyy">>
<</foreach>>
Average age: <<[persons.Average(p => p.Column2)]>>
模板将填充以下CSV数据:
现在,让我们来看一下C#代码。除了一个更改,我们将使用CsvDataSource类加载CSV数据,这里所有步骤也将保持不变。下面的代码示例演示如何从CSV数据源生成Word文档。
输出
免费试用Aspose.Words for .NET
您可以使用免费的临时许可证尝试Aspose.Words for .NET。
结论
在本文中,您学习了如何使用C#从模板生成Word文档。此外,您已经了解了如何使用对象,XML,JSON和CSV数据源来生成Word文档。您可以使用文档探索有关C#Word自动化API的更多信息。另外,您可以通过我们的论坛与我们联系。