Documentation – کار با مشتری IMAP

Net: اتصال به سرور IMAP

Mon, 01 Jan 0001 00:00:00 +0000

فهرست‌کردن افزونه‌های سرور IMAP

Aspose.Email ImapClient به شما امکان می‌دهد افزونه‌های سرور که سرور آنها را پشتیبانی می‌کند مثل IDLE، UNSELECT، QUOTA و غیره را بازیابی کنید. این به شناسایی در دسترس بودن یک افزونه قبل از استفاده از کلاینت برای آن عملکرد خاص کمک می‌کند. GetCapabilities() متد انواع افزونه‌های پشتیبانی‌شده را به‌صورت یک آرایهٔ رشته‌ای برمی‌گرداند. کد زیر نشان می‌دهد چگونه افزونه‌ها را بازیابی کنید.

اتصال استاندارد IMAP

این ImapClient کلاس به برنامه‌ها اجازه می‌دهد صندوق‌های ایمیل IMAP را با استفاده از پروتکل IMAP مدیریت کنند. ImapClient کلاس برای اتصال به سرورهای ایمیل IMAP و مدیریت ایمیل‌ها در پوشه‌های ایمیل IMAP استفاده می‌شود. برای اتصال به سرور IMAP

یک نمونه از ImapClient کلاس.
نام میزبان، نام کاربری و گذرواژه را در سازنده ImapClient.

توجه: محدودیت‌های رمز عبور باید با الزامات سرور همخوانی داشته باشند. کلاینت ایمیل محدودیت‌های رمز عبور را اضافه نمی‌کند.

زمانی که ImapClient نمونه ایجاد می‌شود، فراخوانی بعدی هر عمل با این نمونه به سرور متصل می‌شود. کد زیر نشان می‌دهد چگونه با استفاده از مراحل فوق به سرور IMAP متصل شویم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create an imapclient with host, user and password
ImapClient client = new ImapClient("localhost", "user", "password");

اتصال IMAP با SSL فعال

اتصال به سرور IMAP نحوهٔ اتصال به سرور IMAP را در چهار گام ساده توضیح دادیم:

یک نمونه از ImapClient کلاس.
نام میزبان، نام کاربری و گذرواژه را مشخص کنید.
پورت را مشخص کنید.
گزینه‌های امنیتی را مشخص کنید.

فرآیند اتصال به سرور IMAP با SSL فعال مشابه است اما نیاز دارد چند ویژگی دیگر تنظیم شود:

تنظیم SecurityOptions به SSLImplicit.

کد زیر نشان می‌دهد چگونه

نام کاربری، گذرواژه و پورت را تنظیم کنید.
تنظیم گزینه امنیتی.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Create an instance of the ImapClient class
ImapClient client = new ImapClient("imap.domain.com", 993, "user@domain.com", "pwd");
            
// Set the security mode to implicit
client.SecurityOptions = SecurityOptions.SSLImplicit;

راه‌اندازی اتصال پروکسی

اتصال به سرور از طریق پروکسی

سرورهای پروکسی معمولاً برای ارتباط با دنیای بیرون استفاده می‌شوند. در این شرایط، کلاینت‌های ایمیل بدون تعیین آدرس پروکسی نمی‌توانند از اینترنت ارتباط برقرار کنند. Aspose.Email پشتیبانی از نسخه‌های 4، 4a و 5 پروتکل پروکسی SOCKS را فراهم می‌کند. این مقاله نمونهٔ عملی دسترسی به صندوق پست با استفاده از سرور پروکسی ایمیل را ارائه می‌دهد. برای دسترسی به صندوق پست از طریق سرور پروکسی:

راه‌اندازی SocksProxy با اطلاعات مورد نیاز: آدرس پروکسی، پورت و نسخه SOCKS.
راه‌اندازی ImapClient با آدرس میزبان، نام کاربری، گذرواژه و هر تنظیمات دیگر.
تنظیم … کلاینت SocksProxy خاصیت (property) کلاینت به SocksProxy شیء‌ای که در بالا ایجاد شده است.

کد زیر نشان می‌دهد چگونه صندوق پست را از طریق سرور پروکسی بازیابی کنیم.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Connect and log in to IMAP and set SecurityOptions
ImapClient client = new ImapClient("imap.domain.com", "username", "password");
client.SecurityOptions = SecurityOptions.Auto;
            
string proxyAddress = "192.168.203.142"; // proxy address
int proxyPort = 1080; // proxy port
SocksProxy proxy = new SocksProxy(proxyAddress, proxyPort, SocksVersion.SocksV5);

// Set the proxy
client.Proxy = proxy;
           
try
{
    client.SelectFolder("Inbox");
}
catch (Exception ex)
{
    Console.WriteLine(ex.Message);
}

اتصال به سرور از طریق پروکسی HTTP

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
HttpProxy proxy = new HttpProxy("18.222.124.59", 8080);
using (ImapClient client = new ImapClient("imap.domain.com", "username", "password"))
{
    client.Proxy = proxy;
    client.SelectFolder("Inbox");
}

اتصال در حالت فقط-خواندنی

این ImapClient کلاس یک ReadOnly ویژگی که هنگامی که به true تنظیم شود، نشان می‌دهد که هیچ تغییری در وضعیت دائمی صندوق پست اعمال نشود. نمونه کد زیر استفاده از ImapClient.ReadOnly ویژگی. تعداد پیام‌های نخوانده را میگیرد، سپس یک پیام را واکشی می‌کند و دوباره تعداد پیام‌های نخوانده را در حالت فقط‑خواندنی میگیرد. تعداد پیام‌های نخوانده همان‌جا می‌ماند که نشان می‌دهد وضعیت دائمی صندوق پست تغییر نکرده است.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
ImapClient imapClient = new ImapClient();
imapClient.Host = "<HOST>";
imapClient.Port = 993;
imapClient.Username = "<USERNAME>";
imapClient.Password = "<PASSWORD>";
imapClient.SupportedEncryption = EncryptionProtocols.Tls;
imapClient.SecurityOptions = SecurityOptions.SSLImplicit;

ImapQueryBuilder imapQueryBuilder = new ImapQueryBuilder();
imapQueryBuilder.HasNoFlags(ImapMessageFlags.IsRead); /* get unread messages. */
MailQuery query = imapQueryBuilder.GetQuery();

imapClient.ReadOnly = true;
imapClient.SelectFolder("Inbox");
ImapMessageInfoCollection messageInfoCol = imapClient.ListMessages(query);
Console.WriteLine("Initial Unread Count: " + messageInfoCol.Count());
if (messageInfoCol.Count() > 0)
{
    imapClient.FetchMessage(messageInfoCol[0].SequenceNumber);

    messageInfoCol = imapClient.ListMessages(query);
    // This count will be equal to the initial count
    Console.WriteLine("Updated Unread Count: " + messageInfoCol.Count());
}
else
{
    Console.WriteLine("No unread messages found");
}

