MailMerge 2.3.0

MailMerge replaces simple and complex merge fields in WordProcessingML .docx files
and helps you apply .Net's Xml & XPath tooling to Word documents.

Component Usage For Streams or Files:
```
var (outputStream, errors) = new MailMerger().Merge(inputStream, Dictionary);
var (ok,errors) = new MailMerger().Merge(inputFileName, Dictionary, outputFileName);
```
Extension Methods & Helpers for working with OoXml
```
stream.AsWordprocessingDocument(isEditable)
stream.AsXPathDocOfWordprocessingMainDocument(isEditable)
stream.AsXElementOfWordprocessingMainDocument(isEditable)

stream.GetXmlDocumentOfWordprocessingMainDocument()
fileInfo.GetXElementOfWordprocessingMainDocument()
fileInfo.GetXmlDocumentOfWordprocessingMainDocument()
```
A NamespaceManager, NameTable & Uri which you need when creating an XmlDocument
and/or XElements:
```
var xdoc = new XmlDocument(OoXmlNamespaces.Manager.NameTable)
var xelement= mainDocumentPart.CreateElement("w", "t", OoXmlNamespaces.WpML2006MainUri)
```
CommandLine Usage: Perform a merge, or show a document's Xml
```
dotnet MailMerge.dll inputFile1 outputFile1 [inputFileN [...outputFileN]] [ key=value [...] ]
dotnet MailMerge.dll  --showxml file [fileN ...]
```

Install-Package MailMerge -Version 2.3.0
dotnet add package MailMerge --version 2.3.0
<PackageReference Include="MailMerge" Version="2.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MailMerge --version 2.3.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

MailMerge for docx Documents

MailMerge replaces simple and complex merge fields in WordProcessingML .docx files
and helps you apply .Net's Xml & XPath tooling to Word documents.

Component Usage

For Streams:
var (outputStream, errors) = new MailMerger().Merge(inputStream, Dictionary);
For Files:
var (ok,errors) = new MailMerger().Merge(inputFileName, Dictionary, outputFileName);

To specify current DateTime : new MailMerger{DateTime=...}.Merge( ... )

Extension Methods & Helpers

stream.AsWordprocessingDocument(isEditable)
stream.AsXPathDocOfWordprocessingMainDocument(isEditable)
stream.AsXElementOfWordprocessingMainDocument(isEditable)

stream.GetXmlDocumentOfWordprocessingMainDocument()
fileInfo.GetXElementOfWordprocessingMainDocument()
fileInfo.GetXmlDocumentOfWordprocessingMainDocument()

A NamespaceManager, NameTable & Uri which you need when creating an XmlDocument
and/or XElements:

var xdoc = new XmlDocument(OoXmlNamespaces.Manager.NameTable)
var xelement= mainDocumentPart.CreateElement("w", "t", OoXmlNamespaces.WpML2006MainUri)

CommandLine Usage

Perform a merge, or show a document's Xml

dotnet MailMerge.dll inputFile1 outputFile1 [inputFileN [...outputFileN]] [ key=value [...] ]
dotnet MailMerge.dll  --showxml file [fileN ...]

Example

dotnet MailMerge.dll input1.docx output1Bill.docx  FirstName=Bill  "LastName=O Reilly"

Settings

None really, but see https://github.com/chrisfcarroll/MailMerge/blob/master/MailMerge/appsettings.json for settable limits.

Doesn't do

  • Anything except Merge fields and Dates
  • Date formatting codes except a b B d D M y & h m s
  • Style/Formatting codes in the merge fields except these Date/Time formats
  • Multi-row datasources, just does 1 row at a time

Gotchas

  • Interprets .Net DateTime formatting codes that aren't in the WordProcessingML spec.

NuGet

https://www.nuget.org/packages/MailMerge/

How do I create a Word document with merge fields without attaching a datasource?

https://www.cafe-encounter.net/p2247/add-merge-fields-to-a-word-document-before-adding-a-datasource

MailMerge for docx Documents

MailMerge replaces simple and complex merge fields in WordProcessingML .docx files
and helps you apply .Net's Xml & XPath tooling to Word documents.

Component Usage

For Streams:
var (outputStream, errors) = new MailMerger().Merge(inputStream, Dictionary);
For Files:
var (ok,errors) = new MailMerger().Merge(inputFileName, Dictionary, outputFileName);

To specify current DateTime : new MailMerger{DateTime=...}.Merge( ... )

Extension Methods & Helpers

stream.AsWordprocessingDocument(isEditable)
stream.AsXPathDocOfWordprocessingMainDocument(isEditable)
stream.AsXElementOfWordprocessingMainDocument(isEditable)

stream.GetXmlDocumentOfWordprocessingMainDocument()
fileInfo.GetXElementOfWordprocessingMainDocument()
fileInfo.GetXmlDocumentOfWordprocessingMainDocument()

A NamespaceManager, NameTable & Uri which you need when creating an XmlDocument
and/or XElements:

var xdoc = new XmlDocument(OoXmlNamespaces.Manager.NameTable)
var xelement= mainDocumentPart.CreateElement("w", "t", OoXmlNamespaces.WpML2006MainUri)

CommandLine Usage

Perform a merge, or show a document's Xml

dotnet MailMerge.dll inputFile1 outputFile1 [inputFileN [...outputFileN]] [ key=value [...] ]
dotnet MailMerge.dll  --showxml file [fileN ...]

Example

dotnet MailMerge.dll input1.docx output1Bill.docx  FirstName=Bill  "LastName=O Reilly"

Settings

None really, but see https://github.com/chrisfcarroll/MailMerge/blob/master/MailMerge/appsettings.json for settable limits.

Doesn't do

  • Anything except Merge fields and Dates
  • Date formatting codes except a b B d D M y & h m s
  • Style/Formatting codes in the merge fields except these Date/Time formats
  • Multi-row datasources, just does 1 row at a time

Gotchas

  • Interprets .Net DateTime formatting codes that aren't in the WordProcessingML spec.

NuGet

https://www.nuget.org/packages/MailMerge/

How do I create a Word document with merge fields without attaching a datasource?

https://www.cafe-encounter.net/p2247/add-merge-fields-to-a-word-document-before-adding-a-datasource

Release Notes

2.3.0 Merges multi-line (\n or \n\r) input fields into a single <w:r>
           Breaking Change: Moved namespace MailMerge.Helpers -> MailMerge
     2.2.1 Should not require the existence of appsettings.json
     2.2.0 Handle more variations of w:instrText sequence.
     2.1.0 Added support for Complex Field Character sequences.
     2.0.0 Renamed component MailMerge.MailMerge to MailMerge.MailMerger

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
2.3.0 170 7/20/2020
2.2.1 788 6/9/2019
2.2.0 768 11/24/2018
2.1.0 631 3/31/2018
2.0.0 533 3/23/2018
1.0.1 405 2/27/2018