First you’ll need an IMAP client or POP3 client to download emails from the server.

The email attachments are downloaded as a part of the message. Attachments are stored within the email as part of a mime tree. Usually Quoted-Printable or Base64 encoding are used. Mail.dll is going to parse such tree for you and expose all attachments as well known .NET collections.

ISimpleMailMessage uses 2 collections for storing attachments:

• Attachments - contains all attached documents
• Visuals - contains files that should be ‘displayed’ to the user (like images or music that should be played in background)

Following you’ll find samples of how you can save all attachments to disk using C# and VB.NET via POP3 and IMAP protocols.

When you use IMAP server:

// C# version
using(Imap imap = new Imap())
{
	imap.Connect("server");

	imap.User = "user";
	imap.Password = "password";
	imap.Login();

	imap.SelectInbox();
	List<long> uids = imap.SearchFlag(Flag.All);
	foreach (long uid in uids)
	{
		string eml = imap.GetMessageByUID(uid);
		ISimpleMailMessage email = new SimpleMailMessageBuilder()
			.CreateFromEml(eml);

		Console.WriteLine(email.Subject);

		// save all attachments to disk
		email.Attachments.ForEach(mime => mime.Save(mime.FileName));
		email.Visuals.ForEach(mime => mime.Save(mime.FileName));
	}
	imap.Close(true);
}

You can also save attachment to stream: void MimeData.Save(Stream stream)
Or get direct access to it: MemoryStream MimeData.GetMemoryStream()

' VB.NET version
Using imap As New Imap()
	imap.Connect("server")

	imap.User = "user"
	imap.Password = "password"
	imap.Login()

	imap.SelectInbox()
	Dim uids As List(Of Long) = imap.SearchFlag(Flag.All)
	For Each uid As Long In uids
		Dim eml As String = imap.GetMessageByUID(uid)
		Dim email As ISimpleMailMessage = New SimpleMailMessageBuilder()_
			.CreateFromEml(eml)

		Console.WriteLine(email.Subject)

		' save all attachments to disk
		email.Attachments.ForEach(Function(mime) mime.Save(mime.FileName))
		email.Visuals.ForEach(Function(mime) mime.Save(mime.FileName))
	Next
	imap.Close(True)
End Using

When you use POP3 server:

// C# version
using(Pop3 pop3 = new Pop3())
{
	pop3.Connect("server");

	pop3.User = "user";
	pop3.Password = "password";
	pop3.Login();

	pop3.GetAccountStat();
	for (int i = 1; i <= pop3.MessageCount; i++)
	{
		string eml = pop3.GetMessage(i);
		ISimpleMailMessage email = new SimpleMailMessageBuilder()
			.CreateFromEml(eml);

		Console.WriteLine(email.Subject);

		// save all attachments to disk
		email.Attachments.ForEach(mime => mime.Save(mime.FileName));
		email.Visuals.ForEach(mime => mime.Save(mime.FileName));
	}
	pop3.Close(true);
}

' VB.NET version
Using pop3 As New Pop3()
	pop3.Connect("server")

	pop3.User = "user"
	pop3.Password = "password"
	pop3.Login()

	pop3.GetAccountStat()
	For i As Integer = 1 To pop3.MessageCount
		Dim eml As String = pop3.GetMessage(i)
		Dim email As ISimpleMailMessage = New SimpleMailMessageBuilder()_
			.CreateFromEml(eml)

		Console.WriteLine(email.Subject)

		' save all attachments to disk
		email.Attachments.ForEach(Function(mime) mime.Save(mime.FileName))
		email.Visuals.ForEach(Function(mime) mime.Save(mime.FileName))
	End While
	pop3.Close(True)
End Using

There are times that you need to save raw eml format of the email (for example when you want to report a bug).

This tutorial shows how to use Mail.dll POP3 and IMAP clients to achieve this goal.

Notice that we are not parsing the emails so we should not use SimpleMailMessageBuilder and ISimpleMailMessage classes.

IMAP version:

// C# code

using (Imap imap = new Imap())
{
    imap.Connect("server");

    imap.User = "user";
    imap.Password = "password";
    imap.Login();

    imap.SelectInbox();

    List<long> uids = imap.Search(
        Expression.Subject("email subject"));

    foreach (long uid in uids)
    {
        string eml = imap.GetMessageByUID(uid);
        string fileName = string.Format("email_{0}.eml", uid);
        File.WriteAllText(fileName, eml);
    }
    imap.Close(true);
}

