MailKit 2.3.0

MailKit is an Open Source cross-platform .NET mail-client library that is based on MimeKit and optimized for mobile devices.

Features include:
* HTTP, Socks4, Socks4a and Socks5 proxy support.
* SASL Authentication via SCRAM-SHA-256, SCRAM-SHA-1, NTLM, DIGEST-MD5, CRAM-MD5, LOGIN, PLAIN, and XOAUTH2.
* A fully-cancellable SmtpClient with support for STARTTLS, 8BITMIME, BINARYMIME, ENHANCEDSTATUSCODES, SIZE, DSN, PIPELINING and SMTPUTF8.
* A fully-cancellable Pop3Client with support for STLS, UIDL, APOP, PIPELINING, UTF8, and LANG.
* A fully-cancellable ImapClient with support for ACL, QUOTA, LITERAL+, IDLE, NAMESPACE, ID, CHILDREN, LOGINDISABLED, STARTTLS, MULTIAPPEND, UNSELECT, UIDPLUS, CONDSTORE, ESEARCH, SASL-IR, COMPRESS, WITHIN, ENABLE, QRESYNC, SORT, THREAD, LIST-EXTENDED, ESORT, METADATA / METADATA-SERVER, NOTIFY, FILTERS, LIST-STATUS, SORT=DISPLAY, SPECIAL-USE / CREATE-SPECIAL-USE, SEARCH=FUZZY, MOVE, UTF8=ACCEPT / UTF8=ONLY, LITERAL-, APPENDLIMIT, STATUS=SIZE, OBJECTID, XLIST, and X-GM-EXT1.
* Client-side sorting and threading of messages (the Ordinal Subject and the Jamie Zawinski threading algorithms are supported).
* Asynchronous versions of all methods that hit the network.
* S/MIME, OpenPGP, DKIM and ARC support via MimeKit.
* Microsoft TNEF support via MimeKit.

There is a newer version of this package available.
See the version list below for details.

Requires NuGet 2.12 or higher.

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

Release Notes

