MailMergerContext Class

Wordize.MailMerging.MailMergerContext class. Mail merge context.

MailMergerContext class

Mail merge context.

public class MailMergerContext : ProcessorContext

Constructors

NameDescription
MailMergerContext()The default constructor.

Properties

NameDescription
FontSettings { get; set; }Allows to specify document font settings.
LayoutOptions { get; }Document layout options used by the processor.
MailMergeOptions { get; }Mail merge options.
WarningCallback { get; set; }Warning callback used by the processor.

Methods

NameDescription
SetRegionsDataSource(DataSet)Sets data source used to execute mail merge with regions.
SetRegionsDataSource(DataTable)Sets data source used to execute mail merge with regions.
SetSimpleDataSource(DataRow)Sets data source used to execute simple mail merge.
SetSimpleDataSource(DataTable)Sets data source used to execute simple mail merge.
SetSimpleDataSource(string[], object[])Sets data source used to execute simple mail merge.

Examples

Shows how to fill a template with data by executing mail merge with regions and simple mail merge using fluent API.

string[] names = new string[] { "FirstName", "SecondName", "Position" };
string[] values = new string[] { "James", "Bond", "Spy" };

DataTable dt = new DataTable("Items");
dt.Columns.Add("Item");
dt.Columns.Add("Quantity");
dt.Columns.Add("Price");
dt.Rows.Add("Orange", 5, 10);
dt.Rows.Add("Apple", 10, 4);
dt.Rows.Add(null, null, null); // empty row.
dt.Rows.Add("Pear", 4, 6);

MailMergerContext context = new MailMergerContext();
context.MailMergeOptions.CleanupOptions = MailMergeCleanupOptions.RemoveEmptyTableRows;
context.SetSimpleDataSource(names, values);
context.SetRegionsDataSource(dt);

MailMerger.Create(context)
    .From(MyDir + "MailMergeTemplate.docx")
    .To(ArtifactsDir + "MailMergerContext.docx")
    .Execute();

See Also