MailKit 2.6.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, ANNOTATE, 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.

Requires NuGet 2.12 or higher.

Install-Package MailKit -Version 2.6.0

dotnet add package MailKit --version 2.6.0

<PackageReference Include="MailKit" Version="2.6.0" />

paket add MailKit --version 2.6.0

#r "nuget: MailKit, 2.6.0"

// Install MailKit as a Cake Addin
#addin nuget:?package=MailKit&version=2.6.0

// Install MailKit as a Cake Tool
#tool nuget:?package=MailKit&version=2.6.0

Release Notes

* Properly handle connection drops in SmtpClient.NoOp() and NoOpAsync() methods.
* Improved default SSL certificate validation logic to be more secure and to recognize the most commonly used mail servers even if their Root CA Certificates are not available on the system.
* SslHandshakeException's Message has been improved to be based on the errors reported in the ServerCertificateValidationCallback and also now has 2 new X509Certificate properties which represent the ServerCertificate and the RootCertificateAuthority in order to help developers diagnose problems. (issue #1002)
* Improved the IMAP PreviewText to extract text from HTML bodies. (issue #1001)
* Renamed MessageSummaryItems.Id to MessageSummaryItems.EmailId to better map to the property name used in the IMAP OBJECTID specification.
* Updated NetworkStream.ReadAsync() and WriteAsync() methods to make use of timeouts. (issue #827)

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));

Dependencies

• .NETFramework 4.5

  • MimeKit (>= 2.6.0)

• .NETFramework 4.6

  • MimeKit (>= 2.6.0)

• .NETFramework 4.7

  • MimeKit (>= 2.6.0)

• .NETFramework 4.8

  • MimeKit (>= 2.6.0)

• .NETStandard 1.3

  • MimeKit (>= 2.6.0)
  • System.Net.NameResolution (>= 4.3.0)
  • System.Net.Security (>= 4.3.2)
  • System.Runtime.Serialization.Primitives (>= 4.3.0)

• .NETStandard 1.6

  • MimeKit (>= 2.6.0)
  • System.Net.NameResolution (>= 4.3.0)
  • System.Net.Security (>= 4.3.2)
  • System.Runtime.Serialization.Primitives (>= 4.3.0)

• .NETStandard 2.0

  • MimeKit (>= 2.6.0)
  • System.Net.NameResolution (>= 4.3.0)
  • System.Net.Security (>= 4.3.2)
  • System.Runtime.Serialization.Primitives (>= 4.3.0)

• MonoAndroid 0.0

  • MimeKit (>= 2.6.0)

• Xamarin.iOS 0.0

  • MimeKit (>= 2.6.0)

Used By

Version History