Method PreviewRecord
PreviewRecord(WordDocument, IReadOnlyDictionary<string, object?>, MailMergeOptions?)
Merges one record into a copy of the template, as Word's Preview Results shows it. The template is not changed.
public static WordDocument PreviewRecord(this WordDocument template, IReadOnlyDictionary<string, object?> record, MailMergeOptions? options = null)
Parameters
templateWordDocumentThe main document.
recordIReadOnlyDictionary<string, object>The record.
optionsMailMergeOptionsThe options, or null for the defaults.
Returns
- WordDocument
The previewed document.
Exceptions
- ArgumentNullException
templateorrecordis null.- MergeTemplateException
A region marker is unbalanced or crossed.
PreviewRecord(WordDocument, IReadOnlyDictionary<string, object?>, int, MailMergeOptions?)
Merges one record into a copy of the template as Word's Preview Results shows it, numbered as the
recordNumberth record (Phase 167): «Merge Record #» and «Merge Sequence #» show the number its
copy has in MergeToNewDocument(WordDocument, IMergeDataReader, MailMergeOptions?). The template is not changed.
public static WordDocument PreviewRecord(this WordDocument template, IReadOnlyDictionary<string, object?> record, int recordNumber, MailMergeOptions? options = null)
Parameters
templateWordDocumentThe main document.
recordIReadOnlyDictionary<string, object>The record.
recordNumberintThe record's number in the merge, from 1.
optionsMailMergeOptionsThe options, or null for the defaults.
Returns
- WordDocument
The previewed document.
Exceptions
- ArgumentNullException
templateorrecordis null.- ArgumentOutOfRangeException
recordNumberis less than 1.- MergeTemplateException
A region marker is unbalanced or crossed.