Working With MailFolders

Getting a MailFolder

Here are a few different ways:

1. (any release or pre-release after version 2.10.0)

var mailFolder = await _imapReceiver.MailFolderClient.GetFolderAsync([mailFolderName], cancellationToken);

2. (any release or pre-release after version 2.10.0)

var mailFolder = await _imapReceiver.MailFolderClient.GetOrCreateFolderAsync(mailFolderName, cancellationToken);

3. (any release or pre-release after version 2.10.0)

var mailFolder = await _imapReceiver.ImapClient.Inbox.GetOrCreateSubfolderAsync(mailFolderName, cancellationToken);

4. (version 2.10.0)

var mailFolder = await messageSummary.Folder.GetOrCreateSubfolderAsync(mailFolderName, cancellationToken);

5. (version 2.10.0 or below)

public static async Task<IMailFolder> GetOrCreateSubfolderAsync(this IMailFolder baseFolder, string mailFolderName, CancellationToken cancellationToken = default)
{
    IMailFolder mailFolder;
    try
    {
        mailFolder = await baseFolder.GetSubfolderAsync(mailFolderName, cancellationToken);
    }
    catch (FolderNotFoundException)
    {
        mailFolder = await baseFolder.CreateAsync(mailFolderName, isMessageFolder: true, cancellationToken);
    }
    return mailFolder;
}

Adding Mail To A Folder

await _imapReceiver.MailFolderClient.DraftsFolder.AppendAsync(mimeMessage);

Moving Mail Between Folders

private async Task MoveToDestinationAsync(IMessageSummary messageSummary, string destinationFolderName, CancellationToken cancellationToken = default)
{
    var destinationFolder = await _imapReceiver.MailFolderClient.GetFolderAsync([destinationFolderName], cancellationToken);
    await messageSummary.MoveToAsync(destinationFolder, cancellationToken);
}