MailMergeOptions.MergeMode Property

Gets or sets how the merged ranges are delimited in the resulting document.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v21.2.Core.dll

Declaration

C#
VB.NET

MergeMode MergeMode { get; set; }

Property MergeMode As MergeMode

Property Value

Type	Description
MergeMode	A MergeMode enumeration value specifying the delimiter.

Name	Description
NewParagraph	Specifies that the next merged range starts with a new paragraph.
NewSection	Specifies that the next merged range starts with a new section. The section break type is obtained from the previous section break or set to the NextPageby default. For headers and footers, it is the only allowed option.
JoinTables	Enables you to join rows, which result from a mail merge involving a table with merged fields, into a whole table.

Remarks

If a merge field is located in a document’s header or footer, the MergeMode should be set to MergeMode.NewSection for proper operation.

The following code snippets (auto-collected from DevExpress Examples) contain references to the MergeMode property.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#
VB.NET

how-to-create-a-master-detail-report-e4718/CS/MasterDetailExample/MergeProcessor.cs#L108

// Do not specify this option if calculated fields are not within table cells.
options.MergeMode = MergeMode.JoinTables;
// Provide a procedure for further processing.

how-to-implement-mail-merge-in-a-richeditcontrol-e1680/CS/MailMerge/Form1.cs#L30

myMergeOptions.LastRecordIndex = 3;
myMergeOptions.MergeMode = MergeMode.NewSection;
richEditControl1.Document.MailMerge(myMergeOptions, richEditControl2.Document);

master-detail-mail-merge-essential-the-simplest-implementation-e3662/CS/Form1.cs#L23

MailMergeOptions mailMergeOptions = richEditCategoryTemplate.CreateMailMergeOptions();
mailMergeOptions.MergeMode = MergeMode.NewParagraph;

dxrichedit-for-wpf-how-to-implement-progress-indicator-for-slow-richeditcontrol-operations-e3293/CS/MainWindow.xaml.cs#L27

MailMergeOptions myMergeOptions = richEditControl1.Document.CreateMailMergeOptions();
myMergeOptions.MergeMode = MergeMode.NewSection;
richEditControl1.Document.MailMerge(myMergeOptions, richEditControl2.Document);

expandoobjects-data-binding-and-mail-merge-in-xtrarichedit-e3752/CS/ExpandoObject_MailMerge/Form1.cs#L62

MailMergeOptions options = richEditControl1.Document.CreateMailMergeOptions();
options.MergeMode = MergeMode.NewSection;
frmResultingDocument form = new frmResultingDocument();

how-to-create-a-master-detail-report-e4718/VB/MasterDetailExample/MergeProcessor.vb#L104

' Do not specify this option if calculated fields are not within table cells.
options.MergeMode = MergeMode.JoinTables
' Provide a procedure for further processing.

how-to-implement-mail-merge-in-a-richeditcontrol-e1680/VB/MailMerge/Form1.vb#L28

myMergeOptions.LastRecordIndex = 3
myMergeOptions.MergeMode = MergeMode.NewSection
richEditControl1.Document.MailMerge(myMergeOptions, richEditControl2.Document)

master-detail-mail-merge-essential-the-simplest-implementation-e3662/VB/Form1.vb#L25

Dim mailMergeOptions As MailMergeOptions = richEditCategoryTemplate.CreateMailMergeOptions()
mailMergeOptions.MergeMode = MergeMode.NewParagraph

dxrichedit-for-wpf-how-to-implement-progress-indicator-for-slow-richeditcontrol-operations-e3293/VB/MainWindow.xaml.vb#L29

Dim myMergeOptions As MailMergeOptions = richEditControl1.Document.CreateMailMergeOptions()
myMergeOptions.MergeMode = MergeMode.NewSection
richEditControl1.Document.MailMerge(myMergeOptions, richEditControl2.Document)

expandoobjects-data-binding-and-mail-merge-in-xtrarichedit-e3752/VB/ExpandoObject_MailMerge/Form1.vb#L61

Dim options As MailMergeOptions = richEditControl1.Document.CreateMailMergeOptions()
options.MergeMode = MergeMode.NewSection
Dim form As New frmResultingDocument()

.NET Subscription

Common Tools

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

.NET Subscription

Common Tools

Controls

Tools

Controls and Extensions

Tools

Maintenance Mode

MailMergeOptions.MergeMode Property

Declaration

Property Value

Remarks

MailMergeOptions.MergeMode Property

Declaration

Property Value

Remarks

Related GitHub Examples