Excel处理控件Aspose.Cells教程：使用 C# 从 Excel 进行邮件合并

news2025/6/7 4:08:29

邮件合并功能让您能够轻松批量创建个性化文档，例如信函、电子邮件、发票或证书。您可以从模板入手，并使用电子表格中的数据进行填充。Excel 文件中的每一行都会生成一个新文档，并在正确的位置包含正确的详细信息。这是一种自动化重复性任务（例如发送发票或生成报告）的智能方法。在本文中，我们将向您展示如何使用 C# 从 Excel 执行邮件合并。

Aspose.Cells 最新版下载

C# 邮件合并 Excel 库

我们将使用Aspose.Cells for .NET API 在 C# 中从 Excel 执行邮件合并。它提供了强大的工具，可直接在代码中处理 Excel 文件。它使开发人员能够轻松创建、读取和更新电子表格。您还可以轻松处理邮件合并等高级任务。该库使 Excel 自动化快速、灵活且可靠。

要开始使用 Aspose.Cells for .NET，请遵循以下简单的安装说明：

请从发布版本中下载。
使用NuGet 包管理器通过以下命令安装库：

PM> Install-Package Aspose.Cells

邮件合并如何与 Aspose.Cells 配合使用？

Aspose.Cells 不支持与 Word 相同的“邮件合并”功能。它使用智能标记将邮件合并添加到 Excel 。这些标记在电子表格中充当占位符，该库会在运行时将其替换为真实数据。在处理数据源中的每一行时，它会自动填充模板并扩展内容，让您只需几行 C# 代码即可生成完全个性化的文档。

&=DataSource.ColumnName

在处理过程中，Aspose.Cells 会用来自、或任何的实际数据替换这些数据DataTable。List<T>例如IEnumerable，库会&=Data.Name用数据表中“名称”列的值替换这些数据。

准备 Excel 模板

创建一个包含智能标记的 Excel 文件（例如 Template.xlsx）。以下是示例布局：

姓名	电子邮件	数量
&=数据.名称	&=数据.电子邮件	&=数据.金额

使用 C# 从 Excel 执行邮件合并的分步指南

要使用 Aspose.Cells for .NET 从 Excel 执行邮件合并，只需按照以下步骤操作：

步骤 1：加载 Excel 模板

使用该类加载包含智能标记的 Excel 模板文件Workbook。该类Workbook代表整个 Excel 文件（工作簿）。加载的模板文件将用作合并输出的布局。

Workbook workbook = new Workbook("Template.xlsx");

步骤 2：创建数据表

这里，我们创建一个 DataTable 来模拟您的 Excel 数据源。每一列对应一个智能标记，每一行代表一组要插入的值。DataTable类名System.Data包含您要合并的数据。每一列对应一个智能标记，每一行提供一组唯一的值。

DataTable dt = new DataTable("Data"); dt.Columns.Add("Name"); dt.Columns.Add("Email"); dt.Columns.Add("Amount"); dt.Rows.Add("Alice", "alice@example.com", 1000); dt.Rows.Add("Bob", "bob@example.com", 1500);

我们使用该类WorkbookDesigner将模板与数据连接起来。这WorkbookDesigner是 Aspose.Cells 中一个特殊的类，用于处理智能标记和数据绑定。它将数据源（例如 DataTable）与 Excel 模板链接起来。该SetDataSource()方法将 DataTable（数据）绑定到工作簿中的智能标记。

WorkbookDesigner designer = new WorkbookDesigner(workbook); designer.SetDataSource(dt);

SetDataSource()将数据表附加到工作簿中的智能标记。
"Data"是标记中使用的名称，例如&=Data.Name。

步骤 4：执行邮件合并

设置数据源后，调用Process()会用 DataTable 中的实际值填充所有智能标记。此命令执行邮件合并。它会遍历智能标记，并将其替换为数据源中的实际值。

designer.Process();

步骤5：保存文件

最后，我们保存合并了所有数据的完整文件。

workbook.Save("MergedOutput.xlsx");

将合并的输出保存为 PDF

您可以使用一行代码轻松地将合并的 Excel 文档保存为 PDF。

// Set PDF options PdfSaveOptions options = new PdfSaveOptions(); // Save as PDF workbook.Save("MergedDocument.pdf", SaveFormat.Pdf);

完成 C# 代码以邮件合并数据

// Load the Excel template
Workbook workbook = new Workbook("Template.xlsx");
// Create dummy data
DataTable dt = new DataTable("Data");
dt.Columns.Add("Name");
dt.Columns.Add("Email");
dt.Columns.Add("Amount");
dt.Rows.Add("Alice", "alice@example.com", 1000);
dt.Rows.Add("Bob", "bob@example.com", 1200);
// Set the data source
WorkbookDesigner designer = new WorkbookDesigner(workbook);
designer.SetDataSource(dt);
// Process smart markers (mail merge)
designer.Process();
// Save the output
workbook.Save("MergedOutput.xlsx");