Use CopyMessageAsync methods to asynchronously copy a selected message to another folder. These methods asynchronously a selected message to another folder with execution occurring on a new thread, therefore they allow your next line of code to execute immediately.

In Task-based Asynchronous programs, the single asynchronous method represents the initiation and completion of an asynchronous operation. You may create the continuation code either explicitly, through methods on the Task class (for example, ContinueWith) or implicitly, by using language support built on top of continuations (for example, await in C#, Await in Visual Basic).

In Event-based Asynchronous programs, the event CopyMessageCompleted is raised when the CopyMessageAsync completes. In the event handler method of the CopyMessageCompleted, you can check if there were any errors by using the Error property of the event data object.

The following example demonstrates how to asynchronously copy a selected message:

Task-based approach

using System;
using ComponentPro.Net.Mail;

...

// Create a new instance of the Imap class.
Imap client = new Imap();

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

// Or you can specify the IMAP port with 
// client.Connect("myserver", 143); 
 
// Login to the server.
client.Authenticate("user", "password");

// ... 
 
// Select 'INBOX' mailbox.
client.Select("INBOX");

// Copy a mail message with sequence number 1 to folder 'my box'. 
await client.CopyMessageAsync(1, "my box");

// ...

Console.WriteLine("Message copied successfully.");

// Disconnect.
client.Disconnect();

Imports ComponentPro.Net.Mail

...

' Create a new instance of the Imap class. 
Dim client As New Imap()

' Connect to the server.
client.Connect("myserver")

' Or you can specify the IMAP port with 
' client.Connect("myserver", 143); 
 
' Login to the server.
client.Authenticate("user", "password")

' ... 
 
' Select 'INBOX' mailbox.
client.Select("INBOX")

' Copy a mail message with sequence number 1 to folder 'my box'. 
Await client.CopyMessageAsync(1, "my box")

' ...

Console.WriteLine("Message copied successfully.")

' Disconnect.
client.Disconnect()

Event-based approach

using System;
using System.ComponentModel;
using ComponentPro;
using ComponentPro.Net.Mail;

...

public void DoCopyMessageAsync()
{
    // Create a new instance of the Imap class. 
    Imap client = new Imap();

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

    // Or you can specify the IMAP port with 
    // client.Connect("myserver", 143); 
 
    // Login to the server. 
    client.Authenticate("user", "password");

    // ... 
 
    // Register an event handler. 
    client.CopyMessageCompleted += client_CopyMessageCompleted;

    // Select 'INBOX' mailbox. 
    client.Select("INBOX");

    // Copy a mail message with sequence number 1 to folder 'my box'. 
    client.CopyMessageAsync(1, "my box");

    // ... 
 
    // Copy a mail message with unique id "7x89Caz" to folder 'my box'. 
    client.CopyMessageAsync("7x89Caz", "my box");

    // ... 
 
    // Disconnect. 
    client.Disconnect();
}

void client_CopyMessageCompleted(object sender, ExtendedAsyncCompletedEventArgs<ImapCopyMessageReference> e)
{
    // Imap client = (Imap)sender; 
    if (e.Error != null)
        Console.WriteLine("Error: " + e.Error.ToString());
    else 
    {
        Console.WriteLine("Message copied successfully.");
    }
}

Imports System.ComponentModel
Imports ComponentPro
Imports ComponentPro.Net.Mail

...

Public Sub DoCopyMessageAsync()
    ' Create a new instance of the Imap class. 
    Dim client As New Imap()

    ' Connect to the server. 
    client.Connect("myserver")

    ' Or you can specify the IMAP port with 
    ' client.Connect("myserver", 143); 
 
    ' Login to the server. 
    client.Authenticate("user", "password")

    ' ... 
 
    ' Register an event handler. 
    AddHandler client.CopyMessageCompleted, AddressOf client_CopyMessageCompleted

    ' Select 'INBOX' mailbox. 
    client.Select("INBOX")

    ' Copy a mail message with sequence number 1 to folder 'my box'. 
    client.CopyMessageAsync(1, "my box")

    ' ... 
 
    ' Copy a mail message with unique id "7x89Caz" to folder 'my box'. 
    client.CopyMessageAsync("7x89Caz", "my box")

    ' ... 
 
    ' Disconnect. 
    client.Disconnect()
End Sub 
 
Private Sub client_CopyMessageCompleted(ByVal sender As Object, ByVal e As ExtendedAsyncCompletedEventArgs(Of ImapCopyMessageReference))
    ' Imap client = (Imap)sender; 
    If e.Error IsNot Nothing Then 
        Console.WriteLine("Error: " & e.Error.ToString())
    Else 
        Console.WriteLine("Message copied successfully.")
    End If 
End Sub