Zarządzaj, przenoś i organizuj foldery IMAP

Operacje na folderach

Pobierz informacje o folderze

Uzyskanie informacji o folderach z serwera IMAP jest bardzo proste z Aspose.Email. Wywołaj ListFolders() metoda ImapClient klasa. Zwraca obiekt ImapFolderInfoCollection typ. Iteruj po tej kolekcji i uzyskaj informacje o poszczególnych folderach w pętli. Metoda jest przeciążona. Możesz przekazać nazwę folderu jako parametr, aby uzyskać listę podfolderów. Poniższy fragment kodu pokazuje, jak uzyskać informacje o folderze z serwera IMAP przy użyciu Aspose.Email i opisanej metody.

// Get all folders in the currently subscribed folder
ImapFolderInfoCollection folderInfoColl = client.ListFolders();

// Iterate through the collection to get folder info one by one
foreach (ImapFolderInfo folderInfo in folderInfoColl)
{
    // Folder name and get New messages in the folder
    Console.WriteLine("Folder name is " + folderInfo.Name);
    ImapFolderInfo folderExtInfo = client.GetFolderInfo(folderInfo.Name);
    Console.WriteLine("New message count: " + folderExtInfo.NewMessageCount);
    Console.WriteLine("Is it readonly? " + folderExtInfo.ReadOnly);
    Console.WriteLine("Total number of messages " + folderExtInfo.TotalMessageCount);
}

Usuwanie i zmiana nazw folderów

Folder na serwerze IMAP może być usunięty lub przemianowany w jednej linii przy użyciu Aspose.Email:

• Ten DeleteFolder() metoda przyjmuje nazwę folderu jako parametr.
• Dla RenameFolder() metoda, musisz podać nazwę bieżącego folderu oraz nową nazwę folderu. Poniższy fragment kodu pokazuje, jak usunąć folder z serwera IMAP oraz jak zmienić nazwę folderu. Każda operacja jest wykonywana jedną linią kodu.

// Delete a folder and Rename a folder
client.DeleteFolder("foldername");
client.RenameFolder("foldername", "newfoldername");

Praca ze specjalnymi folderami skrzynek pocztowych

Niektóre magazyny wiadomości IMAP zawierają specjalne skrzynki pocztowe, takie jak te przechowujące szkice lub wysłane wiadomości. Wiele klientów poczty pozwala użytkownikom określić, gdzie powinny być umieszczane szkice lub wysłane wiadomości, ale ich konfiguracja wymaga, aby użytkownik znał, które skrzynki serwer przeznaczył do tych celów. Aspose.Email może identyfikować te specjalne skrzynki, używając ImapMailboxInfo klasa ułatwiająca pracę z nimi. Poniższy przykład kodu demonstruje, jak uzyskać dostęp do tych specjalnych skrzynek pocztowych przy użyciu ImapMailboxInfo klasa.

ImapClient imapClient = new ImapClient();
imapClient.Host = "<HOST>";
imapClient.Port = 993;
imapClient.Username = "<USERNAME>";
imapClient.Password = "<PASSWORD>";
imapClient.SupportedEncryption = EncryptionProtocols.Tls;
imapClient.SecurityOptions = SecurityOptions.SSLImplicit;
            
ImapMailboxInfo mailboxInfo = imapClient.MailboxInfo;
Console.WriteLine(mailboxInfo.Inbox);
Console.WriteLine(mailboxInfo.DraftMessages);
Console.WriteLine(mailboxInfo.JunkMessages);
Console.WriteLine(mailboxInfo.SentMessages);
Console.WriteLine(mailboxInfo.Trash);

Operacje na wiadomościach w folderach

Dodaj nową wiadomość do folderu

Możesz dodać nową wiadomość do folderu używając MailMessage i ImapClient klasy. Najpierw utwórz MailMessage obiekt, podając wartości tematu, odbiorcy i nadawcy. Następnie subskrybuj folder i dodaj do niego wiadomość. Poniższy fragment kodu pokazuje, jak dodać nową wiadomość do folderu.

// Create a message
MailMessage msg = new MailMessage("[e-mail]", "[e-mail]", "subject", "message");

// Subscribe to the Inbox folder and Append the newly created message
client.SelectFolder(ImapFolderInfo.InBox);
client.SubscribeFolder(client.CurrentFolder.Name);
client.AppendMessage(client.CurrentFolder.Name, msg);

Dodaj wiele wiadomości przy użyciu MultiConnection

Możesz dodać wiele wiadomości używając AppendMessages metoda dostarczana przez ImapClient klasy.  AppendMessages metoda przyjmuje listę MailMessage i dodaje go do bieżącego folderu, jeśli folder nie został podany jako parametr. ImapClient obsługuje także tryb MultiConnection dla operacji o dużym obciążeniu. Poniższy fragment kodu pokazuje, jak dodać wiele wiadomości przy użyciu trybu MultiConnection.

ImapClient imapClient = new ImapClient();
imapClient.Host = "<HOST>";
imapClient.Port = 993;
imapClient.Username = "<USERNAME>";
imapClient.Password = "<PASSWORD>";
imapClient.SupportedEncryption = EncryptionProtocols.Tls;
imapClient.SecurityOptions = SecurityOptions.SSLImplicit;

List<MailMessage> messages = new List<MailMessage>();
for (int i = 0; i < 20; i++)
{
    MailMessage message = new MailMessage(
        "<EMAIL ADDRESS>",
        "<EMAIL ADDRESS>",
        "Test Message - " + Guid.NewGuid().ToString(),
        "IMAP Group Append with MultiConnection");
    messages.Add(message);
}

