Rebex Mail Pack
IMAP, POP3, SMTP, EWS, MSG, MS Graph, MIME, S/MIME libraries for .NET
Download 30-day free trial Buy from $299More .NET libraries
-
Rebex File Transfer Pack
FTP and SFTP together
-
Rebex Total Pack
All Rebex .NET libraries together
Back to feature list...
Easy-to-use API
On this page:
Sending email using SMTP
A typical SMTP session goes through the following steps:
- Connect to an SMTP server.
- Validate the server certificate (this is done automatically by default, but you can perform the validation yourself).
- Log in - if required, authenticate with a user name and password or using a certificate.
- Send e-mail messages, etc.
- Disconnect.
The following code sends a simple mail message:
string sender = "my_account@gmail.com";
string recipient = "to@example.org";
string subject = "Test";
string body = "Hello World!";
// create SMTP client instance
using (var smtp = new Rebex.Net.Smtp())
{
// connect to Gmail SMTP server
smtp.Connect(gmail_smtp_hostname, SslMode.Explicit);
// authenticate with your email address and password
smtp.Login(sender, password);
// send mail
smtp.Send(sender, recipient, subject, body);
// disconnect (not required, but polite)
smtp.Disconnect();
}
Dim sender As String = "my_account@gmail.com"
Dim recipient As String = "to@example.org"
Dim subject As String = "Test"
Dim body As String = "Hello World!"
' create SMTP client instance
Using smtp = New Rebex.Net.Smtp()
' connect to Gmail SMTP server
smtp.Connect("smtp.gmail.com", SslMode.Explicit)
' authenticate with your email address and password
smtp.Login(sender, password)
' send mail
smtp.Send(sender, recipient, subject, body)
' disconnect (not required, but polite)
smtp.Disconnect()
End Using
Sending e-mail can be even easier. Check out Sending e-mail with a single line of code.
Getting list of unread emails using IMAP
A typical IMAP session goes through the following steps:
- Connect to an IMAP server.
- Validate the server certificate (this is done automatically by default, but you can perform the validation yourself).
- Log in - if required, authenticate with a user name and password or using a certificate.
- Select a folder, find email messages, download messages, etc.
- Disconnect.
The following code finds all unread e-mail messages and prints information about each of them:
// create IMAP client instance
using (var imap = new Rebex.Net.Imap())
{
// connect to Gmail IMAP server
imap.Connect("imap.gmail.com", SslMode.Implicit);
// authenticate
imap.Login(username, password);
// select folder to work with
imap.SelectFolder("INBOX");
// get list of unread messages
ImapMessageCollection list = imap.Search(ImapSearchParameter.Unread);
// print some info
foreach (ImapMessageInfo info in list)
{
Console.WriteLine("From: {0}", info.From);
Console.WriteLine("To: {0}", info.To);
Console.WriteLine("Subject: {0}", info.Subject);
}
// disconnect (not required, but polite)
imap.Disconnect();
}
' create IMAP client instance
Using imap = New Rebex.Net.Imap()
' connect to Gmail IMAP server
imap.Connect("imap.gmail.com", SslMode.Implicit)
' authenticate
imap.Login(username, password)
' select folder to work with
imap.SelectFolder("INBOX")
' get list of unread messages
Dim list As ImapMessageCollection = imap.Search(ImapSearchParameter.Unread)
' print some info
For Each info As ImapMessageInfo In list
Console.WriteLine("From: {0}", info.From)
Console.WriteLine("To: {0}", info.To)
Console.WriteLine("Subject: {0}", info.Subject)
Next
' disconnect (not required, but polite)
imap.Disconnect()
End Using
Note: Although implicit SSL mode has been discouraged since 1999 (see RFC 2595) Gmail and some other providers still only supports this mode. Explicit mode should be used instead when available.
Getting list of unread emails using Exchange Web Services (EWS)
A typical EWS (Exchange Web Services) session goes through the following steps:
- Connect to an Exchange server.
- Validate the server certificate (this is done automatically by default, but you can perform the validation yourself).
- Log in - if required, authenticate with a user name and password or using a certificate.
- Select a folder, find email messages, download messages, etc.
- Disconnect.
The following code finds all unread e-mail messages and prints information about each of them:
// create EWS client instance
using (var client = new Rebex.Net.Ews())
{
// connect to Exchange server
client.Connect(hostname, SslMode.Implicit);
// authenticate
client.Login(username, password);
// to select folder to work with use either:
// - client.FindFolder(EwsFolderId.Root, "folderName")
// - predefined folder id
var folder = EwsFolderId.Inbox;
// get list of unread messages
var list = client.Search(
folder,
EwsSearchParameter.IsRead(false));
// print some info
foreach (EwsMessageInfo messageInfo in list)
{
Console.WriteLine("From: {0}", messageInfo.From);
Console.WriteLine("To: {0}", messageInfo.To);
Console.WriteLine("Subject: {0}", messageInfo.Subject);
}
// disconnect (not required, but polite)
client.Disconnect();
}
' create IMAP client instance
Using client = New Rebex.Net.Ews()
' connect to Exchange server
client.Connect(hostname, SslMode.Implicit)
' authenticate
client.Login(username, password)
' to select folder to work with use either
' - client.FindFolder(EwsFolderId.Root, "folderName")
' - predefined folder id
Dim folder = EwsFolderId.Inbox
' get list of unread messages
Dim list As EwsMessageCollection = client.Search(
folder,
EwsSearchParameter.IsRead(False))
' print some info
For Each messageInfo As EwsMessageInfo In list
Console.WriteLine("From: {0}", messageInfo.From)
Console.WriteLine("To: {0}", messageInfo.To)
Console.WriteLine("Subject: {0}", messageInfo.Subject)
Next
' disconnect (not required, but polite)
client.Disconnect()
End Using
Getting list of unread emails using Microsoft Graph API
A typical Graph session goes through the following steps:
- Connect to Exchange Online (Microsoft 365) server.
- Authenticate using an OAuth access token.
- Find e-mail messages, download e-mails, send e-mails, or more.
- Disconnect.
The following code searches for unread e-mail messages and shows information about them:
// create Graph client instance
using (var client = new Rebex.Net.GraphClient())
{
// connect to Exchange Online (Microsoft 365) server
client.Connect();
// authenticate with your OAuth access token
client.Login(token);
// get first page of a list of unread messages from the 'Inbox' folder
var unread = GraphMessageSearchParameter.IsRead(false);
GraphMessageCollection messages = client.Search(GraphFolderId.Inbox, unread);
// print some info
foreach (GraphMessageInfo info in messages)
{
Console.WriteLine("Subject: {0}", info.Subject);
Console.WriteLine("From: {0}", info.From);
Console.WriteLine("To: {0}", info.To);
}
// disconnect (not required, but polite)
client.Disconnect();
}
Note: This code returns the first page of the results. See Paging results for more information about paging.
Downloading emails using POP3
A typical POP3 session goes through the following steps:
- Connect to a POP3 server.
- Validate the server certificate (this is done automatically by default, but you can perform the validation yourself).
- Log in - if required, authenticate with a user name and password or using a certificate.
- Download emails, delete emails, etc.
- Disconnect.
The following code downloads all emails:
// create POP3 client instance
using (var pop3 = new Rebex.Net.Pop3())
{
// connect to Gmail POP3 server
pop3.Connect("pop.gmail.com", SslMode.Implicit);
// authenticate
pop3.Login(username, password);
// get message list
Pop3MessageCollection list = pop3.GetMessageList();
// print some info
Console.WriteLine("{0} email(s) found.", list.Count);
// download all messages
foreach (Pop3MessageInfo info in list)
{
MailMessage mail = pop3.GetMailMessage(info.SequenceNumber);
// do something with the mail
// ...
}
// disconnect (required to commit delete operations)
pop3.Disconnect();
}
' create POP3 client instance
Using pop3 = New Rebex.Net.Pop3()
' connect to Gmail POP3 server
pop3.Connect("pop.gmail.com", SslMode.Implicit)
' authenticate
pop3.Login(username, password)
' get message list
Dim list As Pop3MessageCollection = pop3.GetMessageList()
' print some info
Console.WriteLine("{0} email(s) found.", list.Count)
' download all messages
For Each info As Pop3MessageInfo In list
' do something with the mail
' ...
Dim mail As MailMessage = pop3.GetMailMessage(info.SequenceNumber)
Next
' disconnect (required to commit delete operations)
pop3.Disconnect()
End Using
Note: Although implicit SSL mode has been discouraged since 1999 (see RFC 2595) Gmail and some other providers still only supports this mode. Explicit mode should be used instead when available.
Loading and saving Outlook mail messages using MSG
To load a message, use MsgMessage.Load()
method.
To save a message use MsgMessage.Save()
method.
Both methods accept path or Stream
arguments.
// create an instance of MsgMessage
var message = new MsgMessage();
// load a message from file
message.Load(@"C:\MyData\sample.msg");
// .. work with the message
// save the message into a memory stream for later use
var stream = new MemoryStream();
message.Save(stream);
stream.Position = 0;
' create an instance of MsgMessage
Dim message = New MsgMessage()
' load a message from file
message.Load("C:\MyData\sample.msg")
' .. work with the message
' save the message into a memory stream for later use
Dim stream = New MemoryStream()
message.Save(stream)
stream.Position = 0
Back to feature list...