TXTextControl.DocumentServer.MailMerge.Merge Method - TX Text Control .NET for Windows Forms

TX Text Control .NET for Windows FormsReference GuideTXTextControl.DocumentServer NamespaceMailMerge ClassMerge Method

Merges given data into the loaded document template. The supported format of the merge fields can be found in the ASP.NET User's Guide.

Merge(System.Data.DataTable, Bool)

C#
VB.NET

public void Merge(System.Data.DataTable mergeData, bool append);

Public Sub Merge(ByVal mergeData As System.Data.DataTable, ByVal append As Boolean)

Merge(System.Data.DataTable)

C#
VB.NET

public void Merge(System.Data.DataTable mergeData);

Public Sub Merge(ByVal mergeData As System.Data.DataTable)

Merge(Bool)

C#
VB.NET

public void Merge(bool append);

Public Sub Merge(ByVal append As Boolean)

Merge()

C#
VB.NET

public void Merge();

Public Sub Merge()

Parameters

Parameter	Description
mergeData	Specifies a System.Data.DataTable that contains the merge data.
append	Specifies whether the single documents should be merged into one document or split into separate documents.

Examples

The following examples merge a template that contains two merge fields: name and company.

C#
VB.NET

TXTextControl.DocumentServer.MailMerge mailMerge1 = new TXTextControl.DocumentServer.MailMerge();
DataTable mergeData = new DataTable();

mergeData.Columns.Add("name");
mergeData.Columns.Add("company");
mergeData.Rows.Add(new object[] { "Peter Jackson", "Text Control GmbH" });
mergeData.Rows.Add(new object[] { "Jack Petersen", "The Imaging Source LLC" });
mailMerge1.LoadTemplate("template.doc", TXTextControl.DocumentServer.FileFormat.MSWord);
mailMerge1.Merge(mergeData, true);
TXTextControl.SaveSettings sSettings = new TXTextControl.SaveSettings();

mailMerge1.SaveDocument("results.pdf", TXTextControl.StreamType.AdobePDF, sSettings);

Dim MailMerge1 As New TXTextControl.DocumentServer.MailMerge()
Dim MergeData As New DataTable()

MergeData.Columns.Add("name")
MergeData.Columns.Add("company")
MergeData.Rows.Add(New Object() {"Peter Jackson", "Text Control GmbH"})
MergeData.Rows.Add(New Object() {"Jack Petersen", "The Imaging Source LLC"})

MailMerge1.LoadTemplate("template.doc", TXTextControl.DocumentServer.FileFormat.MSWord)
MailMerge1.Merge(MergeData, True)
Dim SSettings As New TXTextControl.SaveSettings()

MailMerge1.SaveDocument("results.pdf", TXTextControl.StreamType.AdobePDF, SSettings)