Info
Version: | 2.5.1 |
Author(s): | Chris F Carroll, https://github.com/chrisfcarroll and contributors |
Last Update: | Friday, June 9, 2023 |
.NET Fiddle: | Create the first Fiddle |
Project Url: | https://github.com/chrisfcarroll/MailMerge |
NuGet Url: | https://www.nuget.org/packages/MailMerge |
Install
Install-Package MailMerge
dotnet add package MailMerge
paket add MailMerge
MailMerge Download (Unzip the "nupkg" after downloading)
Dependencies
- DocumentFormat.OpenXml(>= 2.8.1)
- Microsoft.Extensions.Configuration(>= 2.0.0)
- Microsoft.Extensions.Configuration.FileExtensions(>= 2.0.0)
- Microsoft.Extensions.Configuration.Json(>= 2.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions(>= 2.0.0)
- Microsoft.Extensions.Logging.Abstractions(>= 2.0.0)
- Microsoft.Extensions.Options.ConfigurationExtensions(>= 2.0.0)
Tags
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 ...]
```.