Mail.dll - How to start

After installation, this class reference, C# and VB.NET examples can be found in your Start menu.

Go here for licensing and general help, and here for ordering.

Note
If you need help, please visit our technical Q&A forum. You can find many samples online.

Add reference and namespaces

First you have to add reference to Mail.dll to your project. See MSDN how to. Then add all namespaces you need:

C++

Copy

// C#

using Limilabs.Client.IMAP;
using Limilabs.Client.POP3;
using Limilabs.Client.SMTP;
using Limilabs.Mail;
using Limilabs.Mail.MIME;
using Limilabs.Mail.Fluent
using Limilabs.Mail.Headers;

' VB.NET

Imports Limilabs.Client.IMAP
Imports Limilabs.Client.POP3
Imports Limilabs.Client.SMTP
Imports Limilabs.Mail
Imports Limilabs.Mail.MIME
Imports Limilabs.Mail.Fluent
Imports Limilabs.Mail.Headers

Receive emails from IMAP server

We connect to IMAP server using Imap class, then log in and acquire IMail object using MailBuilder class.

C++

Copy

// C#

using(Imap imap = new Imap())
{
    imap.ConnectSSL("imap.server.com");       // or Connect for non SSL/TLS
    imap.UseBestLogin("user", "password");

    imap.SelectInbox();

    List<long> uidList = imap.Search(Flag.Unseen);
    foreach (long uid in uidList)
    {
        IMail email = new MailBuilder()
            .CreateFromEml(imap.GetMessageByUID(uid));

        string subject = email.Subject;
        string text = email.GetBodyAsText();
    }
    imap.Close();
}

' VB.NET

Using imap As New Imap
    imap.ConnectSSL("imap.server.com")       ' or Connect for non SSL/TLS
    imap.UseBestLogin("user", "password")

    imap.SelectInbox()

    Dim uidList As List(Of Long) = imap.Search(Flag.Unseen)
    For Each uid As Long In uidList
        Dim email As IMail = New MailBuilder() _
            .CreateFromEml(imap.GetMessageByUID(uid))

        Dim subject As String = email.Subject
        Dim text As String = email.GetBodyAsText()
    Next
    imap.Close()
End Using

Receive emails from POP3 server

We connect to POP3 server using Pop3 class, then log in and acquire IMail object using MailBuilder class.

C++

Copy

// C#

using(Pop3 pop3 = new Pop3())
{
    pop3.ConnectSSL("pop3.server.com");       // or Connect for non SSL/TLS
    pop3.UseBestLogin("user", "password");

    foreach (string uid in pop3.GetAll())
    {
        IMail email = new MailBuilder()
            .CreateFromEml(pop3.GetMessageByUID(uid));

        string subject = email.Subject;
        string text = email.GetBodyAsText();
    }
    pop3.Close();
}

' VB.NET

Using pop3 As New Pop3
    pop3.ConnectSSL("pop3.server.com")       ' or Connect for non SSL/TLS
    pop3.UseBestLogin("user", "password")

    For Each uid As String In pop3.GetAll()
       Dim email As IMail = New MailBuilder() _
            .CreateFromEml(pop3.GetMessageByUID(uid))

        Dim subject As String = email.Subject
        Dim text As String = email.GetBodyAsText()
    Next
    pop3.Close()
End Using

Send emails using SMTP server

You have to create IMail object. Use MailBuilder class or fluent interface, then connect to your SMTP server using Smtp and send your message.

C++

Copy

// C#

MailBuilder builder = new MailBuilder();
builder.From.Add(new MailBox("from@example.com"));
builder.To.Add(new MailBox("to@example.com"));
builder.Html = @"Html with an image: <img src=""cid:lena"" />";
builder.Subject = "Subject";

MimeData visual = builder.AddVisual(@"c:\lena.jpeg");
visual.ContentId = "lena";

MimeData attachment = builder.AddAttachment(@"c:\tmp.doc");
attachment.SetFileName("document.doc", guessContentType: true);

IMail email = builder.Create();

using(Smtp smtp = new Smtp())
{
    smtp.Connect("smtp.server.com");       // or ConnectSSL for SSL/TLS
    smtp.UseBestLogin("user", "password");

    smtp.SendMessage(email);

    smtp.Close();
}

' VB.NET

Dim builder As New MailBuilder()
builder.From.Add(New MailBox("from@example.com"))
builder.[To].Add(New MailBox("to@example.com"))
builder.Subject = "Subject"
builder.Html = "Html with an image: <img src=""cid:lena"" />"

Dim visual As MimeData = builder.AddVisual("c:\lena.jpeg")
visual.ContentId = "lena"

Dim attachment As MimeData = builder.AddAttachment("c:\tmp.doc")
attachment.SetFileName("document.doc", guessContentType:=True)

Dim email As IMail = builder.Create()

Using smtp As Smtp = New Smtp
    smtp.Connect("smtp.server.com")       ' or ConnectSSL for SSL/TLS
    smtp.UseBestLogin("user", "password")

    smtp.SendMessage(email)

    smtp.Close()
End Using

Samples online

Note
If you need help, please visit our technical Q&A forum. You can find many samples online.