راه‌اندازی احراز هویت CRAM-MD5

برای احراز هویت امن و دسترسی به سرور ایمیل، Aspose.Email برای .NET یک روش احراز هویت CRAM-MD5 ارائه می‌دهد. قطعه کد زیر نشان می‌دهد چگونه این روش با ImapClient کار می‌کند:

imapClient.AllowedAuthentication = ImapKnownAuthenticationType.CramMD5;

تنظیم زمان‌انتظارات برای عملیات IMAP

هر عملیات ایمیل بسته به عوامل متعددی (تاخیرهای شبکه، حجم داده، عملکرد سرور و غیره) مدتی طول می‌کشد. می‌توانید زمان انتظار (Timeout) را برای تمام عملیات ایمیل تنظیم کنید. مثال کد زیر نشان می‌دهد چگونه با استفاده از زمان انتظار ویژگی. نکته: نباید مقادیر بزرگ تنظیم کنید تا از انتظار طولانی در برنامه جلوگیری کنید.

پیکربندی زمان‌انتظار عملیات

using (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.Timeout = 60000; // 60 seconds

    // some code...
}

محدود کردن زمان انتظار خوشامدگویی

کلاینت IMAP ممکن است از حالت خودکار برای برقراری اتصال استفاده کند. در این حالت، کلاینت IMAP تمام پارامترهای ممکن برای اتصال را امتحان می‌کند تا اتصال برقرار شود. سرور IMAP در صورت اتصال صحیح، یک رشته خوشامدگویی به کلاینت می‌فرستد. سرورها ممکن است اتصال SSL/TLS را به‌صورت ضمنی یا صریح (START TLS) آغاز کنند. اگر حالت اتصال ناهماهنگ باشد (مثلاً سرور انتظار اتصال SSL ضمنی دارد اما کلاینت سعی می‌کند اتصال غیرامن یا SSL صریح برقرار کند)، سرور رشته خوشامدگویی نمی‌فرستد و کاربر مدت زمان طولانی تا زمان timeout منتظر می‌ماند، سپس کلاینت به گزینه اتصال بعدی می‌رود. برای جلوگیری از این مشکل، ویژگی GreetingTimeout معرفی شده است. این ویژگی به شما اجازه می‌دهد زمان انتظار برای رشته خوشامدگویی را تنظیم کنید و زمان برقراری خودکار اتصال را کاهش دهید.

using (ImapClient client = new ImapClient("localhost", 993, "username", "password"))
{
    client.GreetingTimeout = 4000;
    client.SelectFolder(ImapFolderInfo.InBox);
}

استفاده از پروتکل‌های رمزنگاری در IMAP

Aspose.Email پروتکل‌های رمزنگاری SSL (منقضی) و TLS را برای فراهم کردن امنیت ارتباطات پشتیبانی می‌کند. می‌توانید رمزنگاری را فعال کنید تا تبادل داده‌ها بین برنامهٔ شما و سرورهای ایمیل محافظت شود.

توجه: باید فقط نسخه‌های پروتکل را تنظیم کنید که توسط .NET Framework پشتیبانی می‌شوند. اگر برخی نسخه‌های پروتکل رمزنگاری توسط نسخهٔ فعلی .NET Framework شما پشتیبانی نشود، نادیده گرفته شده و رد می‌شوند. در این صورت استثناها تولید نمی‌شوند. لطفاً از SetSupportedEncryptionUnsafe متد اگر می‌خواهید پروتکل‌ها را بدون هیچ بررسی سازگاری تنظیم کنید.

مثال کد زیر نشان می‌دهد چگونه TLS 1.3 را برای ImapClient نمونهٔ کلاس.

using (ImapClient imapClient = new ImapClient("host", 993, "username", "password", SecurityOptions.SSLImplicit))
{
    imapClient.SupportedEncryption = EncryptionProtocols.Tls13;

    // some code...
}

در صورتی که پروتکل رمزنگاری مشخص‌شده در نسخهٔ فعلی .NET Framework پشتیبانی نشود، تفاوت رفتار بین SetSupportedEncryptionUnsafe متد و SupportedEncryption ویژگی به شرح زیر است:

اگر SupportedEncryption اگر این ویژگی استفاده شود، کلاینت ایمیل پروتکل رمزنگاری را به سطحی پشتیبانی‌شده کاهش می‌دهد.
اگر SetSupportedEncryptionUnsafe اگر از این متد استفاده شود، کلاینت ایمیل استثناها را پرتاب می‌کند.

استفاده از فرمان IMAP IDLE

Aspose.Email APIها ImapClient امکان باز کردن اتصال به سرور و انتظار برای رسیدن پیام ایمیل را فراهم می‌کند. این اجازه می‌دهد از پرس‌و‌جو (polling) مکرر سرور برای هر ایمیل ورودی جلوگیری شود. قطعه کد زیر نشان می‌دهد چگونه از کتابخانه Aspose.Email برای نظارت بر صندوق‌ورودی IMAP برای پیام‌های جدید و پیام‌های حذف‌شده استفاده کنید و سپس بر اساس این رویدادها اقدام خاصی انجام دهید:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// Connect and log in to IMAP 
ImapClient client = new ImapClient("imap.domain.com", "username", "password");

ManualResetEvent manualResetEvent = new ManualResetEvent(false);
ImapMonitoringEventArgs eventArgs = null;
client.StartMonitoring(delegate(object sender, ImapMonitoringEventArgs e)
{
    eventArgs = e;
    manualResetEvent.Set();
});
Thread.Sleep(2000);
SmtpClient smtpClient = new SmtpClient("exchange.aspose.com", "username", "password");
smtpClient.Send(new MailMessage("from@aspose.com", "to@aspose.com", "EMAILNET-34875 - " + Guid.NewGuid(), "EMAILNET-34875 Support for IMAP idle command"));
manualResetEvent.WaitOne(10000);
manualResetEvent.Reset();
Console.WriteLine(eventArgs.NewMessages.Length);
Console.WriteLine(eventArgs.DeletedMessages.Length);
client.StopMonitoring("Inbox");
smtpClient.Send(new MailMessage("from@aspose.com", "to@aspose.com", "EMAILNET-34875 - " + Guid.NewGuid(), "EMAILNET-34875 Support for IMAP idle command"));
manualResetEvent.WaitOne(5000);

نمونه کد زیر نشان می‌دهد چگونه نظارت ناهمزمان برای پیام‌های ایمیل جدید تنظیم می‌شود:

var client = = new ImapClient("imap.domain.com", "username", "password");

//anySuccess is a flag to prevent infinite Client.ResumeMonitoring calls
var anySuccess = false;
await client.StartMonitoringAsync(OnNewMessagesCallback, OnErrorCallback);

