(C#) Read IMAP Email Headers

Call FetchHeaders to download only the email headers.

Chilkat .NET Downloads Chilkat .NET Framework Chilkat for .NET Core

// This example requires the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.

Chilkat.Imap imap = new Chilkat.Imap();

// Connect to an IMAP server.
// Use TLS
imap.Ssl = true;
imap.Port = 993;
bool success = imap.Connect("imap.someMailServer.com");
if (success != true) {
    Debug.WriteLine(imap.LastErrorText);
    return;
}

// Login
success = imap.Login("****","****");
if (success != true) {
    Debug.WriteLine(imap.LastErrorText);
    return;
}

// Select an IMAP mailbox
success = imap.SelectMailbox("Inbox");
if (success != true) {
    Debug.WriteLine(imap.LastErrorText);
    return;
}

Chilkat.MessageSet messageSet = null;
// We can choose to fetch UIDs or sequence numbers.
bool fetchUids = true;
// Get the message IDs of all the emails in the mailbox
messageSet = imap.Search("ALL",fetchUids);
if (imap.LastMethodSuccess != true) {
    Debug.WriteLine(imap.LastErrorText);
    return;
}

// When downloading headers, each email object contains
// (obviously) the headers, but the body will be missing.
// Also, attachments will not be included.  However, it is
// possible to get information about the attachments
// as well as the complete size of the email.
Chilkat.EmailBundle bundle = null;
bundle = imap.FetchHeaders(messageSet);
if (imap.LastMethodSuccess != true) {

    Debug.WriteLine(imap.LastErrorText);
    return;
}

// Loop over the email objects and display information
// about each:
int i;
for (i = 0; i <= bundle.MessageCount - 1; i++) {
    Chilkat.Email email = null;
    email = bundle.GetEmail(i);

    // Display the From and Subject
    Debug.WriteLine(email.From);
    Debug.WriteLine(email.Subject);

    // Display the recipients:
    int j;
    string name;
    string addr;
    for (j = 0; j <= email.NumTo - 1; j++) {
        name = email.GetToName(j);
        addr = email.GetToAddr(j);
        Debug.WriteLine(name + ", " + addr);
    }

    for (j = 0; j <= email.NumCC - 1; j++) {
        name = email.GetCcName(j);
        addr = email.GetCcAddr(j);
        Debug.WriteLine(name + ", " + addr);
    }

    // Show the total size of the email, including body and attachments:
    Debug.WriteLine(Convert.ToString(email.Size));

    // When a full email is downloaded, we would use the
    // email.NumAttachments property in conjunction with the
    // email.GetMailAttach* methods.
    // However, when an email object contains only the header,
    // we need to access the attachment info differently:
    int numAttach = imap.GetMailNumAttach(email);
    for (j = 0; j <= numAttach - 1; j++) {
        Debug.WriteLine(imap.GetMailAttachFilename(email,j));
        int attachSize = imap.GetMailAttachSize(email,j);
        Debug.WriteLine("    size = " + Convert.ToString(attachSize) + " bytes");
    }

    Debug.WriteLine("--");

}

// Disconnect from the IMAP server.
success = imap.Disconnect();