EAGetMail POP3 & IMAP4 Component > Developer Center > C# - .NET Framework > Retrieve Email and Parse Email in C# - Tutorial

Retrieve Email and Parse Email in C# - Tutorial

Date: June 28, 2014

Introduction

This tutorial introduces how to retrieve email and parse email in C# using POP3/IMAP4/EWS/WebDAV protocol. It also demonstrates retrieving email over SSL/TLS connection, verifying email digital signature, decrypting encrypted email (S/MIME), parsing email attachment, parsing non-delivery report (NDR) and managing mail folder.

Tutorial Index

Installation

EAGetMail is a POP3 and IMAP4 component which supports all operations of POP3/IMAP4/MIME/Exchange Web Service/WebDAV/SSL/S/MIME protocol. Before you can use the following example codes, you should download the EAGetMail Installer and install it on your machine at first.

Retrieve email in a simple C# project

To better demonstrate how to retrieve email and parse email, let's create a C# console project named "receiveemail" at first, and then add the reference of EAGetMail in your project.

c# console project

Add Reference of EAGetMail to Visual Stuido C#.NET Project

To use EAGetMail POP3 & IMAP Component in your project, the first step is "Add reference of EAGetMail to your project". Please create/open your project with Visual Studio.NET, then choose menu->"Project"->"Add Reference"->".NET"->"Browse...", and choose the EAGetMail{version}.dll from your disk, click "Open"->"OK", the reference of EAGetMail will be added to your project, and you can start to use EAGetMail POP3 & IMAP Component in your project.

add reference in c#

Because EAGetMail has separate builds for .Net Framework, please refer to the following table and choose the correct dll.

Separate builds of run-time assembly for .Net Framework 1.1, 2.0, 3.5, 4.0, 4.5 and .Net Compact Framework 2.0, 3.5.

File .NET Framework Version
EAGetMail.dll Built with .NET Framework 1.1
It requires .NET Framework 1.1, 2.0, 3.5 or later version.
EAGetMail20.dll Built with .NET Framework 2.0
It requires .NET Framework 2.0, 3.5 or later version.
EAGetMail35.dll Built with .NET Framework 3.5
It requires .NET Framework 3.5 or later version.
EAGetMail40.dll Built with .NET Framework 4.0
It requires .NET Framework 4.0 or later version.
EAGetMail45.dll Built with .NET Framework 4.5
It requires .NET Framework 4.5 or later version.
EAGetMailCF20.dll Built with .NET Compact Framework 2.0
It requires .NET Compact Framework 2.0, 3.5 or later version.
EAGetMailCF35.dll Built with .NET Compact Framework 3.5
It requires .NET Compact Framework 3.5 or later version.

