(C# UWP/WinRT) Fetch 1st N Headers of Search Results

Calls Search to get a message set, then downloads the 1st N messages in the message set. There are two equivalent ways of doing it: (1) iterate from 0 to N-1 and download each message individually, or (2) create a new message set that contains the 1st N messages and pass it to FetchHeaders. Both are demonstrated here.

Chilkat Universal Windows Platform (UWP) / WinRT Downloads Chilkat for the Universal Windows Platform (UWP)

// This example assumes 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 = await imap.ConnectAsync("imap.someMailServer.com");
if (success != true) {
    Debug.WriteLine(imap.LastErrorText);
    return;
}

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

// Select an IMAP mailbox
success = await imap.SelectMailboxAsync("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 = await imap.SearchAsync("ALL",fetchUids);
if (imap.LastMethodSuccess == false) {
    Debug.WriteLine(imap.LastErrorText);
    return;
}

int numFound = messageSet.Count;
if (numFound == 0) {
    Debug.WriteLine("No messages found.");

    return;
}

// Get the 1st 10 messages in messageSet.
int upperBound = 10;
if (numFound < upperBound) {
    upperBound = numFound;
}

int i = 0;
bool bUid = messageSet.HasUids;
while (i < upperBound) {

    Chilkat.Email email = await imap.FetchSingleHeaderAsync(messageSet.GetId(i),bUid);
    if (imap.LastMethodSuccess == false) {
        Debug.WriteLine(imap.LastErrorText);

        return;

    }
    else {
        // Do whatever is needed with the email.. 
        // ....

    }

    i = i + 1;
}

// Alternatively, create a new message set containing the 1st 10 message id's (UID's) 
// from the search results message set:
Chilkat.MessageSet firstTen = new Chilkat.MessageSet();

for (i = 0; i <= upperBound - 1; i++) {
    firstTen.InsertId(messageSet.GetId(i));
}

// Download the 1st ten headers:
Chilkat.EmailBundle bundle = null;
bundle = await imap.FetchHeadersAsync(firstTen);
if (imap.LastMethodSuccess == false) {

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

// Other examples show how to iterate over the emails contained within the bundle...

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