Aspose.Words 是一種高級Word文檔處理API，用于執行各種文檔管理和操作任務。API支持生成，修改，轉換，呈現和打印文檔，而無需在跨平臺應用程序中直接使用Microsoft Word。此外，

Aspose API支持流行文件格式處理，并允許將各類文檔導出或轉換為固定布局文件格式和最常用的圖像/多媒體格式。

Aspose.words 最新下載

在本文中，我將向您展示如何在沒有 MS Word 或 Office Interop 的情況下使用 C# 或 VB.NET 執行 MS Word 郵件合并。Aspose.Words for .NET是一個功能豐富且功能強大的 Word API，它提供了所有基本的以及擴展的 MS Word 郵件合并功能。它允許您在 Windows 窗體、ASP.NET Web 應用程序或任何 .NET/.NET Core 應用程序中生成信件、信封、報告、發票和其他類型的文檔。

一、什么是郵件合并？

郵件合并是一種自動生成報告、信件、信封、發票和其他類型文檔的方式。MS Word 中的郵件合并允許您創建包含合并字段的模板文檔，然后使用數據源中的記錄填充這些字段。要了解郵件合并，假設您必須向十個不同的人發送一封信，并且只有姓名和地址字段需要更新。在這種情況下，只需創建一個字母模板，然后通過使用數據源填充名稱和地址合并字段來動態生成字母。

二、郵件合并的數據源

 郵件合并的數據可以從任何數據源（如 XML、JSON 或數據庫）中獲取。就 Aspose.Words for .NET 而言，您可以使用 ADO.NET 支持的任何數據源。數據可以加載到 DataSet、DataTable、DataView 或值數組中。

三、為郵件合并準備模板

郵件合并模板是包含合并字段的文檔。當執行郵件合并時，這些字段隨后會填充數據源中的數據。模板文檔不需要是模板格式，可以是DOC/DOCX文檔。這就是您可以為郵件合并準備模板的方法。

• 打開您的文檔或在 MS Word 中創建一個新文檔。
• 將光標置于要添加合并字段的位置。
• 從插入菜單中選擇字段選項。
• 從字段名稱列表中，選擇MergeField。
• 在字段名稱中輸入合并字段的名稱，然后按確定。
• 保存文檔。

以下是示例模板文檔的屏幕截圖。

四、.NET 郵件合并 API - 安裝

五、使用 C# 在 Word 文檔中執行郵件合并

準備好模板后，您可以執行郵件合并以生成文檔。以下是在上述模板上執行郵件合并的步驟。

• 使用Document類加載模板文檔。
• 設置所需的郵件合并選項，例如Document.MailMerge.TrimWhitespaces。
• 使用Document.MailMerge.Execute()方法執行郵件合并并將數據源作為參數傳遞。
• 使用Document.Save(String)方法保存生成的文檔。

以下代碼示例顯示如何使用 C# 中的值數組執行 MS Word 郵件合并。

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_MailMergeAndReporting();
// Open an existing document.
Document doc = new Document(dataDir + "MailMerge.ExecuteArray.doc");

// Trim trailing and leading whitespaces mail merge values
doc.MailMerge.TrimWhitespaces = false;

// Fill the fields in the document with user data.
doc.MailMerge.Execute(
new string[] { "FullName", "Company", "Address", "Address2", "City" },
new object[] { "James Bond", "MI5 Headquarters", "Milbank", "", "London" });

dataDir = dataDir + "MailMerge.ExecuteArray_out.doc";
// Send the document in Word format to the client browser with an option to save to disk or open inside the current browser.

五、郵件合并后的 Word 文檔

六、郵件合并后的 Word 文檔

XML 文件廣泛用于保存和導入/導出數據。Aspose.Words for .NET 也支持 XML 作為郵件合并的數據源。只需將 XML 讀入DataSet對象并執行郵件合并。以下是我們將要使用的示例 XML 文件。

<customers>
<customer Name="John Ben Jan" ID="1" Domain="History" City="Boston"/>
<customer Name="Lisa Lane" ID="2" Domain="Chemistry" City="LA"/>
<customer Name="Dagomir Zits" ID="3" Domain="Heraldry" City="Milwaukee"/>
<customer Name="Sara Careira Santy" ID="4" Domain="IT" City="Miami"/>
</customers>
以下代碼示例從 XML 數據源獲取數據并使用 C# 執行郵件合并。

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_MailMergeAndReporting();

// Create the Dataset and read the XML.
DataSet customersDs = new DataSet();
customersDs.ReadXml(dataDir + "Customers.xml");

string fileName = "TestFile XML.doc";
// Open a template document.
Document doc = new Document(dataDir + fileName);

// Execute mail merge to fill the template with data from XML using DataTable.
doc.MailMerge.Execute(customersDs.Tables["Customer"]);

dataDir = dataDir + RunExamples.GetOutputFilePath(fileName);
// Save the output document.
doc.Save(dataDir);

下面是將用 XML 數據填充的郵件合并模板。

