InternetAddressListMailboxes Property

Recursively get all the mailboxes contained within the InternetAddressList.

Definition

Namespace: MimeKit
Assembly: MimeKit.Core (in MimeKit.Core.dll) Version: 5.0.0
C#
public IEnumerable<MailboxAddress> Mailboxes { get; }

Property Value

IEnumerableMailboxAddress
The mailboxes.

Remarks

This API is useful for collecting a flattened list of MailboxAddress recipients for use with sending via SMTP or for encrypting via S/MIME or PGP/MIME.

Example

C#
                    public static IList<string> GetRecipientAddresses (MimeMessage message)
{
    var addresses = new List<string> ();

    // An address list may contain both mailboxes and groups (GroupAddress). The Mailboxes
    // property flattens the list, recursively including the members of each group, which
    // makes it convenient for collecting every recipient address.
    foreach (var mailbox in message.To.Mailboxes.Concat (message.Cc.Mailboxes).Concat (message.Bcc.Mailboxes))
        addresses.Add (mailbox.Address);

    // Alternatively, the list can be enumerated directly in order to handle each type
    // of address differently.
    foreach (var address in message.To) {
        if (address is GroupAddress group)
            Console.WriteLine ("Group: {0} ({1} members)", group.Name, group.Members.Count);
        else if (address is MailboxAddress mailbox)
            Console.WriteLine ("Mailbox: {0}", mailbox.Address);
    }

    return addresses;
}
                  

See Also