' VB.NET code

Using imap As New Imap()
	imap.Connect("server")

	imap.User = "user"
	imap.Password = "password"
	imap.Login()

	imap.SelectInbox()

	Dim uids As List(Of Long) = imap.Search(Expression.Subject("email subject"))

	For Each uid As Long In uids
		Dim eml As String = imap.GetMessageByUID(uid)
		Dim fileName As String = String.Format("email_{0}.eml", uid)
		File.WriteAllText(fileName, eml)
	Next
	imap.Close(True)
End Using

POP3 version:

// C# code

using (Pop3 pop3 = new Pop3())
{
    pop3.Connect("server");

    pop3.User = "user";
    pop3.Password = "password";
    pop3.Login();

    pop3.GetAccountStat();
    for (int i = 1; i <= pop3.MessageCount; i++)
    {
        string eml = pop3.GetMessage(i);
        string fileName = string.Format("email_{0}.eml", i);
        File.WriteAllText(fileName, eml);
    }
    pop3.Close(true);
}

' VB.NET code

Using pop3 As New Pop3()
	pop3.Connect("server")

	pop3.User = "user"
	pop3.Password = "password"
	pop3.Login()

	pop3.GetAccountStat()
	For i As Integer = 1 To pop3.MessageCount
		Dim eml As String = pop3.GetMessage(i)
		Dim fileName As String = String.Format("email_{0}.eml", i)
		File.WriteAllText(fileName, eml)
	End While
	pop3.Close(True)
End Using

You can download Mail.dll at: Mail.dll .NET email component

Accessing Gmail with POP3 is a bit different that accessing other POP3 servers. Still is quite easy with Mail.dll IMAP client. Remember that POP3 protocol unlike IMAP does not store the unseen information on the server.

Mail.dll has of course IMAP support

First we need to make sure that POP3 access is enabled for your GMail account.

1. Go to GMail settings:

   

2. Then select ‘Forwarding and POP/IMAP’ tab:

   

3. And check one of the ‘Enable …’ options in ‘IMAP Access’ section:

   

4. GMail behaves differently than other POP3 servers and its POP3 configuration may be sometimes confusing.
   Luckily you can configure what you expect from it. Here’s the value list of drop down list called “When messages are accessed with POP” and the Gmail’s behavior:
   1. “delete Gmail’s copy”: Message is deleted by issuing GetMessage command.
   2. “keep Gmail’s copy in the Inbox”: Message stays in the Inbox, Web interface says it’s unread, however message is not received for the second time using POP3 client.
   3. “archive Gmail’s copy”: Message is deleted by issuing GetMessage command, however it is possible to find it using web interface.
5. Now you are able to connect to your GMail account with Mail.dll POP3 client.

If you want to have a greater control over your mail you should use
Mail.dll .NET IMAP client. You can easily move messages between folders (IMAP calls them mailboxes) and flag them.

Remember that GMail only allows secure SSL connections so we need to use ConnectSSL method.

// C# code:

using(Pop3 pop3 = new Pop3())
{
	pop3.ConnectSSL("pop.gmail.com");

	pop3.User =  "your_email@gmail.com";
	pop3.Password = "password";
	pop3.Login();

	pop3.GetAccountStat();

	for(int i = 1; i <= pop3.MessageCount; i++)
	{
		string eml = pop3.GetMessage(i);
		ISimpleMailMessage mail= new SimpleMailMessageBuilder()
			.CreateFromEml(eml);

		Console.WriteLine(mail.Subject);
		Console.WriteLine(mail.TextDataString);
	}
	pop3.Close(false);
}

' VB.NET code:

Using pop3 As New Pop3()
	pop3.ConnectSSL("pop.gmail.com")

	pop3.User = "your_email@gmail.com"
	pop3.Password = "password"
	pop3.Login()

	pop3.GetAccountStat()

	For i As Integer = 1 To pop3.MessageCount
		Dim eml As String = pop3.GetMessage(i)
		Dim mail As ISimpleMailMessage = New SimpleMailMessageBuilder()_
			.CreateFromEml(eml)

		Console.WriteLine(mail.Subject)
		Console.WriteLine(mail.TextDataString)
	End While
	pop3.Close(False)
End Using

If you like the idea of simple GMail access just give it a try for yourself and download it at: Mail.dll .NET email component