BUY Free Trial
      ComponentPro UltimateMail

      Cancelling an operation

      Language Filter: AllSend comments on this topic to ComponentPro
      Managing Messages and Mailboxes with Imap > Cancelling an operation

      To abort any transfer (downloading or uploading message) in progress you can either call the Cancel method or simply close the connection by calling the Disconnect or DisconnectAsync method.

      The following steps show how to use it.

      Cancelling an operation

      1. Add using directives to your code to create aliases for existing namespaces and avoid having to type the fully qualified type names. The code looks similar to the following: 
        using System;
using ComponentPro.Net.Mail;
      2. Create a new instance of the Imap class.
      3. Now you can connect to the IMAP server with Connect methods. The code looks similar to the following: 
        // Create a new Imap instance.
Imap client = new Imap();

// Connect to the IMAP server.
client.Connect("myserver");
      4. Use your user name and password to login with Authenticate methods. The code looks similar to the following: 
        // Authenticate.
client.Authenticate("test", "test");
      5. In this example, we will demonstrate how to abort a message download when the total bytes transferred exceeds 500Kb. It can be achieved by registering an event handler to the Progress event and call the Cancel method in this method. Other scenario is creating a Cancel button on your form and call the Cancel method when user clicks on it. The event handler of the Progress event looks similar to: 
        void client_Progress(object sender, ImapProgressEventArgs e)
{
    // Abort the download operation if the bytes transferred is greater than or equal to 500Kb. 
    if (e.State == ImapTransferState.Downloading && e.BytesTransferred >= 1024 * 500)
    {
        ((Imap)sender).Cancel();
    }
}
      6. Now pass the message sequence number and destination file name to the DownloadMessage method. The code looks similar to the following: 
        try
{
    // Register an event handler. 
    client.Progress += client_Progress;

    client.Select("INBOX");

    // Download a message with sequence number #1. 
    client.DownloadMessage(1, "c:\\temp\\my message.eml");
}
catch (ImapException exc)
{
    Console.WriteLine("Exception: " + exc.Message);
}
      7. After completing your work, call the Disconnect method to close the IMAP session. 

      Final example code

      using System;
using ComponentPro.Net.Mail;

...

public void DoAbort()
{
    // Create a new Imap instance. 
    Imap client = new Imap();

    // Connect to the IMAP server. 
    client.Connect("myserver");

    // Authenticate. 
    client.Authenticate("test", "test");

    try 
    {
        // Register an event handler. 
        client.Progress += client_Progress;

        client.Select("INBOX");

        // Download a message with sequence number #1. 
        client.DownloadMessage(1, "c:\\temp\\my message.eml");
    }
    catch (ImapException exc)
    {
        Console.WriteLine("Exception: " + exc.Message);
    }

    // Disconnect. 
    client.Disconnect();
}

void client_Progress(object sender, ImapProgressEventArgs e)
{
    // Abort the download operation if the bytes transferred is greater than or equal to 500Kb. 
    if (e.State == ImapTransferState.Downloading && e.BytesTransferred >= 1024 * 500)
    {
        ((Imap)sender).Cancel();
    }
}