void OnErrorCallback(object eventSender, ImapMonitoringErrorEventArgs errorEventArguments)
{
    //The exception can be handled here
    Logger.Debug.Write(
        $"An error occured while folder monitoring: {errorEventArguments.FolderName}",
        errorEventArguments.Error);
    //IMAP folder monitoring is stopped on any error. Here is an example
    //of resuming after that.
    if (!anySuccess) return;
    anySuccess = false;
    //Make sure you use ResumeMonitoring instead of StartMonitoring here
    //to prevent missing any emails between the error handling and resuming.
    client.ResumeMonitoring(OnNewMessagesCallback, OnErrorCallback,
        errorEventArguments.MonitoringState);
}

void OnNewMessagesCallback(object sender, ImapMonitoringEventArgs successEventArgs)
{
    anySuccess = true;
    //Use successEventArgs.NewMessages to handle new messages
    //Use successEventArgs.DeletedMessages to handle deleted messages
}

پشتیبانی از افزونه‌های IMAP

API Aspose.Email پشتیبانی از افزونه‌های IMAP را فراهم می‌کند. افزونه‌های IMAP زیر در حال حاضر توسط API پشتیبانی می‌شوند. این افزونه‌ها توسط همهٔ سرورها پشتیبانی نمی‌شوند.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password"))
{
    // Set SecurityOptions
    client.SecurityOptions = SecurityOptions.Auto;
    Console.WriteLine(client.IdSupported.ToString());

    ImapIdentificationInfo serverIdentificationInfo1 = client.IntroduceClient();
    ImapIdentificationInfo serverIdentificationInfo2 = client.IntroduceClient(ImapIdentificationInfo.DefaultValue);

    // Display ImapIdentificationInfo properties
    Console.WriteLine(serverIdentificationInfo1.ToString(), serverIdentificationInfo2);
    Console.WriteLine(serverIdentificationInfo1.Name);
    Console.WriteLine(serverIdentificationInfo1.Vendor);
    Console.WriteLine(serverIdentificationInfo1.SupportUrl);
    Console.WriteLine(serverIdentificationInfo1.Version);
}

فرمان لیست گسترش‌یافته IMAP4

