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

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

Merges all repeating blocks that are contained in the loaded template with the System.Data.DataTable instances contained in the given System.Data.DataSet. The name of the System.Data.DataTable must match the name of the block in the template. The supported format of the repeating blocks can be found in the ASP.NET User's Guide.

MergeBlocks(System.Data.DataSet)

C#
VB.NET

public int MergeBlocks(System.Data.DataSet mergeData);

Public Function MergeBlocks(ByVal mergeData As System.Data.DataSet) As Integer

Parameters

Parameter	Description
mergeData	Specifies a System.Data.DataSet that contains the merge data.

Return Value

Returns the number of successfully merged blocks.

Examples

The following example merges a block in a template.

C#
VB.NET

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

DataTable blockData = new DataTable("section1"); 
blockData.Columns.Add("name"); 
blockData.Columns.Add("company"); 
blockData.Rows.Add(new object[] { "Peter Jackson", "Text Control GmbH" }); 
blockData.Rows.Add(new object[] { "Jack Peterson", "The Imaging Source LLC" }); 
mergeData.Tables.Add(blockData); 
mailMerge1.MergeBlocks(mergeData);

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

Dim BlockData As New DataTable("section1") 
BlockData.Columns.Add("name") 
BlockData.Columns.Add("company") 
BlockData.Rows.Add(New Object() {"Peter Jackson", "Text Control GmbH"}) 
BlockData.Rows.Add(New Object() {"Jack Peterson", "The Imaging Source LLC"}) 

MergeData.Tables.Add(BlockData) 
MailMerge1.MergeBlocks(MergeData)