imapClient.ConnectionsQuantity = 5;
imapClient.UseMultiConnection = MultiConnectionMode.Enable;
imapClient.AppendMessages(messages);

Należy zauważyć, że użycie trybu wielokonekowego nie gwarantuje zwiększenia wydajności.

Przenoszenie wiadomości między folderami

Aspose.Email dla .NET umożliwia przenoszenie wiadomości z jednego folderu skrzynki pocztowej do drugiego przy użyciu ImapClient API. The MoveMessage metoda używa unikalnego identyfikatora wiadomości oraz nazwy folderu docelowego do przenoszenia wiadomości do folderu docelowego. Poniższy fragment kodu pokazuje, jak przenieść wiadomości do innego folderu skrzynki pocztowej.

///<summary>
/// This example shows how to move a message from one folder of a mailbox to another one using the ImapClient API of Aspose.Email for .NET
/// Available from Aspose.Email for .NET 6.4.0 onwards
/// -------------- Available API Overload Members --------------
/// Void ImapClient.MoveMessage(IConnection iConnection, int sequenceNumber, string folderName, bool commitDeletions)
/// Void ImapClient.MoveMessage(IConnection iConnection, string uniqueId, string folderName, bool commitDeletions)
/// Void ImapClient.MoveMessage(int sequenceNumber, string folderName, bool commitDeletions)
/// Void ImapClient.MoveMessage(string uniqueId, string folderName, bool commitDeletions)
/// Void ImapClient.MoveMessage(IConnection iConnection, int sequenceNumber, string folderName)
/// Void ImapClient.MoveMessage(IConnection iConnection, string uniqueId, string folderName)
/// Void ImapClient.MoveMessage(int sequenceNumber, string folderName)
/// Void ImapClient.MoveMessage(string uniqueId, string folderName)
///</summary>

using (ImapClient client = new ImapClient("host.domain.com", 993, "username", "password"))
{
    string folderName = "EMAILNET-35151";
    if (!client.ExistFolder(folderName))
        client.CreateFolder(folderName);
    try
    {
        MailMessage message = new MailMessage(
            "[e-mail]",
            "[e-mail]",
            "EMAILNET-35151 - " + Guid.NewGuid(),
            "EMAILNET-35151 ImapClient: Provide option to Move Message");
        client.SelectFolder(ImapFolderInfo.InBox);
        // Append the new message to Inbox folder
        string uniqueId = client.AppendMessage(ImapFolderInfo.InBox, message);
        ImapMessageInfoCollection messageInfoCol1 = client.ListMessages();
        Console.WriteLine(messageInfoCol1.Count);
        // Now move the message to the folder EMAILNET-35151
        client.MoveMessage(uniqueId, folderName);
        client.CommitDeletes();
        // Verify that the message was moved to the new folder
        client.SelectFolder(folderName);
        messageInfoCol1 = client.ListMessages();
        Console.WriteLine(messageInfoCol1.Count);
        // Verify that the message was moved from the Inbox
        client.SelectFolder(ImapFolderInfo.InBox);
        messageInfoCol1 = client.ListMessages();
        Console.WriteLine(messageInfoCol1.Count);
    }
    finally
    {
        try { client.DeleteFolder(folderName); }
        catch { }
    }
}

Kopiuj wiadomości między folderami

API Aspose.Email umożliwia kopiowanie wiadomości z jednego folderu skrzynki pocztowej do drugiego. Pozwala kopiować pojedyncze oraz wiele wiadomości używając CopyMessage i CopyMessages metody. CopyMessages metoda zapewnia możliwość kopiowania wielu wiadomości ze źródłowego folderu skrzynki do folderu docelowego. Poniższy fragment kodu pokazuje, jak skopiować wiadomości do innego folderu skrzynki.

using (ImapClient client = new ImapClient("exchange.aspose.com", "username", "password"))
{
    // Create the destination folder
    string folderName = "EMAILNET-35242";
    if (!client.ExistFolder(folderName))
        client.CreateFolder(folderName);
    try
    {
        // Append a couple of messages to the server
        MailMessage message1 = new MailMessage(
            "[e-mail]",
            "[e-mail]",
            "EMAILNET-35242 - " + Guid.NewGuid(),
            "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        string uniqueId1 = client.AppendMessage(message1);

        MailMessage message2 = new MailMessage(
            "[e-mail]",
            "[e-mail]",
            "EMAILNET-35242 - " + Guid.NewGuid(),
            "EMAILNET-35242 Improvement of copy method.Add ability to 'copy' multiple messages per invocation.");
        string uniqueId2 = client.AppendMessage(message2);

        // Verify that the messages have been added to the mailbox
        client.SelectFolder(ImapFolderInfo.InBox);
        ImapMessageInfoCollection msgsColl = client.ListMessages();
        foreach (ImapMessageInfo msgInfo in msgsColl)
            Console.WriteLine(msgInfo.Subject);

        // Copy multiple messages using the CopyMessages command and Verify that messages are copied to the destination folder
        client.CopyMessages(new[] { uniqueId1, uniqueId2 }, folderName);

        client.SelectFolder(folderName);
        msgsColl = client.ListMessages();
        foreach (ImapMessageInfo msgInfo in msgsColl)
            Console.WriteLine(msgInfo.Subject);
    }
    finally
    {
        try
        {
            client.DeleteFolder(folderName);
        }
        catch { }
    }
}