郵件合并功能與之前的提到的將TX文檔全部存入數據庫有所不同，郵件合并功能是將數據庫中特定字段插入到模板文檔的特定位置。與此同時，本章節還會演示在郵件合并功能的基礎上添加打印功能、以及如何創建郵件合并所需的模板文檔。

　　本章節相應的源代碼可以在TX Text Control.NET的安裝目錄中找到：
        Samples\WinForms\VB.NET\MailMerge
        Samples\WinForms\CSharp\MailMerge

　　第一步：合并數據庫數據和文本

　　啟動程序并選擇Template菜單下的Load命令，通過Load命令加載模板文件，模板文件中包含一些文本域，這些文本域的數據將被數據庫中對應的數據替換。

　　選擇Database菜單下的Browse Database命令打開【Address Database】窗體，通過該窗體可以從數據庫中選擇數據并合并到文檔中。

　　 當點擊Merge按鈕時，數據庫中的數據將被拷貝到文檔中相應的文本域中。        你還可以通過重復點擊Next和Merge按鈕來合并不同的數據到文檔中。

　　該示例中使用的數據源來自一個XML文件，文件中包含一些地址信息。打開【Address Database】窗體以及每次點擊【Previous】和【Next】按鈕都會通過GetRecord()方法來取得數據：

[C#]
private void GetRecord()
{
DataRow Row = dsAddress.Tables[0].Rows[CurrentRow];
lblCompany.Text = Row["company"].ToString();
lblRecipient.Text = Row["recipient"].ToString();
lblStreet.Text = Row["street"].ToString();
lblCity.Text = Row["city"].ToString();
lblCountry.Text = Row["country"].ToString();
lblSalutation.Text = Row["salutation"].ToString();
SetButtonState();
}

　　點擊【Merge】按鈕時，數據源中的數據將被拷貝到文檔的相應的文本域中，文本域與數據源中的字段有著相同名字，所以通過For Each操作可以完成這個拷貝工作：

[C#]
private void cmdMerge_Click(object sender, System.EventArgs e)
{
foreach (TXTextControl.TextField Field in tx.TextFields)
{
Field.Text = dsAddress.Tables[0].Rows[CurrentRow][Field.Name].ToString();
}
}

　　第二步：打印操作

　　在【Address Database】窗體中添加一個【Print】按鈕，當點擊【Print】按鈕時，程序會將數據源中的記錄合并到文檔中并進行打印操作：

[C#]
private void cmdPrint_Click(object sender, System.EventArgs e)
{
PrintDocument PrintDoc = new PrintDocument();
foreach (DataRow CurrentRow in dsAddress.Tables[0].Rows)
{
// Merge data from current record
foreach (TXTextControl.TextField Field in tx.TextFields)
Field.Text = CurrentRow[Field.Name].ToString();
// Print
PrintDoc.PrinterSettings.FromPage = 0;
PrintDoc.PrinterSettings.ToPage = tx.Pages;
tx.Print(PrintDoc);
}
}

　　由于打印操作會自動將數據進行合并，所以不再需要步驟一中的【Merge】按鈕，同時使用Grid來顯示數據源中的數據，這樣可以更好的瀏覽數據源中的數據

　　第三步：創建模板文檔

　　加載、保存和導入文件

　　在 第一和第二步中程序會自動加載template.tx模板文件，所以不能加載其它模板文檔，也不能保存文檔。因此需要修改加載文件相關的代碼，通過一個文 件對話框來選擇需要加載的模板文檔，同時添加【Saveing】和【Importing】菜單項，需要注意的是只有將文檔保存為TX Text Control的格式才能保留文檔中的文本域。而用戶可以通過【SaveFile】對話框來講文檔保存了其它格式的文件：

[C#]
private void mnuFile_SaveTemplateAs_Click(object sender, System.EventArgs e)
{
dlgSaveFile.Filter = "Text Control Files (*.tx)|*.tx";
dlgSaveFile.ShowDialog();
if (dlgSaveFile.FileName != "")
textControl1.Save(dlgSaveFile.FileName,
TXTextControl.StreamType.InternalFormat);
}

　　添加數據庫字段

　　第一和第二步中包含了必須的文本域，為了創建更靈活的文件，應用程序應該提供給用戶選擇數據庫字段的功能，由用戶來決定將哪些字段添加到模板文檔中。在程序中添加一個【Insert】菜單，菜單包含數據源中的所有列：

　　然而，每個數據源可能包含不同的列信息，【Insert】菜單也需要動態創建。數據源中的每列就對應【Insert】菜單的一個菜單項，當點擊這些菜單項時，會在文檔中穿件相應的文本域：

[C#]
private void CreateTextFieldMenu()
{
mnuInsert.MenuItems.Clear();
foreach (DataColumn DataField in dsAddress.Tables[0].Columns)
mnuInsert.MenuItems.Add(DataField.ColumnName,
new EventHandler(InsertMenuItems_Click));
}

private void InsertMenuItems_Click(object sender, System.EventArgs e)
{
TXTextControl.TextField textField = new TXTextControl.TextField();
textField.Text = "(" + ((MenuItem)sender).Text + ")";
textField.Name = ((MenuItem)sender).Text;
textField.ShowActivated = true;
textField.DoubledInputPosition = true;
textControl1.TextFields.Add(textField);
}