{"id":219,"date":"2023-11-29T13:51:36","date_gmt":"2023-11-29T11:51:36","guid":{"rendered":"http:\/\/www.limilabs.com\/blog\/?p=219"},"modified":"2025-07-03T15:35:56","modified_gmt":"2025-07-03T13:35:56","slug":"imap-component-for-net","status":"publish","type":"post","link":"https:\/\/www.limilabs.com\/blog\/imap-component-for-net","title":{"rendered":"IMAP component for .NET"},"content":{"rendered":"\n

Mail.dll email component includes an excellent IMAP email component<\/a>. Unleash the full potential of email management with Mail.dll’s outstanding IMAP email component.<\/p>\n\n\n\n

It offers .NET developers an unparalleled tool for handling IMAP email protocol. From retrieving messages to managing folders and attachments, the IMAP component in Mail.dll simplifies complex tasks into user-friendly functions.<\/p>\n\n\n\n

Mail.dll is available for all regular .NET framework versions as well as for most recent .net\u00a06, 7, 8 and .net\u00a09 <\/strong>and higher.<\/p>\n\n\n\n

IMAP, short for Internet Message Access Protocol, is one of the two most prevalent Internet standard protocols for e-mail retrieval, the other being Post Office Protocol – POP3 (also available in Mail.dll). <\/p>\n\n\n\n

IMAP has many advantages over POP3<\/a>, most important are using folders to group emails, saving seen\/unseen state of the messages and search capability<\/a>.<\/p>\n\n\n\n

This article is going to show how easy is to connect to use IMAP client<\/strong> from .NET, download and parse unseen messages.<\/p>\n\n\n\n

Installation<\/h2>\n\n\n\n

The easiest way to install Mail.dll is to download it from nuget via Package Manager:<\/p>\n\n\n

\nPM> Install-Package Mail.dll\n<\/pre><\/div>\n\n\n
Alternatively you can download Mail.dll directly<\/a> from our website.<\/p>\n\n\n\n
Connect to IMAP<\/h2>\n\n\n\n
First you need connect to IMAP server. You should use Imap<\/code> class for that. Using<\/code> block ensures that IMAP connection is properly closed and disposed when you’re done.<\/p>\n\n\n
\nusing(Imap imap = new Imap())\n<\/pre><\/div>\n\n\n
In most cases you should be using TLS secured connection – ConnectSSL<\/code> method will choose a correct port and perform SSL\/TLS negotiation, then you perform IMAP authentictation:<\/p>\n\n\n
\n\timap.ConnectSSL(\"imap.server.com\");\n\timap.UseBestLogin(\"user\", \"password\");\n<\/pre><\/div>\n\n\n
Mail.dll supports OAuth 2.0 <\/strong>for authentication, you can find OAuth2 samples for Office365 and Gmail on the Mail.dll samples<\/a> page.<\/p>\n\n\n\n
For Gmail<\/strong> you may want to use Gmail’s App Passwords<\/a>.<\/p>\n\n\n\n
Search for unseen emails<\/h2>\n\n\n\n
As IMAP groups messages into folder you need to select a well know INBOX folder. All new, received emails are first placed in the INBOX folder first:<\/p>\n\n\n
\nimap.SelectInbox();\n<\/pre><\/div>\n\n\n
Then you perform a search that find all unseen messages<\/p>\n\n\n
\nList<long> uids = imap.Search(Flag.Unseen);\n<\/pre><\/div>\n\n\n
Download and parse emails<\/h2>\n\n\n\n
Finally you download emails one-by-one and parse them. You should use MailBuider<\/code> class to parse emails:<\/p>\n\n\n
\nvar eml = imap.GetMessageByUID(uid);\nIMail email = new MailBuilder().CreateFromEml(eml);\n<\/pre><\/div>\n\n\n
Entire code to download emails in .net<\/h2>\n\n\n\n
Entire code to download emails using IMAP is less than 20 lines:<\/p>\n\n\n
\nusing(Imap imap = new Imap())\n{\n\timap.ConnectSSL("imap.server.com");\t\/\/ or Connect for no TLS\n\timap.UseBestLogin("user", "password");\n\n\timap.SelectInbox();\n\tList<long> uids = imap.Search(Flag.Unseen);\n\n\tforeach (long uid in uids)\n\t{\n\t\tvar eml = imap.GetMessageByUID(uid);\n\t\tIMail email = new MailBuilder().CreateFromEml(eml);\n\n\t\tstring subject = mail.Subject;\n\t}\n\timap.Close();\n}\n<\/pre><\/div>\n\n\n
and for those who like VB.NET more:<\/p>\n\n\n
\nUsing imap As New Imap()\n\timap.ConnectSSL(\"imap.server.com\")\n\timap.UseBestLogin(\"user\", \"password\")\n\n\timap.SelectInbox()\n\tDim uids As List(Of Long) = imap.Search(Flag.Unseen)\n\n\tFor Each uid As Long In uids\n\t\tDim mail As IMail = New MailBuilder()_\n\t\t\t.CreateFromEml(imap.GetMessageByUID(uid))\n\n\t\tConsole.WriteLine(mail.Subject)\n\tNext\n\timap.Close()\nEnd Using\n<\/pre><\/div>\n\n\n
It can’t get much simpler than that!<\/p>\n\n\n\n
Summary<\/h2>\n\n\n\n
You can use Mail.dll .NET IMAP component to:<\/p>\n\n\n\n