MailMergeOptions.NumberedListRestart Property

Sets the behavior of numbered lists when the mail merge operation is performed.

Namespace: DevExpress.XtraRichEdit.API.Native

Assembly: DevExpress.RichEdit.v23.1.Core.dll

NuGet Package: DevExpress.RichEdit.Core

Declaration

C#

MailMergeNumberingRestart NumberedListRestart { get; set; }

VB.NET

Property NumberedListRestart As MailMergeNumberingRestart

Property Value

Type	Description
MailMergeNumberingRestart	An enumeration value that indicates the numbering list restart mode.

Available values:

Name	Description
None	Continue the list numbering unless otherwise specified in the list settings (e.g, when a specific numbered list is manually restarted).
Always	Restart a numbered list for each record.
AlwaysExceptParagraphStyles	Restart the numbered list for each record, but ignore lists that are created by applying paragraph styles with numbering (e.g., “Chapter 1”, “Chapter 2”, etc.).

Remarks

To restart a numbered list for each record in a mail merge document, set this property to the Always or AlwaysExceptParagraphStyles.

Note

When you work with large data sources, the NumberedListRestart property usage may result in a performance degradation. If your usage scenario requires the NumberedListRestart property, divide your data source into batches and use these parts in the mail merge process to obtain separate documents with small parts of your data source. You can use the FirstRecordIndex and LastRecordIndex properties to complete the task.