以下是執行郵件合并后得到的結果 Word 文檔的第 1 頁。

七、合并字段的自定義格式

Aspose.Words for .NET 讓您在執行期間更好地控制郵件合并。MailMerge.FieldMergingCallback屬性允許您在遇到任何合并字段時自定義郵件合并。MailMerge.FieldMergingCallback 接受實現IFieldMergingCallback.FieldMerging和IFieldMergingCallback.ImageFieldMerging方法的類。

下面的代碼示例顯示了如何自定義郵件合并操作并將格式應用于此模板中的單元格。

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_MailMergeAndReporting();
Document doc = new Document(dataDir + "MailMerge.AlternatingRows.doc");

// Add a handler for the MergeField event.
doc.MailMerge.FieldMergingCallback = new HandleMergeFieldAlternatingRows();

// Execute mail merge with regions.
DataTable dataTable = GetSuppliersDataTable();
doc.MailMerge.ExecuteWithRegions(dataTable);
dataDir = dataDir + "MailMerge.AlternatingRows_out.doc";
doc.Save(dataDir);

以下是HandleMergeFieldAlternatingRows類的實現。

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
private class HandleMergeFieldAlternatingRows : IFieldMergingCallback
{
/// <summary>
/// Called for every merge field encountered in the document.
/// We can either return some data to the mail merge engine or do something
/// Else with the document. In this case we modify cell formatting.
/// </summary>
void IFieldMergingCallback.FieldMerging(FieldMergingArgs e)
{
if (mBuilder == null)
mBuilder = new DocumentBuilder(e.Document);

// This way we catch the beginning of a new row.
if (e.FieldName.Equals("CompanyName"))
{
// Select the color depending on whether the row number is even or odd.
Color rowColor;
if (IsOdd(mRowIdx))
rowColor = Color.FromArgb(213, 227, 235);
else
rowColor = Color.FromArgb(242, 242, 242);

// There is no way to set cell properties for the whole row at the moment,
// So we have to iterate over all cells in the row.
for (int colIdx = 0; colIdx < 4; colIdx++)
{
mBuilder.MoveToCell(0, mRowIdx, colIdx, 0);
mBuilder.CellFormat.Shading.BackgroundPatternColor = rowColor;
}

mRowIdx++;
}
}

void IFieldMergingCallback.ImageFieldMerging(ImageFieldMergingArgs args)
{
// Do nothing.
}

private DocumentBuilder mBuilder;
private int mRowIdx;
}
/// <summary>
/// Returns true if the value is odd; false if the value is even.
/// </summary>
private static bool IsOdd(int value)
{
// The code is a bit complex, but otherwise automatic conversion to VB does not work.
return ((value / 2) * 2).Equals(value);
}
/// <summary>
/// Create DataTable and fill it with data.
/// In real life this DataTable should be filled from a database.
/// </summary>
private static DataTable GetSuppliersDataTable()
{
DataTable dataTable = new DataTable("Suppliers");
dataTable.Columns.Add("CompanyName");
dataTable.Columns.Add("ContactName");
for (int i = 0; i < 10; i++)
{
DataRow datarow = dataTable.NewRow();
dataTable.Rows.Add(datarow);
datarow[0] = "Company " + i.ToString();
datarow[1] = "Contact " + i.ToString();
}
return dataTable;
}

八、使用 C# 與區域合并郵件

當您需要填充和重復 Word 文檔中的特定區域時，可能會出現這種情況。對于這種情況，您可以使用區域郵件合并。要創建區域，您需要指定區域的開始和結束，然后 Mail Megre 將為數據源中的每條記錄重復該區域。例如，以下模板包含兩個區域，Orders 和 OrderDetails，分別具有合并字段 ?TableStart:Orders?、?TableEnd:Orders? 和 ?TableStart:OrderDetails?、?TableEnd:OrderDetails?。

以下是上述模板對區域進行Mail Megre的代碼示例。

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_MailMergeAndReporting();
string fileName = "MailMerge.ExecuteWithRegions.doc";
Document doc = new Document(dataDir + fileName);

// Use DataTable as a data source.
int orderId = 10444;
DataTable orderTable = GetTestOrder(orderId);
doc.MailMerge.ExecuteWithRegions(orderTable);

// Instead of using DataTable, you can create a DataView for custom sort or filter and then mail merge.
DataView orderDetailsView = new DataView(GetTestOrderDetails(orderId));
orderDetailsView.Sort = "ExtendedPrice DESC";

// Execute the mail merge operation.
doc.MailMerge.ExecuteWithRegions(orderDetailsView);

// Save the merged document.
dataDir = dataDir + RunExamples.GetOutputFilePath(fileName);
doc.Save(dataDir);

