Skip to main content

MailMergeOptions.NumberedListRestart Property

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

Namespace: DevExpress.XtraRichEdit.API.Native

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

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

MailMergeNumberingRestart NumberedListRestart { get; set; }

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.

See Also