Log In
Home
Support
Demos
Documentation
Blogs
Training
Webinars
[Expand]General Information
[Collapse]WinForms Controls
  Prerequisites
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Chart Control
  [Expand]Diagrams
  [Expand]Gauges
  [Expand]Map Control
  [Expand]Scheduler
  [Expand]Spreadsheet
  [Collapse]Rich Text Editor
    Overview
   [Expand]Getting Started
   [Collapse]Fundamentals
    [Expand]RichEditControl
    [Expand]Document
     Supported Document Formats
    [Collapse]Fields
     [Expand]Field Codes
     [Expand]Format Switches
      Field Structure
      Inserting a Field
      Field Display Modes
      Updating a Field
      Field Types
     Commands
     Services
     Layout API
     Product Class Structure
     Default Keyboard Shortcuts
     Measure Units
     HTML Tag Interpretation
   [Expand]Concepts
   [Expand]Visual Elements
   [Expand]Examples
   [Expand]Member Tables
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]Printing-Exporting
  [Expand]PDF Viewer
   Reporting
  [Expand]Snap
  [Expand]TreeMap Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Document Server
[Expand]Reporting
[Expand]Report Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]CodeRush
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation

Field Types

There are three types of fields - MailMerge, Non-MailMerge and Mixed. MailMerge fields are used in the Mail Merge process, and get a value only if there is a mail merge data source bound to the RichEditControl. Otherwise, MailMerge fields are displayed as field placeholders that show the name of a corresponding data column, encompassed in angular brackets (chevrons) as follows:

<<CompanyName>> for the MERGEFIELD coded as { MERGEFIELD CompanyName }

To display field results for MailMerge fields, set the RichEditMailMergeOptions.ViewMergedData to true, or execute the ToggleViewMergedDataCommand command.

A significant difference between MailMerge and Non-MailMerge fields is in their behavior when the Document.MailMerge (or the IRichEditDocumentServer.MailMerge) method is executed. The resulting document does not contain fields of the MailMerge type. MailMerge fields are evaluated and substituted with the resulting values. Results for Non-MailMerge fields are displayed when the field is updated.

Mixed field type denote fields which do not require a data source to get its value. They are substituted with the resulting values during mail merge. CREATEDATE and INCLUDEPICTURE are examples of such fields.

For more information on the fields supported, refer to the Field Codes topic.

How would you rate this topic?​​​​​​​