MergeFields

The &#9584; TX Text Control .NET Server &#9584; DocumentServer Namespace &#9584; MailMerge Class The MailMerge class is a .NET component that can be used to effortlessly merge template documents with database content in .NET projects, such as ASP.NET web applications, web services or Windows services. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Mail Merge class of TX Text Control uses MS Word compatible merge fields to populate data from various data sources into templates. In order to use legacy templates from other formats, such as HTML, placeholders can be converted into merge fields.

A typical legacy HTML template contains textual placeholders like in the following HTML:

This is a sample text with #textfields#.

More #textmarkers# here.

In order to use the full power of Text Control's reporting engine, those templates should be converted into the TX Text Control internal format or an MS Word format such as Office Open XML (DOCX).

With TX Text Control's API, it is possible to load these HTML documents, find these placeholders and convert them into merge fields that can be directly used with MailMerge .

In order to find the placeholders like in the sample template above, the following extension method can be used to find them using a simple regular expression:

public static class MyExtensions { public static MatchCollection Find( this TXTextControl.TextControl tx, string pattern, RegexOptions regexOptions) {

// replace the CRLFs with LFs to be compatible with // TextControl's index var sText = tx.Text.Replace("\r\n", "\n");

// new RegEx and return the matches Regex rg = new Regex(pattern, regexOptions); return rg.Matches(sText); } } The extension method extends the Find method of TX Text Control to search for matches based on a given regular expression pattern:

MatchCollection matchedFields = textControl1.Find(@"#(.*)#", RegexOptions.None); In our sample, the template placeholder format is:

#placeholder#

The extension Find method returns a MatchCollection that is then used to select the text in order to create a new &#9584; TX Text Control .NET Server &#9584; DocumentServer.Fields Namespace &#9584; MergeField Class The MergeField class implements the MS Word specific MERGEFIELD field. " data-tippy-interactive="true" data-tippy-placement="bottom" data-tooltip-width="wide"

>Merge Field based on the selected text. After the text is removed, the newly created merge fields is then inserted into the document at the current input position:

// load a document textControl1.Load("sample.html", TXTextControl.StreamType.HTMLFormat);

// create a MatchCollection MatchCollection matchedFields = textControl1.Find(@"#(.*)#", RegexOptions.None);

// loop through all matches foreach (Match match in matchedFields) { // select the text textControl1.Select(match.Index, match.Length);

// create a new field based on the text TXTextControl.DocumentServer.Fields.MergeField mergeField = new TXTextControl.DocumentServer.Fields.MergeField() { Text = textControl1.Selection.Text, Name = textControl1.Selection.Text.Trim('#') };

// enable highlighting and the second input position mergeField.ApplicationField.DoubledInputPosition = true; mergeField.ApplicationField.HighlightMode = TXTextControl.HighlightMode.Activated;

// remove the text textControl1.Selection.Text = "";

// insert the field at the current input position textControl1.ApplicationFields.Add(mergeField.ApplicationField); } After all placeholders have been converted to merge fields, the template can be used like any other MailMerge template to create documents.

TX Text Control .NET Server

DS Server

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

Blog

Core Technologies

Blog

Authors

Latest Posts

Support Resources

Documentation

Support

Getting Started

Other Resources

About Us

Industry events

Company

Contact

Newsletter

Legal

Sign in

Create account

Text Control Account

MergeFields

Post tagged with MergeFields in 2021

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

​

Latest Posts

​

Support

Getting Started

​

Other Resources

Company

Contact

Newsletter

Legal

Text Control Account

​

​

MergeFields

Post tagged with MergeFields in 2021 ​

January 2021

Post tagged with MergeFields in 2021