[C# Example - Retrieve email from POP3 server]

Now add the following codes to the project. The following code demonstrates how to retrieve email from a POP3 mail account. This sample downloads emails from POP3 server and deletes the email after the email is retrieved.

using System;
using System.Collections.Generic;
using System.Text;
using System.IO;
using EAGetMail; //add EAGetMail namespace

namespace receiveemail
{
    class Program
    { 
        static void Main(string[] args)
        {
            // Create a folder named "inbox" under current directory
            // to save the email retrieved.
            string curpath = Directory.GetCurrentDirectory();
            string mailbox = String.Format("{0}\\inbox", curpath);

            // If the folder is not existed, create it.
            if (!Directory.Exists(mailbox))
            {
                Directory.CreateDirectory(mailbox);
            }

            MailServer oServer = new MailServer("pop3.emailarchitect.net", 
                        "test@emailarchitect.net", "testpassword", ServerProtocol.Pop3 );
            MailClient oClient = new MailClient("TryIt");

            // If your POP3 server requires SSL connection,
            // Please add the following codes:
            // oServer.SSLConnection = true;
            // oServer.Port = 995;

            try
            {
                oClient.Connect(oServer);
                MailInfo[] infos = oClient.GetMailInfos();
                for (int i = 0; i < infos.Length; i++)
                {
                    MailInfo info = infos[i];
                    Console.WriteLine("Index: {0}; Size: {1}; UIDL: {2}",
                        info.Index, info.Size, info.UIDL);

                    // Receive email from POP3 server
                    Mail oMail = oClient.GetMail(info);

                    Console.WriteLine("From: {0}", oMail.From.ToString());
                    Console.WriteLine("Subject: {0}\r\n", oMail.Subject);

                    // Generate an email file name based on date time.
                    System.DateTime d = System.DateTime.Now;
                    System.Globalization.CultureInfo cur = new 
                        System.Globalization.CultureInfo("en-US");
                    string sdate = d.ToString("yyyyMMddHHmmss", cur);
                    string fileName = String.Format("{0}\\{1}{2}{3}.eml",
                        mailbox, sdate, d.Millisecond.ToString("d3"), i);

                    // Save email to local disk
                    oMail.SaveAs(fileName, true);

                    // Mark email as deleted from POP3 server.
                    oClient.Delete(info);
                }

                // Quit and pure emails marked as deleted from POP3 server.
                oClient.Quit();
            }
            catch (Exception ep)
            {
                Console.WriteLine(ep.Message);
            }

        }
    }
}

If you set everything right, you can get emails in the mail folder. If the codes threw exception, then please have a look at the following section.

Where can I get my POP3 server address, user and password?

Because each email account provider has different server address, so you should query your POP3 server address from your email account provider. User name is your email address or your email address without domain part. It depends on your email provider setting.

When you execute above example code, if you get error about "Networking connection" or "No such host", it is likely that your POP3 server address is not correct. If you get an error like "Invalid user or password", it is likely that you did not set the correct user or password.

Finally, if you have already set your account in your email client such as Outlook or Window Mail, you can query your POP3 server address, user in your email client. For example, you can choose menu -> "Tools" - > - "Accounts" - > "Your email account" - > "Properties" - > "Servers" in Outlook express or Windows Mail to get your POP3 server, user. Using EAGetMail to receive email does not require you have email client installed on your machine or MAPI, however you can query your exist email accounts in your email client.

c# console email sample

Troubleshooting

When you retrieve email in above simple C# project, if it returned an error, please have a look at the following tips:

"No Such Host" Error

This error means DNS server cannot resolve POP3 server, you should check if you input correct server address. If your server address is correct, you should check if your DNS server setting is correct.

Common "Socket/Networking Connection" Error

This error means there is a problem with networking connection to POP3 server. You can use Windows built-in Telnet command to detect the networking connection.

Using Telnet to detect networking connection to POP3 server

Notice: in Windows 2008/Windows 8 or later version, "Telnet Client" is not installed by default, you should enable this command in "Control Panel" -> "Programs and Features" -> "Turn Windows feature on or off" -> have "Telnet Client" checked.

Under DOS command prompt, input "telnet [serveraddress] [port]":

telnet mail.emailarchitect.net 110
press enter.

If the networking connection to your POP3 server is good, it should return a message like "+OK ...". If it returns "Could not open connection to ...", that means the networking connection to POP3 server is bad, or outbound 110 port is blocked by anti-virus software, firewall or ISP. Please have a look at the following screenshot:

detect POP3 connection using telnet

POP3 110, 995 port and IMAP4 143, 993 port

110 port is the default POP3 server port to receive email. 995 port is the common port used to receive email over implicit SSL connection. If you use telnet to test 995 port, it doesn't return the "+OK...", because it requires SSL hand shake. But if the connection is ok, telnet returns a flash cursor.

"-ERR user authentication" Error

This error means user authentication is failed, you should check whether you input correct user/password. Password is always case-sensitive.

Other error returned by POP3 server

If POP3 server returns an error, it usually returns description about this error. You can use the following codes to generate a log file to learn all POP3 session between client and server.

[C# - Using log file to detect POP3 server response - Example]

oClient.LogFileName = "d:\\pop3.txt";
Next Section

In this section, I introduced the basic things of retrieving email in C# with EAGetMail. At next section I will introduce how to retrieve email from IMAP4 server.

Next: Retrieve email from IMAP4 server in C# >

Expand All Sections >> 1  2  3  4  5  6  7  8  9  10  11  12  13  14  15  16  17  18  

Appendix

Using UIDLManager to Mark Email as Read/Downloaded
Search Email and Filter Email on IMAP4/MS Exchange Server
Parse Outlook .MSG file

Comments

If you have any comments or questions about above example codes, please click here to add your comments.

Send Email - C# - VB6 - Visual Basic - VC++ - C++/CLI - Delphi

Retrieve Email and Parse Email - C# - VB6 - Visual Basic - VC++ - C++/CLI - Delphi

Email Solution - Email Server - DomainKeys and DKIM - Disclaimer

2003 - 2014 © Copyright AdminSystem Software Limited. All rights reserved.   About us     Follow emailarchitect on Twitter   Follow emailarchitect on facebook