C# 实现多种Word邮件合并功能

C# 实现多种Word邮件合并功能

在处理Word文档的工作中经常会遇见这样一种情况：文件的主要内容和格式大体相同，只是需要填充的数据不同。如果一个一个填写数据的话会非常麻烦，而且很耗时间。这时候我们就可以灵活运用Word邮件合并功能来快速实现这一操作。这里将介绍如何使用C#和Word组件Spire.Doc实现一些常用的Word文档邮件合并功能。

Spire.Doc组件概述

Spire.Doc是一款专门对 Word 文档进行操作的 .NET类库，用于在.NET应用程序中创建、编辑、打印和转换Word文档，并且无需安装Microsoft Word。它支持几乎所有的 Word 文档元素，主要包括页面、节、页眉、页脚、脚注、尾注、段落、项目符号和编号、表格、文本、域、超链接、书签、注释、图片、样式、背景设置、打印功能、文档设置和文档保护。同时，也支持形状、文本框、图片、OLE 对象和内容控件。

1. 创建邮件合并模板文档

1.1. Microsoft Word创建邮件合并模板文档

我们知道，执行邮件合并前需要先根据需求创建带有合并域的模板文档。下图展示了如何在Microsoft Word中插入合并域（MergeField）到Word文档。

1.2. Spire.Doc创建邮件合并模板文档

在Spire.Doc中，我们可以通过Paragraph对象调用AppendField (string fieldName, FieldType fieldType)方法插入合并域到Word文档。

//创建Word文档

Document document = new Document();

//添加节

Section section = document.AddSection();

//添加段落

Paragraph paragraph = section.AddParagraph();

//添加文本

paragraph.AppendText("编号： ");

//添加合并域“Emp_Id”

paragraph.AppendField("Emp_Id", FieldType.FieldMergeField);

//添加文本

paragraph.AppendText("\n姓名： ");

//添加合并域“Name”

paragraph.AppendField("Name", FieldType.FieldMergeField);

//添加文本

paragraph.AppendText("\n电话： ");

//添加合并域“Phone”

paragraph.AppendField("Phone", FieldType.FieldMergeField);

//添加文本

paragraph.AppendText("\n部门： ");

//添加合并域“Department”

paragraph.AppendField("Department", FieldType.FieldMergeField);

//保存文档

document.SaveToFile("模板.docx", FileFormat.Docx2013);

document.Close();

此处如果不想使用\n换行，可在每次插入域之后再插入line break：paragraph.AppendBreak( BreakType.LineBreak);

2. 执行邮件合并

2.1. 简单邮件合并

MailMerge类中提供了执行邮件合并的方法Execute ()，它共有7种重载方法：

从上图可以看出，选择不同的重载方法，可以从不同的数据源如Datatable，Dataview，DataReader和数组等合并数据。

下面我使用刚刚创建的模板文档，并以一对数组作为Execute ()方法的参数。其中第一个数组表示域的名称，第二个数组表示域的值。名称和值的数量需要一致。

//加载模板文档

Document document = new Document("模板.docx");

string[] fieldNames = newstring[] { "Emp_Id", "Name", "Phone", "Department" };

string[] fieldValues = newstring[] { "0065", "李强", "+86 151XXXX1101", "开发部" };

//执行邮件合并（也就是添加数据）

document.MailMerge.Execute(fieldNames, fieldValues);

//保存文档

document.SaveToFile("MergeText.docx", FileFormat.Docx2013);

document.Close();

2.2.带图片邮件合并

除简单的文字合并以外，MailMerge类还支持通过MergeImageField事件来添加图片到合

并域。

Document doc = new Document();

doc.LoadFromFile("图片.docx");

var fieldNames = newstring[] { "Photo " };

var fieldValues = newstring[] { "Photo.jpg" };

doc.MailMerge.MergeImageField += new MergeImageFieldEventHandler(MailMerge_MergeImageField); doc.MailMerge.Execute(fieldNames, fieldValues);

doc.SaveToFile("MergeImage.docx", FileFormat.Docx);

staticvoid MailMerge_MergeImageField(object sender, MergeImageFieldEventArgs field)

{

string filePath = field.FieldValue asstring;

if (!string.IsNullOrEmpty(filePath))

{

field.Image = Image.FromFile(filePath);

}

}