قطعه کد زیر نشان می‌دهد چگونه از فرمان لیست گسترش‌یافتهٔ IMAP4 استفاده کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
using (ImapClient client = new ImapClient("imap.gmail.com", 993, "username", "password"))
{
    ImapFolderInfoCollection folderInfoCol = client.ListFolders("*");
    Console.WriteLine("Extended List Supported: " + client.ExtendedListSupported);
    foreach (ImapFolderInfo folderInfo in folderInfoCol)
    {
        switch (folderInfo.Name)
        {
            case "[Gmail]/All Mail":
                Console.WriteLine("Has Children: " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Bin":
                Console.WriteLine("Bin has children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Drafts":
                Console.WriteLine("Drafts has children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Important":
                Console.WriteLine("Important has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Sent Mail":
                Console.WriteLine("Sent Mail has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Spam":
                Console.WriteLine("Spam has Children? " + folderInfo.HasChildren);
                break;
            case "[Gmail]/Starred":
                Console.WriteLine("Starred has Children? " + folderInfo.HasChildren);
                break;
        }
    }
}

Net: مدیریت پیام‌ها در سرور IMAP

Mon, 01 Jan 0001 00:00:00 +0000

بازیابی و فهرست‌کردن پیام‌ها

چگونگی به‌دست آوردن اطلاعات شناسایی پیام‌ها در یک صندوق‌پست

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

Aspose.Email.ImapMessageInfo کلاس: اطلاعات شناسایی یک پیام در صندوق‌پست IMAP را نشان می‌دهد.

ImapMessageInfo.SequenceNumber ویژگی: شماره توالی پیام را بازیابی می‌کند.

ImapMessageInfo.UniqueId ویژگی: شناسه یکتای پیام را بازیابی می‌کند.

Aspose.Email.MailMessage.ItemId ویژگی: نمایانگر اطلاعات شناسایی اضافی درباره پیام درون صندوق‌پست است.

قطعه کد زیر نشان می‌دهد چگونه اطلاعات شناسایی پیام‌ها در یک صندوق‌پست IMAP به‌دست آید:

یک نمونه از ImapClient کلاس با ارائه پارامترهای لازم مانند میزبان سرور IMAP، پورت، آدرس ایمیل، رمز عبور و گزینه‌های امنیتی.
از ListMessages متد برای بازیابی فهرست پیام‌ها از پوشه "INBOX". فهرست را با استفاده از متد Take(5) به اولین پنج پیام محدود کنید.
با استفاده از … شماره‌های توالی پیام‌های فهرست‌شده را استخراج کنید. SequenceNumber ویژگی هر پیام.
از FetchMessages متد برای دریافت جزئیات کامل پیام‌ها از سرور، با استفاده از شماره‌های توالی به‌دست آمده در مرحله قبل.
در پیام‌های بازیابی‌شده حلقه بزنید و برای هر پیام، اطلاعات زیر را بازیابی و نمایش دهید:

شماره توالی پیام.
ویژگی ItemId.SequenceNumber.
موضوع پیام.

using (var client = new ImapClient(imapHost, port, emailAddress, password, securityOption))
{
    // List the first 5 messages from the inbox
    var msgs = client.ListMessages("INBOX").Take(5);
    
    // Get sequence numbers of the messages
    var seqIds = msgs.Select(t => t.SequenceNumber);
    
    // Fetch messages based on sequence numbers
    var msgsViaFetch = client.FetchMessages(seqIds);
    
    for (var i = 0; i < 5; i++)
    {
        var thisMsg = msgsViaFetch[i];
        Console.WriteLine($"Message ID: {seqIds.ElementAt(i)} SequenceNumber: {thisMsg.ItemId.SequenceNumber} Subject: {thisMsg.Subject}");
    }
}

فهرست شناسه‌های پیام MIME از سرور

ImapMessageInfo MIME را فراهم می‌کند MessageId برای شناسایی پیام بدون استخراج کامل پیام. کد زیر نشان می‌دهد چگونه شناسهٔ پیام MIME را لیست کنیم.

لیست پیام‌ها از سرور

Aspose.Email یک نسخهٔ overload شدهٔ ۲ عضوی از ListMessages() برای بازیابی تعداد مشخصی از پیام‌ها بر پایه یک پرس‌و‌جو. قطعه کد زیر نشان می‌دهد چگونه پیام‌ها را فهرست کنید.

فهرست پیام‌ها به‌صورت بازگشتی

پروتکل IMAP از لیست کردن پیام‌ها به صورت بازگشتی از یک پوشهٔ صندوق پست پشتیبانی می‌کند. این امکان فهرست کردن پیام‌ها از زیرپوشه‌های یک پوشه را نیز فراهم می‌سازد. کد زیر نشان می‌دهد چگونه پیام‌ها را به صورت بازگشتی لیست کنیم.

فهرست پیام‌ها با چنداتصال

ImapClient ارائه می‌دهد یک UseMultiConnection ویژگی که می‌تواند برای ایجاد چندین اتصال برای عملیات سنگین استفاده شود. همچنین می‌توانید با استفاده از ImapClient.ConnectionsQuantity. کد زیر استفاده از حالت چند‑اتصال برای لیست کردن پیام‌ها را نشان می‌دهد و عملکرد آن را با حالت اتصال تک مقایسه می‌کند.

لطفاً توجه داشته باشید که استفاده از حالت چنداتصال تضمین‌کننده‌ی افزایش عملکرد نیست.

فهرست پیام‌ها با پشتیبانی از صفحه‌بندی

در موقعیت‌هایی که سرور ایمیل حاوی تعداد زیادی پیام در صندوق‌پست است، معمولاً خواستار لیست یا بازیابی پیام‌ها با پشتیبانی از صفحه‌بندی می‌شود. API‌های Aspose.Email ImapClient به شما امکان می‌دهد پیام‌ها را از سرور با پشتیبانی از صفحه‌بندی بازیابی کنید.

لیست پیوست‌های پیام

برای دریافت اطلاعات درباره پیوست‌ها مانند نام و اندازه بدون دریافت داده‌های پیوست، API‌های زیر را امتحان کنید:

Aspose.Email.Clients.Imap.ImapAttachmentInfo - نمایانگر اطلاعات یک پیوست.
Aspose.Email.Clients.Imap.ImapAttachmentInfoCollection - نمایانگر یک مجموعه از ImapAttachmentInfo کلاس.
Aspose.Email.Clients.Imap.ListAttachments(int sequenceNumber) - اطلاعاتی برای هر پیوست در یک پیام دریافت می‌کند.

نمونه کد با مراحل زیر نشان می‌دهد چگونه از API‌ها استفاده کنید:

متد را فراخوانی کنید ListMessages() متد روی شیء imapClient. این متد یک ImapMessageInfoCollection باز می‌گرداند که شامل اطلاعات پیام‌های موجود در صندوق‌پست است.
با استفاده از حلقه foreach، بر روی هر پیام در مجموعه messageInfoCollection تکرار کنید.
متد را فراخوانی کنید ListAttachments() متد روی شیء imapClient، با ارسال ویژگی SequenceNumber از شیء پیام به عنوان پارامتر. این متد یک ImapAttachmentInfoCollection باز می‌گرداند که شامل اطلاعات پیوست‌های پیام است.
با استفاده از حلقه foreach، بر روی هر پیوست در مجموعه attachmentInfoCollection تکرار کنید.
درون حلقه داخلی، می‌توانید به اطلاعات هر پیوست با استفاده از خصوصیات شیء attachmentInfo دسترسی پیدا کنید.

var messageInfoCollection = imapClient.ListMessages();
    
foreach (var message in messageInfoCollection)
{
    var attachmentInfoCollection = imapClient.ListAttachments(message.SequenceNumber);

    foreach (var attachmentInfo in attachmentInfoCollection)
    {
        Console.WriteLine("Attachment: {0} (size: {1})", attachmentInfo.Name, attachmentInfo.Size);
    }
}

دریافت و ذخیره پیام‌ها

دریافت پیام‌ها از سرور

این ImapClient کلاس می‌تواند پیام‌ها را از یک سرور IMAP دریافت کرده و آن‌ها را در قالب EML بر روی دیسک محلی ذخیره کند. مراحل زیر برای ذخیره پیام‌ها بر روی دیسک ضروری است:

یک نمونه از ImapClient کلاس.
در ImapClient، نام میزبان، پورت، نام کاربری و گذرواژه را مشخص کنید constructor.
پوشه را با استفاده از SelectFolder() متد.
متد را فراخوانی کنید ListMessages متد برای دریافت ImapMessageInfoCollection شیء.
درون ImapMessageInfoCollection مجموعه، فراخوانی کنید SaveMessage() متد که مسیر خروجی و نام فایل را تعیین می‌کند.

کد زیر نشان می‌دهد چگونه پیام‌های ایمیل را از یک سرور دریافت و ذخیره کنید.

دریافت پیام‌ها به ترتیب نزولی

Aspose.Email ارائه می‌دهد ImapClient.ListMessagesByPage متد که پیام‌ها را با پشتیبانی از صفحه‌بندی فهرست می‌کند. برخی بارگذاری‌های ImapClient.ListMessagesByPage پذیرش PageSettings به عنوان پارامتر. PageSettings یک AscendingSorting خاصیتی که وقتی به false تنظیم شود، ایمیل‌ها را به ترتیب نزولی باز می‌گرداند.

کد مثال زیر نحوه استفاده از AscendingSorting ویژگی PageSettings کلاس برای تغییر ترتیب ایمیل‌ها.

ذخیره پیام‌ها در قالب MSG

برای ذخیره ایمیل‌ها در فرمت MSG، ImapClient.FetchMessage() متد باید فراخوانی شود. پیام را در یک نمونه از MailMessage کلاس. MailMessage.Save() متد می‌تواند سپس برای ذخیره پیام به فرمت MSG فراخوانی شود. کد زیر نشان می‌دهد چگونه پیام‌ها را در قالب MSG ذخیره کنید.

گروه‌بندی پیام‌های دریافت‌شده

ImapClient ارائه می‌دهد یک FetchMessages متدی که یک iterable از شماره‌های توالی یا شناسهٔ یکتا می‌پذیرد و فهرستی از MailMessage. قطعه کد زیر استفاده از FetchMessages متد برای بازیابی پیام‌ها بر اساس شماره توالی و شناسهٔ یکتا.

دریافت پوشه‌ها و خواندن پیام‌ها به صورت بازگشتی

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

پردازش اطلاعات خاص پیام

استخراج پارامترهای اضافی به عنوان اطلاعات خلاصه

دریافت اطلاعات سرصفحه List-Unsubscribe

هدر List-Unsubscribe شامل URL برای لغو اشتراک از لیست‌های ایمیل مانند تبلیغات، خبرنامه‌ها و غیره است. برای دریافت هدر List-Unsubscribe، از ListUnsubscribe ویژگی ImapMessageInfo کلاس. مثال زیر نحوه استفاده از آن را نشان می‌دهد ListUnsubscribe ویژگی برای دریافت هدر List-Unsubscribe.

Net: فیلتر کردن پیام‌ها از سرور IMAP در C#

Mon, 01 Jan 0001 00:00:00 +0000

فیلترکردن پایه‌ای پیام

این ImapClient کلاس فراهم می‌کند ListMessages() متد تمام پیام‌های یک صندوق‌پست را دریافت می‌کند. برای دریافت تنها پیام‌هایی که با شرطی مطابقت دارند، از نسخهٔ بارگذاری‌شدهٔ ListMessages() متدی که می‌گیرد MailQuery به‌عنوان آرگومان. این MailQuery کلاس ویژگی‌های متنوعی برای تعیین شرایط فراهم می‌کند، برای مثال، تاریخ، موضوع، فرستنده، گیرنده و غیره. مثال اول نشان می‌دهد چگونه پیام‌ها را بر پایهٔ تاریخ و موضوع فیلتر کنیم. همچنین نشان می‌دهیم چطور بر اساس معیارهای دیگر فیلتر کنیم و پرس‌وجوهای پیچیده‌تری بسازیم. API همچنین امکان اعمال معیارهای جستجوی حساس به حروف بزرگ/کوچک برای تطبیق دقیق فیلترها را فراهم می‌کند. API همچنین اجازه مشخص کردن رمزگذاری رشتهٔ جستجو برای فیلتر کردن پیام‌ها از صندوق پست را می‌دهد.

فیلتر پیام‌ها از صندوق پست

اتصال و ورود به سرور IMAP
یک نمونه از MailQuery و ویژگی‌ها را تنظیم کنید
متد را فراخوانی کنید ImapClient.ListMessages(MailQuery query) متد و پاس دهید MailQuery با پارامترها فقط پیام‌های فیلترشده را دریافت کنید.

کد زیر نشان می‌دهد چگونه به صندوق پست IMAP وصل شویم و پیام‌هایی که امروز رسیده‌اند و کلمه «newsletter» در موضوع دارند، دریافت کنیم.

فیلتر پیام‌ها بر اساس معیار خاص

نمونه‌های کد فوق پیام‌ها را بر اساس موضوع ایمیل و تاریخ فیلتر می‌کند. می‌توانیم از ویژگی‌های دیگر برای تنظیم شرایط پشتیبانی‌شده دیگر نیز استفاده کنیم. در زیر برخی مثال‌ها برای تنظیم شرایط با استفاده از MailQuery. کدهای زیر نشان می‌دهند چگونه ایمیل‌ها را فیلتر کنیم بر اساس:

تاریخ امروز.
دامنهٔ تاریخ.
از فرستندهٔ خاص.
از دامنهٔ خاص.
از گیرندهٔ خاص.

تاریخ امروز

کد زیر نشان می‌دهد چگونه ایمیل‌ها را بر پایه تاریخ امروز فیلتر کنیم.

بازه تاریخ

قطعه کد زیر نشان می‌دهد چگونه ایمیل‌ها را بر اساس بازه تاریخ فیلتر کنید.

فرستنده خاص

کد زیر نشان می‌دهد چگونه ایمیل‌ها را بر پایه فرستندهٔ خاصی فیلتر کنیم.

دامنه خاص

کد زیر نشان می‌دهد چگونه ایمیل‌ها را بر پایه دامنهٔ خاصی فیلتر کنیم.

گیرنده خاص

کد زیر نشان می‌دهد چگونه ایمیل‌ها را بر پایه گیرندهٔ خاصی فیلتر کنیم.

ساخت پرس‌و‌جوی پیشرفته

اگر متفاوت MailQueryBuilder ویژگی‌ها در عبارت‌های جداگانه تنظیم می‌شوند، سپس تمام شرایط مطابقت می‌یابند. برای مثال، اگر بخواهیم پیام‌ها را بین یک بازه زمانی و از یک میزبان خاص دریافت کنیم، باید سه عبارت بنویسیم.

ترکیب پرس‌وجوها با AND

قطعه کد زیر نشان می‌دهد چگونه پرس‌وجوها را با AND ترکیب کنید.

ترکیب پرس‌وجوها با OR

MailQueryBuilder ارائه می‌دهد Or() متد که دو MailQuery نمونه‌ها به عنوان پارامترها. پیام‌هایی را که هر یک از دو شرط مشخص‌شده را برآورده می‌کنند، دریافت می‌کند. کد زیر نشان می‌دهد چگونه پیام‌هایی که یا «test» در موضوع دارند یا «noreply@host.com» به عنوان فرستنده، فیلتر شوند. کد زیر نشان می‌دهد چگونه پرس‌وجوها را با OR ترکیب کنیم.

فیلتر بر مبنای InternalDate

پیام‌ها می‌توانند بر پایه InternalDate از سرور استخراج شوند، اما گاهی سرور تمام پیام‌ها را همان‌طور که در صندوق ورودی دیده می‌شوند بر نمی‌گرداند. دلیل آن می‌تواند منطقه زمانی سرور باشد چون ممکن است برای همه سرورها مثل جیمیل. Aspose دستورات مانند 008 SEARCH ON 4-May-2014 را بر اساس پروتکل IMAP اما نتیجه ممکن است به دلیل تنظیمات منطقه زمانی سرور متفاوت باشد. یک عضو جدید در ImapMessageInfo به عنوان InternalDate که به فیلتر کردن پیام‌ها کمک بیشتری می‌کند. کد زیر استفاده از InternalDate برای فیلتر کردن پیام‌ها.

فیلتر حساس به حروف

کد زیر نشان می‌دهد چگونه از فیلتر ایمیل‌های حساس به حروف بزرگ و کوچک استفاده کنیم.

مشخص کردن رمزگذاری برای سازندهٔ پرس‌وجو

API‌های ImapQueryBuilder سازنده می‌تواند برای تعیین رمزگذاری رشتهٔ جستجو استفاده شود. این کار همچنین می‌تواند با استفاده از DefaultEncoding ویژگی MailQueryBuilder. کد زیر نشان می‌دهد چگونه رمزگذاری را برای سازندهٔ پرس‌وجو مشخص کنیم.

گزینه‌های فیلتر سفارشی

فیلتر کردن پیام‌ها با پرچم سفارشی

جستجوی سفارشی برای فیلتر کردن

به عنوان مثال، استاندارد RFC 3501 اجازه جستجوی پیام بر پایه وجود پیوست‌ها را نمی‌دهد. ولی Gmail ارائه می‌دهد افزونه‌های IMAP که امکان انجام چنین جستجویی را می‌دهد. قطعه کد بعدی نشان می‌دهد چگونه یک پرس‌و‌جوی مربوطه ایجاد شود.

ImapQueryBuilder queryBuilder = new ImapQueryBuilder();
queryBuilder.CustomSearch("X-GM-RAW \"has:attachment\"");

MailQuery mailQuery = queryBuilder.GetQuery();
ImapMessageInfoCollection messageInfoCollection = imapClient.ListMessages(mailQuery);

فیلتر کردن پیام‌ها با پشتیبانی از صفحه‌بندی

این ImapClient قابلیت جستجوی پیام‌ها از صندوق پست و فهرست‌کردن آن‌ها با پشتیبانی از صفحه‌بندی را فراهم می‌کند. کد زیر نشان می‌دهد چگونه پیام‌ها را با پشتیبانی از صفحه‌بندی فیلتر کنیم.

Net: مدیریت پرچم‌های پیام در سرور IMAP

Mon, 01 Jan 0001 00:00:00 +0000

تنظیم/تغییر پرچم‌های پیام

می‌توانید پرچم‌های پیام را با تنظیم پرچم‌های جدید با استفاده از ChangeMessageFlags() متد. این متد دو پارامتر می‌گیرد.

شماره توالی یک پیام یا شناسه یکتای آن.
MessageFlag.

پرچم‌های زیر می‌توانند تنظیم شوند:

کد نمونه زیر نشان می‌دهد چگونه پرچم‌های پیام را در یک سرور IMAP با Aspose.Email تغییر دهید.

حذف پرچم‌های پیام

پرچم‌های پیام همچنین می‌توانند با استفاده از RemoveMessageFlags() متد. استفاده مشابه آنچه برای ChangeMessageFlags() متد. این متد یک شماره توالی یا شناسه یکتای پیام را می‌گیرد و MessageFlag. کد نمونه زیر نشان می‌دهد چگونه پرچم‌های پیام را حذف کنید.

تنظیم پرچم‌های سفارشی

همچنین می‌توانید با استفاده از پرچم‌های سفارشی به یک پیام تنظیم کنید ImapClient از API. ImapClient AddMessageFlags امکان تنظیم پرچم‌های سفارشی بر روی پیام‌ها را فراهم می‌کند.

Net: مدیریت پوشه‌ها در سرور IMAP

Mon, 01 Jan 0001 00:00:00 +0000

عملیات پوشه

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

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

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

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

این DeleteFolder() متد نام پوشه را به‌عنوان پارامتر می‌پذیرد.
برای RenameFolder() متد، باید نام پوشهٔ فعلی و نام پوشهٔ جدید را پاس کنید. کد زیر نشان می‌دهد چگونه یک پوشه را از سرور IMAP حذف کنید و چگونه یک پوشه را تغییر نام دهید. هر عملیات با یک خط کد انجام می‌شود.

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

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

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

پوشه‌ها**

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

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

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

می‌توانید چندین پیام را با استفاده از AppendMessages متد ارائه‌شده توسط ImapClient کلاس‌ها. AppendMessages متد لیستی از MailMessage و اگر پوشه به‌عنوان پارامتر ارائه نشود، به پوشهٔ جاری اضافه می‌کند. ImapClient همچنین حالت MultiConnection را برای عملیات سنگین پشتیبانی می‌کند. کد زیر نشان می‌دهد چگونه با استفاده از حالت MultiConnection چندین پیام را اضافه کنید.

لطفاً توجه داشته باشید که استفاده از حالت چنداتصال تضمین‌کننده‌ی افزایش عملکرد نیست.

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

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

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

پوشه‌ها**

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

Net: عملیات‌های غیرهمزمان IMAP: بازیابی، مدیریت و ارسال ایمیل‌ها

Mon, 01 Jan 0001 00:00:00 +0000

عملیات‌های غیرهمزمان با ImapClient

کار با پیام‌ها می‌تواند به صورت غیرهمزمان با استفاده از Aspose.Email انجام شود ImapClient. این مقاله بازیابی پیام‌ها از یک صندوق‌پست به صورت غیرهمزمان را نشان می‌دهد. همچنین این مقاله نشان می‌دهد چگونه با استفاده از معیارهای جستجو، پیام‌ها را لیست کنیم با استفاده از MailQuery. به طور جداگانه نشان داده خواهد شد که چگونه یک عملیات را با پیام‌های ایمیلی که توسط الگوی غیرهمزمان مبتنی بر تسک آغاز شده است، قطع کنیم ( TAP) متد.

بازیابی پیام‌ها به صورت ناهمزمان

کد زیر نشان می‌دهد چگونه پیام‌ها را به صورت ناهمزمان بازیابی کنیم.

فهرست‌کردن پیام‌ها به‌صورت ناهمزمان با MailQuery

این MailQuery کلاسی که می‌توان برای تعیین معیارهای جستجو برای بازیابی یک فهرست مشخص از پیام‌ها به صورت ناهمزمان استفاده کرد، همان‌طور که در نمونه کد زیر نشان داده شده است.

ارسال پیام‌ها به صورت ناهمزمان

ارسال ایمیل‌ها به صورت غیرهمزمان بسیار راحت است، زیرا این فرآیند اجرای برنامه یا رشته را مسدود نمی‌کند. به جای انتظار برای دریافت ایمیل قبل از ارسال برنامه می‌تواند به کارهای دیگر ادامه دهد، در حالی که ایمیل در پس‌زمینه ارسال می‌شود.

ویژگی‌های زیر به شما کمک می‌کنند تا ارسال غیرهمزمان را در پروژه خود پیاده‌سازی کنید:

IAsyncImapClient - به برنامه‌ها اجازه می‌دهد تا با استفاده از پروتکل IMAP (Internet Message Access Protocol) به پیام‌ها دسترسی داشته و آن‌ها را دست‌کاری کنند.
ImapClient.CreateAsync - یک نمونه جدید از کلاس Aspose.Email.Clients.Imap.ImapClient ایجاد می‌کند

نمونه کد زیر نشان می‌دهد چگونه پیام‌ها را در پشت‌صحنه لیست کنید:

// Authenticate the client to obtain necessary permissions
static readonly string tenantId = "YOU_TENANT_ID";
static readonly string clientId = "YOU_CLIENT_ID";
static readonly string redirectUri = "http://localhost";
static readonly string username = "username";
static readonly string[] scopes = { "https://outlook.office.com/IMAP.AccessAsUser.All" };

// Use the ImapAsync method for asynchronous operations
static async Task Main(string[] args)
{
    await ImapAsync();
    Console.ReadLine();
}

// Establish the connection with the server
// Create an instance of the ImapClient asynchronously using the CreateAsync method
// Select the Inbox folder using SelectFolderAsync method to complete and fetch the list of email messages asynchronously using the ListMessagesAsync method.
static async Task ImapAsync()
{
    var tokenProvider = new TokenProvider(clientId, tenantId, redirectUri, scopes);
    var client = ImapClient.CreateAsync("outlook.office365.com", username, tokenProvider, 993).GetAwaiter().GetResult();
    await client.SelectFolderAsync(ImapFolderInfo.InBox);
    var messages = await client.ListMessagesAsync();
    Console.WriteLine("Messages :" + messages.Count);
}

// Token provider implementation
public class TokenProvider : IAsyncTokenProvider
{
    private readonly PublicClientApplicationOptions _pcaOptions;
    private readonly string[] _scopes;

    public TokenProvider(string clientId, string tenantId, string redirectUri, string[] scopes)
    {
        _pcaOptions = new PublicClientApplicationOptions
        {
            ClientId = clientId,
            TenantId = tenantId,
            RedirectUri = redirectUri
        };

        _scopes = scopes;
    }

    public async Task<OAuthToken> GetAccessTokenAsync(bool ignoreExistingToken = false, CancellationToken cancellationToken = default)
    {

        var pca = PublicClientApplicationBuilder
            .CreateWithApplicationOptions(_pcaOptions).Build();

        try
        {
            var result = await pca.AcquireTokenInteractive(_scopes)
                .WithUseEmbeddedWebView(false)
                .ExecuteAsync(cancellationToken);

            return new OAuthToken(result.AccessToken);
        }
        catch (MsalException ex)
        {
            Console.WriteLine($"Error acquiring access token: {ex}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex}");
        }

        return null;
    }

    public void Dispose()
    {

    }
}

مدیریت عملیات‌های غیرهمزمان

قطع یک متد TAP

از .NET Framework 4.5 به بعد، می‌توانید از متدهای غیرهمزمان پیاده‌سازی‌شده بر اساس مدل TAP استفاده کنید. قطعه کد زیر نشان می‌دهد چگونه بسیاری از پیام‌ها را با استفاده از متد الگوی غیرهمزمان مبتنی بر تسک به نام AppendMessagesAsync و سپس پس از مدتی این فرآیند را قطع کنید.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

List<MailMessage> mailMessages = new List<MailMessage>();

// create mail messages
for (int i = 0; i < 100; i++)
    mailMessages.Add(new MailMessage(senderEmail, receiverEmail, $"Message #{i}", "Text"));

using (ImapClient client = new ImapClient(host, 993, senderEmail, password, SecurityOptions.SSLImplicit))
{
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
    AutoResetEvent autoResetEvent = new AutoResetEvent(false);
    Exception exception = null;

    ThreadPool.QueueUserWorkItem(delegate
    {
        try
        {
            // start uploading the messages
            var task = client.AppendMessagesAsync(mailMessages, cancellationTokenSource.Token);
            AppendMessagesResult appendMessagesResult = task.GetAwaiter().GetResult();
            Console.WriteLine("All messages have been appended.");
        }
        catch (Exception e)
        {
            exception = e;
        }
        finally
        {
            autoResetEvent.Set();
        }
    });

    Thread.Sleep(5000);

    // stop uploading the messages
    cancellationTokenSource.Cancel();
    autoResetEvent.WaitOne();

    foreach (MailMessage mailMessage in mailMessages)
        mailMessage.Dispose();

    if (exception is OperationCanceledException)
        Console.WriteLine("Operation has been interrupted: " + exception.Message);
}

لغو عملیات‌های غیرهمزمان

گاهی ممکن است به توقف عملیات‌های غیرهمزمان نیاز داشته باشید. برای این منظور کتابخانه ما لغو عملیات‌های غیرهمزمان را از طریق استفاده از پارامتر CancellationToken ارائه می‌دهد. هنگامی که یک متد غیرهمزمان که از لغو پشتیبانی می‌کند را صدا می‌زنید، می‌توانید یک نمونه CancellationToken را به عنوان پارامتر پاس دهید. CancellationToken برای ارسال سیگنال و کنترل لغو عملیات استفاده می‌شود.

برای فعال‌سازی لغو، ابتدا باید یک شیء CancellationTokenSource ایجاد کنید که CancellationToken را فراهم می‌کند. سپس، CancellationToken را به متد غیرهمزمان پاس دهید تا در طول اجرا درخواست‌های لغو را بررسی کند.

در اینجا یک مثال که لغو عملیات را با استفاده از CancellationToken نشان می‌دهد:

CancellationTokenSource tokenSource = new CancellationTokenSource();
AppendMessagesResult appendMessagesResult = null;
AutoResetEvent autoResetEvent = new AutoResetEvent(false);
ThreadPool.QueueUserWorkItem(delegate(object state)
    {
        try
        {
            appendMessagesResult = imapClient.AppendMessagesAsync(mmList, tokenSource.Token).GetAwaiter().GetResult();
        }
        catch (Exception ex)
        {

        }
        finally
        {
            autoResetEvent.Set();
        }
    });

tokenSource.Cancel();
autoResetEvent.WaitOne();

Net: چگونگی فعال‌سازی ثبت فعالیت IMAP

Mon, 01 Jan 0001 00:00:00 +0000

ثبت فعالیت برای رفع خطا و همچنین جمع‌آوری و تحلیل اطلاعات کاری مربوط به کلاینت IMAP استفاده می‌شود.

فعال‌سازی ثبت فعالیت

استفاده از فایل appsettings.json برای فعال‌سازی لاگ‌گیری فعالیت

یادداشت: این گزینه برای برنامه‌های .NET Core ترجیح داده می‌شود.

ورود به سیستم ImapClient می‌تواند با مراحل و نمونه‌های کد زیر فعال شود:

یک فایل پیکربندی appsettings.json به پروژه C# اضافه کنید، اگر قبلاً اضافه نشده باشد.

اطمینان حاصل کنید که فایل پروژه خطوط زیر را در بخش ItemGroup دارد.

   <Content Include="appsettings.json">
       <CopyToOutputDirectory>Always</CopyToOutputDirectory>
   </Content>

سپس محتویات زیر را به فایل appsettings.json اضافه کنید.

   {
     "ImapDiagnosticLog": "imap.log",
     "ImapDiagnosticLog_UseDate": true
   }

دو ویژگی ذکر شده در بالا عبارتند از:

ImapDiagnosticLog - مسیر نسبی یا مطلق فایل لاگ را مشخص می‌کند.
ImapDiagnosticLog_UseDate - مشخص می‌کند آیا یک نمایش رشته‌ای از تاریخ جاری به نام فایل لاگ اضافه شود یا خیر.

فعال‌سازی لاگ‌گیری فعالیت در کد برنامه

همچنین می‌توانید ثبت‌لاگ را بلافاصله در کد فعال کنید.

یادداشت: حتی اگر قبلاً با استفاده از فایل‌های پیکربندی ثبت‌لاگ را فعال کرده‌اید، این گزینه اعمال خواهد شد.

ورود به سیستم ImapClient می‌تواند با مراحل و نمونه‌های کد زیر فعال شود:

یک ImapClient.
مسیر فایل لاگ را با استفاده از تنظیم کنید LogFileName ویژگی.
تنظیم UseDateInLogFileName خاصیت در صورت نیاز.

   using (var client = new ImapClient("your imap server", 993, "your username", "your password"))
{
    // Set security mode
    client.SecurityOptions = SecurityOptions.Auto;

    // Set the path to the log file using the LogFileName property.
    client.LogFileName = @"C:\Aspose.Email.IMAP.log";

    // Set the UseDateInLogFileName property if it is necessary.
    client.UseDateInLogFileName = false;
}

استفاده از فایل App.config برای فعال‌سازی لاگ‌گیری فعالیت

ImapClient فعالیت می‌تواند با ویرایش configSections در فایل پیکربندی ثبت شود. مراحل زیر برای انجام ثبت لاگ عیب‌یابی آورده شده است:

یک sectionGroup به نام "applicationSettings" اضافه کنید.
یک section به نام "Aspose.Email.Properties.Settings" اضافه کنید.
تنظیم ImapDiagonosticLog را اضافه کنید که نام فایل در applicationSettings/Aspose.Email.Properties.Settings تعریف شده است.

در اینجا یک برنامه فرم نمونه که استفاده می‌کند ImapClient برای پردازش ایمیل. تمام این فعالیت با ویرایش فایل App.config ثبت می‌شود.

یک برنامه مبتنی بر فرم با یک دکمه ایجاد کنید. کد نمونه زیر را برای رویداد کلیک دکمه اضافه کنید:

یک ارجاع به Aspose.Email اضافه کنید.

اکنون فایل App.Config را اضافه کنید و آن را طوری ویرایش کنید که محتوای آن به صورت زیر باشد:

برای C# .NET از گزینه زیر استفاده کنید

|| | | :- | :- | برای VB .NET از گزینه زیر استفاده کنید

کد را اجرا کنید و سپس پوشه Log را مشاهده کنید. فایل زیر تولید خواهد شد.

Net: اعتبارسنجی اعتبارهای سرور ایمیل IMAP با API .NET

Mon, 01 Jan 0001 00:00:00 +0000

API Aspose.Email امکان اعتبارسنجی اعتبارهای سرور ایمیل را بدون ارسال ایمیل فراهم می‌کند. ValidateCredentials متد مسئول تأیید صحت و اعتبار اعتبارهای ایمیل ارائه‌شده است، که معمولاً برای احراز هویت هنگام اتصال به سرور استفاده می‌شوند.

این بررسی می‌کند که اعتبارهای ایمیل ارائه‌شده، مانند نام کاربری و رمز عبور، معتبر هستند و این که امکان برقراری ارتباط موفقیت‌آمیز کلاینت با سرور وجود دارد. این اعتبارسنجی به اطمینان از دسترسی امن کلاینت به حساب ایمیل و انجام عملیات‌های مختلف مانند دریافت ایمیل کمک می‌کند.

using (ImapClient client = new ImapClient(server.ImapUrl, server.ImapPort, "username", "password", SecurityOptions.Auto))
{
    client.Timeout = 4000;
   
    if (client.ValidateCredentials())
    {
        //to do something
    }
}

برای یک عملیات غیرهمزمان، یک نسخه دیگر از متد نیز وجود دارد ValidateCredentialsAsync.

Net: عملیات پشتیبان‌گیری و بازیابی IMAP

Mon, 01 Jan 0001 00:00:00 +0000

پشتیبان‌گیری و بازیابی استاندارد

Aspose.Email برای .NET امکان پشتیبان‌گیری و بازیابی پیام‌ها را فراهم می‌کند. برای این منظور، API روش‌های زیر را ارائه می‌دهد.

این مقاله نشان می‌دهد چگونه پیام‌ها را با استفاده از ImapClient کلاس.

پشتیبان‌گیری از پیام‌ها

برای پشتیبان‌گیری از پیام‌ها، از ImapClient.Backup متد همان‌طور که در قطعه کد زیر نشان داده شده است.

بازیابی پیام‌ها

برای بازیابی پیام‌ها، از ImapClient.Restore متد همان‌طور که در قطعه کد زیر نشان داده شده است.

پشتیبان‌گیری و بازیابی IMAP با MultiConnection

هنگامی که با تعداد زیادی پیام کار می‌کنید، عملیات پشتیبان‌گیری/بازیابی ممکن است زمان‌بر باشد. برای این منظور، API پشتیبانی از چندین اتصال را در طول عملیات پشتیبان‌گیری و بازیابی فراهم می‌کند. برای فعال‌سازی حالت MultiConnection، مقدار را تنظیم کنید ImapClient.UseMultiConnection ویژگی برای MultiConnectionMode.Enable. قطعه‌های کد زیر عملیات پشتیبان‌گیری و بازیابی را با حالت MultiConnection فعال شده نشان می‌دهند.

قطعه‌های کد زیر عمل پشتیبان‌گیری را با حالت MultiConnection فعال نشان می‌دهند.

قطعه‌های کد زیر عمل بازیابی را با حالت MultiConnection فعال نشان می‌دهند.

Net: چگونگی حذف پیام‌ها از سرور IMAP با استفاده از .NET Core

Mon, 01 Jan 0001 00:00:00 +0000

حذف پیام‌ها

این ImapClient کلاس می‌تواند پیام‌ها را از یک سرور IMAP حذف کند. ImapClient کلاس DeleteMessage() تابعی که برای حذف پیام‌ها استفاده می‌شود. این تابع شماره توالی پیام یا شناسه یکتا را به‌عنوان پارامتر می‌گیرد. ImapClient فراهم می‌کند DeleteMessage و DeleteMessages روش‌هایی برای حذف پیام‌ها به‌صورت تک‌تک یا به‌صورت چندگانه. کد نمونه زیر نشان می‌دهد چطور یک پیام ایمیل با شناسه پیام ۱ را از یک سرور IMAP حذف کنید.

using var client = new ImapClient("host", "username", "password");
client.SecurityOptions = SecurityOptions.SSLImplicit;

// Append test message
client.SelectFolder(ImapFolderInfo.InBox);

var eml = new MailMessage("from@from.com", "to@to.com")
{
  Subject = "Message to delete",
  Body = "Hey! This Message will be deleted!"
};
var emlId = client.AppendMessage(eml);

// Delete appended message
client.DeleteMessage(emlId);
client.CommitDeletes();

حذف چندین پیام

ایمیل‌های متعدد می‌توانند با استفاده از ImapClient از API Aspose.Email. DeleteMessages متد گزینه‌های متعددی برای حذف چندین پیام از سرور با استفاده از شناسه‌های یکتا، شماره‌های توالی یا ImapMessageInfoCollection عناصر. کد نمونه زیر نشان می‌دهد چگونه چندین پیام را حذف کنید.

using var client = new ImapClient("host", "username", "password");
client.SelectFolder(ImapFolderInfo.InBox);
            
// Append test messages
var emlList = new List<MailMessage>();
{
  var eml = new MailMessage("from@from.com", "to@to.com")
  {
    Subject = $"Message to delete {i}",
    Body = "Hey! This Message will be deleted!"
  };
                
  emlList.Add(eml);
}

var appendMessagesResult = client.AppendMessages(emlList);
            
// Bulk Delete appended Messages
client.DeleteMessages(appendMessagesResult.Succeeded.Values, true);
client.CommitDeletes();