下面是從數據庫中讀取數據的方法。

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
private static DataTable GetTestOrder(int orderId)
{
DataTable table = ExecuteDataTable(string.Format(
"SELECT * FROM AsposeWordOrders WHERE OrderId = {0}", orderId));
table.TableName = "Orders";
return table;
}
private static DataTable GetTestOrderDetails(int orderId)
{
DataTable table = ExecuteDataTable(string.Format(
"SELECT * FROM AsposeWordOrderDetails WHERE OrderId = {0} ORDER BY ProductID", orderId));
table.TableName = "OrderDetails";
return table;
}
/// <summary>
/// Utility function that creates a connection, command,
/// Executes the command and return the result in a DataTable.
/// </summary>
private static DataTable ExecuteDataTable(string commandText)
{
// Open the database connection.
string connString = "Provider=Microsoft.Jet.OLEDB.4.0;Data Source=" +
RunExamples.GetDataDir_Database() + "Northwind.mdb";
OleDbConnection conn = new OleDbConnection(connString);
conn.Open();

// Create and execute a command.
OleDbCommand cmd = new OleDbCommand(commandText, conn);
OleDbDataAdapter da = new OleDbDataAdapter(cmd);
DataTable table = new DataTable();
da.Fill(table);

// Close the database.
conn.Close();

return table;
}

九、嵌套郵件合并區域

 大多數情況下，我們在數據源中擁有的數據以關系的形式出現。例如，表“Order”將與“OrderDetails”具有一對多關系，后者將保存訂單中的項目記錄。為了處理這種父子關系，使用了嵌套的郵件合并。以下是非常適合這種情況的示例發票模板。

以下是我們將用于嵌套郵件合并的示例 XML 數據源。

<?xml version="1.0" encoding="utf-8"?>
<Orders xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="OrdersSchema.xsd">
<Order>
<Number>23</Number>
<Address>Nelson Street</Address>
<Suburb>Howick</Suburb>
<City>Auckland</City>
<Phonenumber>543 1234</Phonenumber>
<Date>03/01/2010</Date>
<Total>14.00</Total>
<Item>
<Name>BBQ Chicken Pizza</Name>
<Price>6.00</Price>
<Quantity>1</Quantity>
<ItemTotal>6.00</ItemTotal>
</Item>
<Item>
<Name>1.5 Litre Coke</Name>
<Price>4.00</Price>
<Quantity>2</Quantity>
<ItemTotal>8.00</ItemTotal>
</Item>
</Order>
<Order>
<Number>10</Number>
<Address>Parkville Avenue</Address>
<Suburb>Pakuranga</Suburb>
<City>Auckland</City>
<Phonenumber>548 7342</Phonenumber>
<Date>05/03/2010</Date>
<Total>6.00</Total>
<Item>
<Name>Hawaiian Pizza</Name>
<Price>4.00</Price>
<Quantity>1</Quantity>
<ItemTotal>4.00</ItemTotal>
</Item>
<Item>
<Name>Fries</Name>
<Price>1.00</Price>
<Quantity>2</Quantity>
<ItemTotal>2.00</ItemTotal>
</Item>
</Order>
</Orders>

而此 XML 的OrderSchema.xsd是：

<?xml version="1.0" encoding ="utf-8"?>
<xs:schema id="OrdersSchema" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Orders">
<xs:complexType>
<xs:sequence>
<xs:element name="Order">
<xs:complexType>
<xs:sequence>
<xs:element name="Number"/>
<xs:element name="Address"/>
<xs:element name="Suburb"/>
<xs:element name="City"/>
<xs:element name="Phonenumber">
<xs:element name="Date"/>
<xs:element name="Total"/>
<xs:element name="Item">
<xs:complexType>
<xs:sequence>
<xs:element name="Name"/>
<xs:element name="Price"/>
<xs:element name="Quantity"/>
<xs:element name="ItemTotal"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>

以下代碼示例用于使用 C# 執行嵌套郵件合并。

// For complete examples and data files, please go to //github.com/aspose-words/Aspose.Words-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_MailMergeAndReporting();

// Create the Dataset and read the XML.
DataSet pizzaDs = new DataSet();

// The Datatable.TableNames and the DataSet.Relations are defined implicitly by .NET through ReadXml.
pizzaDs.ReadXml(dataDir + "CustomerData.xml");
string fileName = "Invoice Template.doc";

// Open the template document.
Document doc = new Document(dataDir + fileName);

// Trim trailing and leading whitespaces mail merge values.
doc.MailMerge.TrimWhitespaces = false;

// Execute the nested mail merge with regions.
doc.MailMerge.ExecuteWithRegions(pizzaDs);
dataDir = dataDir + RunExamples.GetOutputFilePath(fileName);

// Save the output to file.
doc.Save(dataDir);

Debug.Assert(doc.MailMerge.GetFieldNames().Length == 0, "There was a problem with mail merge");
Console.WriteLine("\nMail merge performed with nested data successfully.\nFile saved at " + dataDir);

十、郵件合并后的 Word 文檔

下面是執行郵件合并后生成的 Word 文檔的第一頁。

以上便是使用 C# 或 VB.NET 在 Word 文檔中合并郵件 - .NET 郵件合并 API ，要是您還有其他關于產品方面的問題，歡迎咨詢我們，或者加入我們官方技術交流群。

歡迎下載|體驗更多Aspose產品