* Improved the default SSL/TLS certificate validation logic.
* Improved exception messages for the POP3 LIST and STAT commands.
* Modified Pop3Client to accept negative values for the 'octets' value in the STAT response. (issue #872)
* Added work-around for IMAP BODYSTRUCTURE responses that treat multiparts as basic parts. (issue #878)
* Added check to make sure that MD5 is supported by the runtime and automatically disable support for CRAM-MD5 and DIGEST-MD5 SASL mechanisms when MD5 is not supported.
* Added a Stream property to ProtocolLogger.
* Fixed fetching of PreviewText items if the body's ContentTransferEncoding is NIL. (issue #881)
* Improved processing of pipelined SMTP commands to provide better exception messages. (issue #883)
* Modified SmtpClient.Send() and SendAsync() methods to not call MimeMessage.Prepare() if any DKIM or ARC headers are present in order to avoid the potential risk of altering the message and breaking the signatures within those headers.
* Added protected SmtpClient.SendCommand() and SendCommandAsync() methods to allow custom subclasses the ability to send custom commands to the SMTP server. (issue #891)
* Allow SmtpClient subclasses to override message preparation by overriding a new SmtpClient.Prepare() method. (issue #891)
* Improved ImapFolder's ModSeqChanged event to set the UniqueId property if available in unsolicited FETCH notifications including a MODSEQ and UID value.
* Fixed the IMAP client logic to properly handle lower or mixed case IMAP tokens. (issue #893)
* Added support for IMAP's ANNOTATE-EXPERIMENT-1 extension. (issue #818)
* Always use the SMTP BDAT command instead of DATA if CHUNKING is supported. (issue #896)
* Improved SmtpClient to include a SIZE= parameter in the MAIL FROM command if the SIZE extension is supported. Progress reporting will now always have the expected message size available as well.

API Changes Since 2.0.x:

* Obsoleted SearchQuery.HasCustomFlags() and SearchQuery.DoesNotHaveCustomFlags(). These are now SearchQuery.HasKeywords() and SearchQuery.NotKeywords(), respectively.
* Obsoleted SearchQuery.DoesNotHaveFlags() in favor of SearchQuery.NotFlags().
* Obsoleted the IMessageSummary.UserFlags property in favor of IMessageSummary.Keywords.
* Obsoleted the MessageFlagsChangedEventArgs.UserFlags property in favor of MessageFlagsChangedEventArgs.Keywords.
* All IMailFolder.Fetch and IMailFolder.FetchAsync methods that took a HashSet<string> userFlags argument now take an IEnumerable<string> keywords argument. Note: this only affects you if your code used named method parameters (e.g. userFlags: myUserFlags).

Note to users upgrading from MailKit 1.x:

In order to authenticate using the XOAUTH2 SASL mechanism, you must now use the following approach:

client.Authenticate (new SaslMechanismOAuth2 (username, auth_token));

NuGet packages (298)

Showing the top 5 NuGet packages that depend on MailKit:

Package Downloads
Serilog.Sinks.Email
The email sink for Serilog
NETCore.MailKit
MailKit extension for asp.net core. Easy send email in asp.net core project.
Abp.MailKit
Abp.MailKit
NLog.MailKit
NLog Mail Target for .NET Core & .NET Standard, and .NET 4.5+ using MailKit. This package add the mail target to NLog and has the same options* as the original Mail Target. If the mail target was already available on your platform (.NET Standard 2+, .NET 4.5), this package will overwrite the original Mail Target. * Compared to the original MailTarget, the following options aren't implemented: - PickupDirectory - NTLM auth * MailKit gives more control of the sockets, so you get the `secureSocketOption` option for free!
OElite.Web
OElite Web API SDK for OElite Platform based application development

GitHub repositories (49)

Showing the top 5 popular GitHub repositories that depend on MailKit:

Repository Stars
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
bitwarden/server
The core infrastructure backend (API, database, Docker, etc).
duplicati/duplicati
Store securely encrypted backups in the cloud!
nopSolutions/nopCommerce
The most popular open-source eCommerce shopping cart solution based on ASP.NET Core
dodyg/practical-aspnetcore
Practical samples of ASP.NET Core 2.1, 2.2, 3.1, and 5.0 projects you can use. Readme contains explanations on all projects.

Version History

Version Downloads Last updated
2.10.0 11,133 11/21/2020
2.9.0 422,450 9/12/2020
2.8.0 558,752 7/11/2020
2.7.0 488,388 5/30/2020
2.6.0 935,924 4/4/2020
2.5.2 268,787 3/14/2020
2.5.1 425,147 2/15/2020
2.5.0 380,352 1/18/2020
2.4.1 768,345 11/10/2019
2.4.0.1 65,499 11/5/2019
2.4.0 11,070 11/3/2019
2.3.2 202,912 10/12/2019
2.3.1.6 495,847 9/9/2019
2.3.1 27,662 9/8/2019
2.3.0 359,403 8/24/2019
2.2.0 1,043,728 6/11/2019
2.1.5.1 373,912 5/13/2019
2.1.4 298,671 4/13/2019
2.1.3 567,417 2/24/2019
2.1.2 614,828 12/30/2018
2.1.1 125,072 12/17/2018
2.1.0.3 79,984 12/7/2018
2.0.7 247,962 10/28/2018
2.0.6 747,158 8/4/2018
2.0.5 245,846 7/7/2018
2.0.4 337,653 5/25/2018
2.0.3 329,077 4/15/2018
2.0.2 111,334 3/18/2018
2.0.1 750,860 1/6/2018
2.0.0 66,237 12/22/2017
1.22.0 270,017 11/24/2017
1.20.0 205,181 10/28/2017
1.18.1.1 456,322 9/4/2017
1.18.1 10,111 9/3/2017
1.18.0 124,603 8/7/2017
1.16.2 337,287 7/1/2017
1.16.1 329,749 5/5/2017
1.16.0 69,584 4/21/2017
1.14.2 37,106 4/12/2017
1.12.0 111,369 3/12/2017
1.10.2 113,021 1/28/2017
1.10.1 150,814 12/4/2016
1.10.0 374,967 10/31/2016
Show less