مدیریت، جابه‌جایی و سازماندهی پوشه‌های IMAP

عملیات پوشه

دریافت اطلاعات پوشه

دریافت اطلاعات دربارهٔ پوشه‌ها از یک سرور IMAP با Aspose.Email بسیار آسان است. فراخوانی کنید  ListFolders() متد از ImapClient کلاس. یک شیء از ImapFolderInfoCollection نوع. با تکرار این مجموعه و دریافت اطلاعات درباره هر پوشه به صورت حلقه‌ای، می‌توانید. این متد بارگذاری بیش از یک نسخه دارد. می‌توانید نام یک پوشه را به عنوان پارامتر پاس دهید تا لیستی از زیرپوشه‌ها دریافت کنید. قطعه کد زیر نشان می‌دهد چگونه اطلاعات پوشه را از سرور IMAP با استفاده از Aspose.Email و متد توضیح داده‌شده به دست آورید.

// 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);
}

حذف و تغییر نام پوشه‌ها

یک پوشه در سرور IMAP می‌تواند با یک خط و با Aspose.Email حذف یا تغییر نام داده شود:

  • این DeleteFolder() متد نام پوشه را به‌عنوان پارامتر می‌پذیرد.
  • برای RenameFolder() متد، باید نام پوشهٔ فعلی و نام پوشهٔ جدید را پاس کنید. کد زیر نشان می‌دهد چگونه یک پوشه را از سرور IMAP حذف کنید و چگونه یک پوشه را تغییر نام دهید. هر عملیات با یک خط کد انجام می‌شود.
// Delete a folder and Rename a folder
client.DeleteFolder("foldername");
client.RenameFolder("foldername", "newfoldername");

کار با پوشه‌های صندوق‌پست استفاده ویژه

برخی از ذخیره‌سازی‌های پیام IMAP شامل صندوق‌پست‌های استفاده ویژه هستند، مانند صندوق‌های ذخیره پیش‌نویس یا پیام‌های ارسال‌شده. بسیاری از کلاینت‌های ایمیل به کاربران اجازه می‌دهند مکان پیش‌نویس یا پیام‌های ارسال‌شده را تعیین کنند، اما پیکربندی آن‌ها نیاز دارد که کاربر بداند کدام صندوق‌پست‌ها توسط سرور برای این موارد اختصاص یافته‌اند. Aspose.Email می‌تواند این صندوق‌پست‌های استفاده ویژه را با استفاده از ImapMailboxInfo کلاس برای آسان‌تر کار کردن با آن‌ها. نمونه کد زیر نشان می‌دهد چگونه با استفاده از ImapMailboxInfo کلاس.

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);

**عملیات پیام‌ها در

پوشه‌ها**

اضافه کردن پیام جدید به یک پوشه

می‌توانید یک پیام جدید به پوشه اضافه کنید با استفاده از MailMessage و ImapClient کلاس‌ها. ابتدا یک MailMessage شیء با ارائه مقادیر موضوع، گیرنده و فرستنده. سپس به یک پوشه اشتراک‌گذاری کنید و پیام را به آن اضافه کنید. قطعه کد زیر نشان می‌دهد چگونه یک پیام جدید را در یک پوشه اضافه کنید.

// Create a message
MailMessage msg = new MailMessage("user@domain1.com", "user@domain2.com", "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);

اضافه کردن چندین پیام با MultiConnection

می‌توانید چندین پیام را با استفاده از  AppendMessages متد ارائه‌شده توسط  ImapClient کلاس‌ها.  AppendMessages متد لیستی از MailMessage و اگر پوشه به‌عنوان پارامتر ارائه نشود، به پوشهٔ جاری اضافه می‌کند. ImapClient همچنین حالت MultiConnection را برای عملیات سنگین پشتیبانی می‌کند. کد زیر نشان می‌دهد چگونه با استفاده از حالت 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);

انتقال پیام‌ها بین پوشه‌ها

Aspose.Email برای .NET امکان انتقال پیام از یک پوشه صندوق‌پست به پوشه دیگر را با استفاده از ImapClient API. این MoveMessage متد از شناسهٔ یکتا پیام و نام پوشهٔ مقصد برای جابجایی پیام به پوشه هدف استفاده می‌کند. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را به پوشهٔ دیگری از صندوق‌پست منتقل کنید.

///<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(
            "from@domain.com",
            "to@domain.com",
            "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 { }
    }
}

**کپی پیام‌ها بین

پوشه‌ها**

API Aspose.Email قابلیت کپی کردن پیام از یک پوشه صندوق‌پست به پوشه دیگر را فراهم می‌کند. این امکان را می‌دهد که یک پیام یا چندین پیام را با استفاده از CopyMessage و CopyMessages متدها. CopyMessages متد قابلیت کپی کردن چندین پیام از پوشه منبع یک صندوق‌پست به پوشه مقصد را فراهم می‌کند. کد زیر نشان می‌دهد چگونه پیام‌ها را به یک پوشهٔ دیگر کپی کنید.

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(
            "asposeemail.test3@aspose.com",
            "asposeemail.test3@aspose.com",
            "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(
            "asposeemail.test3@aspose.com",
            "asposeemail.test3@aspose.com",
            "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 { }
    }
}
مدیریت پرچم‌های پیام در سرور IMAP عملیات‌های غیرهمزمان IMAP: بازیابی، مدیریت و ارسال ایمیل‌ها