GPAL Fluent: High-level fluent C# API

//Receive fills the message list and returns the mail object, so SaveTo and MarkAllAsRead can follow it in the same chain when the whole batch is treated alike. Per-message MarkAsRead and Delete open a connection each, so a loop over many messages is many logins; the MarkAllAsRead and DeleteAll pair do the same work in one. An attachment is written under the filename the sender chose, reduced to a filename first, so a name like ..\..\startup.cmd cannot write outside the directory you asked for. A file already in that directory is replaced.

// the mail object first, then the server settings and the envelope on it

IGPALMail mail = GPAL.Mail.ToGPALObject();

// Only what has not been read, and never more than 25 at a time

IGPALMail mail = mail

.WithIMAPServerName("imap.example.com")

.WithCredentials(mailLogin)

.WithUnreadOnly(true)

.WithMaxMessages(25)

.ToGPALObject();

mail.Receive(out List<ReceivedEmail> received);

// Handle each one, and only then say it has been handled

foreach (ReceivedEmail email in received)

{

if (false == email.Subject.Contains("Invoice")) continue;

List<GPALFile> saved = email.SaveTo((GPALFile)"C:\Inbox\invoices");

foreach (GPALFile invoice in saved)

GPAL.PublishSimpleEvent(GPALEventType.NOTICE,

$"Saved [{invoice.Filename}] from [{email.From}] sent [{email.Received}]");

email.MarkAsRead();

}

// Or take the lot and finish with it in one connection

mail.Receive(out received)

.SaveTo((GPALFile)"C:\Inbox\attachments")

.MarkAllAsRead();