TX Text Control .NET Server

FormFieldMergeType Property

Property|Introduced in 30.0
Namespace
TXTextControl.DocumentServer
Package
TXTextControl.TextControl.Core.SDK as TXDocumentServer.Core.dll from the private NuGet feed or Text Control Offline Packages
Also in
TXTextControl.TextControl.ASP.SDK as TXDocumentServer.dll

Description

Specifies in which manner form fields are treated during the merge process. Form fields can either be ignored, preselected or replaced with a value from the data source. The default value is FormFieldMergeType.None which means that form fields are completely unaffected by the merge process.

Syntax

public FormFieldMergeType FormFieldMergeType { get; set; }

Members

ValueDescription
NoneForm fields are not merged at all.
PreselectForm field content is preselected when possible. Form fields not associated with a data table column are unaffected.
ReplaceForm fields are replaced with database content. Empty form fields are removed according to property MailMerge.RemoveEmptyFields.

Examples

The following example uses MailMerge.FormFieldMergeType to configure form field merge type as part of the mail merge workflow. The configured value is checked before the workflow continues.

mailMerge.FormFieldMergeType = TXTextControl.DocumentServer.FormFieldMergeType.Preselect;
Console.WriteLine($"Form Field Merge Type used by Mail Merge: {mailMerge.FormFieldMergeType}");