我们已经介绍了如何在 C# 和 中比较两个 Word 文档。从 Spire.Doc V8.12.14 开始,它支持在结构列表中获取两个 Word 文档之间的差异。本文将向您展示如何使用 Spire.Doc 通过比较两个 Word 文档来获取差异。
Spire.Doc 最新下载
欢迎下载|体验更多E-iceblue产品技术交流Q群(767755948) 介绍
邮件合并通常用于批量打印报表,例如财务报表、工资单或成绩单。合并后的文件可以通过电子邮件发送。
在本文中,我将展示一种通过 Spire.Doc 生成邮件合并报告的方法。
报告概览
此报告包括多张发票,每张发票都从一个新页面开始。发票标志和供应商信息将显示在每页的标题中。
订单、装运、客户、订单详情和总价构成一张完整的发票。
下图为发票外观:
每张发票的内容详情如下所示:
订单数据概览
本示例中的所有数据均来自 Northwind 数据库,该数据库是 Microsoft Access 提供的示例数据库。
我们将从Orders、Shippers、Customers、Employees、[Order Details]和Products表中导出数据以生成我们的报告。下图展示了6个表之间的关系。
步骤:
我们需要完成以下 3 个步骤来生成我们的报告。
创建邮件合并模板。从数据库加载数据。将数据合并到模板中并保存。
每个步骤都包含几个子步骤,在#2 和#3 中我们需要编写一些代码。
创建邮件合并模板
模板是可重用的文档。它呈现了我们报告的模式。我们可以修改它来更改我们的报告,而无需修改任何代码。
注意:在本节中,所有表均指 DataTable 实例,而不是数据库中的物理表。
我们可以在 MS Word 或其他程序中创建模板。请看下图。这是我们需要创建的模板。数据将填写在红方。
将邮件合并字段作为占位符插入红块。本例中将使用三种类型的邮件合并字段:
GeneralField 是一个通用的 Word 邮件合并字段。这是真实的数据字段,我们的数据将在合并过程中填写。我们需要在每个红块中插入一个 GeneralField 并用相应的数据名称命名这些字段。插入 GeneralFields 后,我们的模板将如下所示:
TableField 是辅助邮件合并字段,用作多个相关 GeneralField 和其他 TableField 的容器。所以它不是数据占位符,不会填充任何数据。它由两个特殊的邮件合并字段组成:
TableStart:TableName和 TableEnd:TableName。在合并过程中,同一个 TableField 所包含的相关 GeneralField 的数据将来自同一个数据表。例如,客户信息块中的字段将填充数据表Customer中的数据,因此我们需要将它们放入 TableFieldCustomer中。
在第一个CompanyName字段之前插入一个字段名称为TableStart:Customer的邮件合并字段,并在字段 Country 之后立即插入另一个字段名称为TableEnd:Customer的邮件合并字段。然后我们在客户信息块中的字段如下所示:
在合并过程中,表Customer的CompanyName列中的数据将填充到字段CompanyName中,将Customer.Address填充到字段Address中,将Customer.City填充到字段City中等等。
订单信息表中销售人员列字段数据来自员工表
订单信息表中Ship Via栏的字段数据来自Shipper表
订单明细表中的字段数据来自表Detail,除了字段ProductName。字段ProductName的数据来自表Product。Invoice总计信息中InvoiceSubtotal和InvoiceTotal字段的数据来自表Total(虚拟表)
GroupField 也是辅助邮件合并字段。它可以包含多个相关的 GeneralFields 和 TableFields。它由两个特殊的邮件合并字段组成: GroupStart: GroupName和 GroupEnd: GroupName。在合并过程中,将复制 GroupField 中包含的所有 Word 文档元素。数据表中的一行有一个副本,该行中的数据将填充到副本中的字段中。
如果该行有子数据表,则子数据表中的数据将填充到相应的TableField中包含的字段中。如果子数据表有多个数据行,对应的TableField也会被复制填充。
我们需要在模板正文的顶部插入一个名为 GroupStart:Order 的邮件合并字段,并在模板正文的底部插入一个名为GroupEnd:Order的邮件合并字段。在此之后,我们的模板如下所示:
您可以在随附的源包中找到名为 InvoiceTemplate.doc 的完整模板。
从数据库加载数据
Spire.Doc 提供来自 DataSet 的合并数据。因此,我们将使用 DataAdapter 将 NorthWind 数据库中的数据表填充到 DataSet 中,并将其合并到我们的模板中。与DataSet 的DataRelation 不同,Spire.Doc 拥有表关系功能。所以我们不需要为 DataSet 对象创建 DataRelation 实例。下面的代码仅显示加载订单数据。其他代码请参见随附的源包。
[C#]
String connectionString= @"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=Northwind.mdb";DataSet dataSet = new DataSet();using(OleDbConnection conn = new OleDbConnection(connectionString)){//load December 1997 ordersString sql= " SELECT * "+ " FROM Orders "+ " WHERE ShippedDate Between #12/1/1997# And #12/31/1997# ";using (OleDbDataAdapter dataAdapter = new OleDbDataAdapter(sql, conn)){dataAdapter.Fill(dataSet, "Order");}}
将数据合并到模板中并保存
在本节中,我们需要编写一些代码来调用 Spire.Doc 来合并我们的数据表和模板。
创建 Spire.Doc.Document 对象并加载模板。
[C#]
Document document = new Document();document.LoadFromFile("InvoiceTemplate.doc", FileFormat.Doc);
建立数据表之间的关系。
[C#]
List<DictionaryEntry> list = new List<DictionaryEntry>{new DictionaryEntry("Order", String.Empty),new DictionaryEntry("Shipper", "ShipperID = %Order.ShipVia%"),new DictionaryEntry("Customer", "CustomerID = %Order.CustomerID%"),new DictionaryEntry("Employee", "EmployeeID = %Order.EmployeeID%"),new DictionaryEntry("Detail", "OrderID = %Order.OrderID%"),new DictionaryEntry("Product", "ProductID = %Detail.ProductID%"),new DictionaryEntry("Total", "OrderID = %Order.OrderID%")};
将数据集合并到模板中并将文档保存到文件中。
[C#]
//clear empty value fields during merge processdocument.MailMerge.ClearFields = true;//clear empty paragraphs if it has only empty value fields.document.MailMerge.RemoveEmptyParagraphs = true;//mergedocument.MailMerge.ExecuteWidthNestedRegion(dataSet, list);//set word view type.document.ViewSetup.DocumentViewType = DocumentViewType.PrintLayout;document.SaveToFile("Invoice.doc");
为了在新页面中开始每张发票,我们在第一段之前插入一个分页符,以便合并新的订单行。为此,我们需要处理在字段合并之前触发的事件 MergeField。
[C#]
//index of row of merged order dataint mergedRowIndex = 0;document.MailMerge.MergeField += delegate(object sender, MergeFieldEventArgs e){if (e.TableName == "Order"){if (e.RowIndex > mergedRowIndex){mergedRowIndex = e.RowIndex;//insert page break symbol before the paragraph of current fieldInsertPageBreak(e.CurrentMergeField);}}};
方法 InsertPageBreak 的代码
[C#]
private static void InsertPageBreak(IMergeField field){//append a page break symbolBreak pageBreak = field.OwnerParagraph.AppendBreak(BreakType.PageBreak);//move to the start of the paragraphfield.OwnerParagraph.Items.Insert(0, pageBreak);}
如果觉得《Word控件Spire.Doc 【邮件合并】教程(一):通如何使用邮件合并创建报告》对你有帮助,请点赞、收藏,并留下你的观点哦!