MailMergeLib 5.8.1
.NET Standard 2.1
This package targets .NET Standard 2.1. The package is compatible with this framework or higher.
.NET Framework 4.6.1
This package targets .NET Framework 4.6.1. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet add package MailMergeLib --version 5.8.1
NuGet\Install-Package MailMergeLib -Version 5.8.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="MailMergeLib" Version="5.8.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add MailMergeLib --version 5.8.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: MailMergeLib, 5.8.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install MailMergeLib as a Cake Addin #addin nuget:?package=MailMergeLib&version=5.8.1 // Install MailMergeLib as a Cake Tool #tool nuget:?package=MailMergeLib&version=5.8.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
What is MailMergeLib?
MailMergeLib
version 5 is an SMTP mail client library which provides comfortable mail merge capabilities. MailMergeLib
is written in C# and comes with the following features:
Mail message generation
- Email templates can be fully individualized in terms of recipients, subject, HTML and/or plain text, attachments and even headers. Placeholders are inserted as variable names from data source between curly braces like so:
{MailboxAddress.Name}
or with formatting arguments like{Date:yyyy-MM-dd}
. - HTML text may contain images from local hard disk, which will be automatically inserted as inline attachments.
- For HTML text
MailMergeLib
can generate a plain text representation. - Attachment sources can be files, streams or strings.
- The data source for email merge messages to a number of recipients and be any
IEnumerable
object as well asDataTable
s. The data source for single emails can be any of the following types:Dictionary<string,object>
,ExpandoObject
,DataRow
, any class instances or anonymous types. For class instances it's even allowed to use the name of parameter less methods. - Placeholders in the email can be formatted with any of the features known from string.Format by using SmartFormat.NET. SmartFormat is a parser coming close to string.Format's speed, but bringing a lot of additional options like easy pluralization for many languages.
- Resulting emails are MimeMessages from MimeKit, an outstanding tool for creating and parsing emails, covering all relevant MIME standards making sure that emails are not qualified as SPAM.
- Support for international email address format.
Sending email messages
- Practically unlimited number of parallel tasks to send out individualized emails to a big number of recipients.
- SmptClients for each task can get their own preconfigured settings, so that e.g. several mail servers can be used for one send job.
- Progress of processing emails can easily be observed with a number of events.
- SMTP failures can automatically be resolved supplying a backup configuration. This fault-tolerance is essential for unattended production systems.
- Emails are sent using the SmtpClient from MailKit, the sister project to MimeKit. SmtpClient is highly flexible and can be configured for literally every scenario you can think of.
- Instead of sending, emails can also be stored in MIME formatted text files, e.g. if a "pickup directory" from IIS or Microsoft Exchange shall be used. If needed, these files can be loaded back into a MimeMessage from MimeKit.
Save and restore
- Messages and templates can be saved and loaded to/from XML files.
- Configuration settings for messages and SMTP can be stored to and loaded from an XML file.
Both
- Fine grained control over the whole process of email message generation and distribution.
- Clearly out-performs .NET
System.Net.Mail
. - RFC standards compliant.
- We aks you not to use
MailMergeLib
for sending unsolicited bulk email.
Supported Frameworks
- .Net Framework 4.6.1 and later
- .Net Standard 2.1 and later
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.1 is compatible. |
.NET Framework | net461 is compatible. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
.NETFramework 4.6.1
- AngleSharp (>= 0.16.1)
- MailKit (>= 3.0.0 && < 4.0.0)
- MimeKit (>= 3.0.0 && < 4.0.0)
- SmartFormat.NET (>= 2.5.0 && <= 2.7.2)
- YAXLib (>= 3.0.0 && < 4.0.0)
-
.NETStandard 2.1
- AngleSharp (>= 0.16.1)
- MailKit (>= 3.0.0 && < 4.0.0)
- MimeKit (>= 3.0.0 && < 4.0.0)
- SmartFormat.NET (>= 2.5.0 && <= 2.7.2)
- YAXLib (>= 3.0.0 && < 4.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated | |
---|---|---|---|
5.12.3 | 500 | 7/30/2024 | |
5.12.2 | 99 | 7/25/2024 | |
5.12.1 | 231 | 7/16/2024 | |
5.12.0 | 275 | 6/6/2024 | |
5.11.1 | 1,270 | 7/4/2023 | |
5.11.0 | 236 | 6/29/2023 | |
5.10.0 | 164 | 6/22/2023 | |
5.9.1 | 1,043 | 1/14/2023 | |
5.8.2 | 14,441 | 6/3/2022 | |
5.8.1 | 476 | 6/3/2022 | |
5.8.0 | 1,026 | 2/4/2022 | |
5.7.1 | 31,407 | 1/5/2021 | |
5.7.0.1 | 20,361 | 11/15/2019 | |
5.6.1 | 2,214 | 12/29/2018 | |
5.6.0 | 1,265 | 12/28/2018 | |
5.5.0 | 14,444 | 6/15/2018 | |
5.4.1 | 1,689 | 3/10/2018 | |
5.4.0 | 1,184 | 2/17/2018 | |
5.3.0 | 3,441 | 8/18/2017 | |
5.2.0.1 | 6,940 | 4/5/2017 | |
5.2.0 | 1,409 | 11/12/2016 | |
5.0.1.1 | 2,005 | 10/9/2016 |
See the change log with links to the Wiki for details of this release:
https://github.com/axuno/MailMergeLib/blob/main/ReleaseNotes.md