Posts Tagged ‘IMAP’

Mark emails as read using IMAP

Wednesday, January 27th, 2010

First you need to download Mail.dll IMAP client.

The following code connects to IMAP server, downloads unique ids of all unseen emails and marks the first one as seen.

// C# version

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

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

	imap.SelectInbox();
	List<long> uids = client.SearchFlag(Flag.Unseen);
	if (uids.Count > 0)
		client.MarkMessageSeenByUID(uids[0]);
    imap.Close(true);
}
' 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) = client.SearchFlag(Flag.Unseen)
	If uids.Count > 0 Then
		client.MarkMessageSeenByUID(uids(0))
	End If
	imap.Close(True)
End Using

Please note that it is not possible to mark messages as read using POP3 protocol.

Download email attachments in .NET

Monday, January 25th, 2010

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

Uploading emails using IMAP

Monday, January 4th, 2010

Uploading emails to the IMAP server is fairly easy with Mail.dll IMAP client

First we’ll use Mail.dll to upload an existing email in eml format to the IMAP server:

// C# code

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

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

    string eml = File.ReadAllText("email.eml");

    // The name of the folder depends on your IMAP server
    imap.UploadMessage("[Gmail]/Sent Mail", eml);

    imap.Close(true);
}
' VB.NET code

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

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

	Dim eml As String = File.ReadAllText("email.eml")

	' The name of the folder depends on your IMAP server
	imap.UploadMessage("[Gmail]/Sent Mail", eml)

	imap.Close(True)
End Using

Second sample shows how to create new email message and upload it to IMAP server.

// C# code

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

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

    // Create new mail message
    SimpleMailMessageBuilder builder = new SimpleMailMessageBuilder();
    builder.Subject = "subject";
    builder.From.Add(new MailBox("alice@email.com", "Alice"));
    builder.To.Add(new MailBox("bob@email.com", "Bob"));
    builder.SetTextData("This is plain text email");

    // Upload
    // The name of the folder depends on your IMAP server
    imap.UploadMessage("[Gmail]/Sent Mail", builder.Create());

    imap.Close(true);
}
' VB.NET code

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

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

	' Create new mail message
	Dim builder As New SimpleMailMessageBuilder()
	builder.Subject = "subject"
	builder.From.Add(New MailBox("alice@email.com", "Alice"))
	builder.[To].Add(New MailBox("bob@email.com", "Bob"))
	builder.SetTextData("This is plain text email")

	' Upload
	' The name of the folder depends on your IMAP server
	imap.UploadMessage("[Gmail]/Sent Mail", builder.Create())

	imap.Close(True)
End Using

Please note that only few IMAP servers are going to send the message to the actual recipients. Most servers will only upload the message without sending it.
You should use SMTP protocol for this.
You can download Mail.dll IMAP client here.

Save raw eml file using IMAP and POP3

Monday, December 7th, 2009

mailThere 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

Download unseen emails from GMail

Friday, November 27th, 2009

gmail
The task is quite easy with Mail.dll IMAP client.
IMAP protocol unlike POP3 stores the unseen information on the server. So all we need to do is conect via SSL, search for unseen emails, and download them. Mail.dll will do all the hard work.

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

  1. Go to GMail settings:

    gmail_settings

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

    gmail_settings_tab

  3. And finally Check ‘Enable IMAP’ in ‘IMAP Access’ section:

    gmail_settings_imap

  4. Now you are able to connect to your GMail account with Mail.dll IMAP client.

Remember that GMail only allows secure SSL connections so we need to use ConnectSSL method. We’ll also use Imap.SearchFlag(Flag.Unseen) to list the ids of unseen email messages.

// C# code:

using(Imap imap = new Imap())
{
	imap.ConnectSSL("imap.gmail.com");

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

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

		Console.WriteLine(mail.Subject);
		Console.WriteLine(mail.TextDataString);
	}
	imap.Close(true);
}
' VB.NET code:

Using imap As New Imap()
	imap.ConnectSSL("imap.gmail.com")

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

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

		Console.WriteLine(mail.Subject)
		Console.WriteLine(mail.TextDataString)
	Next
	imap.Close(True)
End Using

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