Table of Contents

Namespace DocWright.MailMerge

Classes

AddressFields

Word's address fields (Phase 167): what ADDRESSBLOCK and GREETINGLINE are made of, and how a list's columns are matched to them, as Word's Match Fields does before anyone changes it.

CsvMergeData

A recipient list read from CSV the way Word's Mailings reads one (Phase 161, WQ-0134): the first row names the fields, a value in double quotes keeps its delimiters and line ends, "" inside quotes is one quote, an empty value is empty. Field names are Word's: a space becomes , a character that is neither a letter, a digit nor is dropped.

MailMergeExtensions

Phase 161 (WQ-0134): the merges Word's Mailings makes without touching the main document, Preview Results and Finish & Merge > Edit Individual Documents, and a recipient list read from CSV.

MailMergeOptions

Controls a merge.

MergeDataSource

Builds IMergeDataReaders over the shapes a host is likely to already have.

MergeFieldEventArgs

One merge field, handed to FieldMerging before its value is written.

MergeFieldMap<T>

Binds a merge field name to a way of reading it off an object.

MergeImage

Image bytes supplied by the host for an image merge field.

MergeImageRequest

A request for the bytes behind an image merge field.

MergeResult

What a merge did.

MergeTemplateException

A merge template is malformed in a way that has no sensible partial answer.

XlsxMergeData

A recipient list read from an Excel workbook (Phase 167): a sheet's first row names the fields and each later row is a record, as Word's Mailings > Select Recipients reads one. Values are the cells' values as Word merges them (measured, tools/Probe-WordXlsxMerge.ps1): a number in full (0.1 is 0.10000000000000001, a currency or percent format ignored), a date as 1/15/2024, a boolean as True/False, a formula as its cached result, text as it is.

Interfaces

IMergeDataReader

A forward-only cursor over merge records.

IMergeRelationSource

A named child collection a nested merge region draws its rows from.

Enums

MergeRecordSeparator

How many documents a multi-record merge produces, and what separates the copies.

UnmergedFieldAction

What to do with a merge field the data did not supply a value for.