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 constructor.

הערה, מגבלות סיסמה חייבות לעמוד בדרישות השרת. לקוח האימייל אינו מוסיף מגבלות סיסמה.

לאחר שה 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. מאמר זה מספק דוגמה עובדת של גישה לתיבת דואר באמצעות שרת פרוקסי דואר. כדי לגשת לתיבת הדואר דרך שרת פרוקסי:

אתחול מתווך Socks עם המידע הדרוש, כלומר כתובת הפרוקסי, פורט וגרסת SOCKS.
אתחול ImapClient עם כתובת השרת, שם משתמש, סיסמה וכל הגדרה אחרת.
הגדר את הלקוח מתווך Socks מאפיין של הלקוח ל- מתווך Socks אובייקט שנוצר למעלה.

הקטע הקוד הבא מראה כיצד לאחזר תיבת דואר דרך שרת פרוקסי.

// 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 for .NET מציע שיטת אימות CRAM-MD5. הקטע הקוד הבא יראה כיצד היא עובדת עם ImapClient:

imapClient.AllowedAuthentication = ImapKnownAuthenticationType.CramMD5;

קביעת זמן קצוב לפעולות IMAP

כל פעולת דואר לוקחת זמן מסוים בהתאם למגוון גורמים (עיכובי רשת, גודל הנתונים, ביצועי השרת, וכו’). ניתן להגדיר זמן קצוב לכל פעולות הדואר. דוגמת הקוד שלהלן מראה כיצד לבצע זאת באמצעות זמן קצוב מאפיין. הערה: אין להגדיר ערכים גדולים כדי למנוע המתנה ארוכה באפליקציה שלך.

הגדר זמן קצוב לפעולה

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

    // some code...
}

הגבל זמן קבלת הפנים

לקוח ה‑IMAP עשוי להשתמש במצב האוטומטי כדי להקים חיבור. במצב זה, לקוח ה‑IMAP משדרג דרך כל פרמטרי החיבור האפשריים עד להקמת החיבור. שרת IMAP במקרה של חיבור נכון שולח מחרוזת קבלת פנים (greeting) ללקוח. שרתים עשויים להשתמש באתחול חיבור SSL/TLS באופן מפורש (START TLS) או מעוות (implicit). אם מצב החיבור אינו תואם (למשל, השרת מצפה לחיבור 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

API של Aspoe.Email ImapClient מספקת את היכולת לפתוח חיבור לשרת ולחכות להגעת הודעת דוא"ל. זה מאפשר להימנע משאילתות חוזרות לשרת על הודעות נכנסות. הקטע הקוד הבא מדגים כיצד להשתמש בספריית 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

Aspose.Email API מספק תמיכה בהרחבות 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 for .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 מהשרת

מידע הודעה Imap מספק את ה-MIME MessageId לזיהוי הודעה מבלי לחלץ את ההודעה המלאה. הקטע הקוד הבא מראה כיצד לרשום MIME messageId.

רשימת הודעות מהשרת

Aspose.Email מספקת גרסה עם שני משתנים של 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 המכילה מידע על ההודעות בתיבת הדואר.
העבר על כל הודעה ב‑messageInfoCollection בעזרת לולאת foreach.
הפעל את ListAttachments() מתודה באובייקט imapClient, שמעבירה את המאפיין SequenceNumber של אובייקט ההודעה כפרמטר. מתודה זו תחזיר ImapAttachmentInfoCollection המכילה מידע על הקבצים המצורפים בהודעה.
העבר על כל קובץ מצורף ב‑attachmentInfoCollection בעזרת לולאת foreach.
בתוך הלולאה הפנימית, ניתן לגשת למידע על כל קובץ מצורף באמצעות תכונות של האובייקט 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 מתודה לקבלת ה- אוסף מידע הודעה Imap אובייקט.
איטרציה דרך ה- אוסף מידע הודעה Imap אוסף, קרא ל- SaveMessage() מתודה והספק את נתיב הפלט ואת שם הקובץ.

קוד הקטע הבא מראה כיצד לאחזר הודעות אימייל משרת ולשמור אותן.

שליפת הודעות בסדר יורד

Aspose.Email מספקת ImapClient.ListMessagesByPage מתודה שמציגה הודעות עם תמיכת דפדוף. כמה עומסים של ImapClient.ListMessagesByPage מקבל PageSettings כפרמטר. PageSettings מספק AscendingSorting מאפיין שבעת הגדרתו ל‑false, מחזיר מיילים בסדר יורד.

קוד הדוגמה הבא מדגים את השימוש ב- AscendingSorting מאפיין של PageSettings מחלקה לשינוי סדר האימיילים.

שמירת הודעות בפורמט MSG

כדי לשמור מיילים בפורמט MSG, ה‑ ImapClient.FetchMessage() יש לקרוא למתודה. היא מחזירה את ההודעה כמופע של MailMessage מחלקה. ה- MailMessage.Save() מתודה יכולה לאחר מכן להיקרא לשמירת ההודעה כ‑MSG. קטע הקוד הבא מראה כיצד לשמור הודעות בפורמט MSG.

קיבוץ הודעות שנשלפו

ImapClient מספק FetchMessages מתודה המקבלת איטרביל של מספרי סדר או ID ייחודי ומחזירה רשימה של MailMessage. קוד הדוגמה הבא מדגים את השימוש ב- FetchMessages מתודה להבאת הודעות לפי מספרי סדר ו-ID ייחודי.

שליפת תיקיות וקריאת הודעות באופן רקורסיבי

במאמר זה, רוב ה- ImapClient התכונות משמשות ליצירת יישום המכניס לרשימה את כל התיקיות ותת‑תיקיות באופן רקורסיבי משרת IMAP. הוא גם שומר את ההודעות בכל תיקייה ותת‑תיקייה בפורמט MSG על דיסק מקומי. על הדיסק, התיקיות וההודעות נוצרות ונשמרות באותה מבנה היררכי כפי שמצוי בשרת IMAP. קטע הקוד הבא מראה כיצד לקבל את המידע על הודעות ותת‑תיקיות באופן רקורסיבי.

טיפול במידע הודעה מיוחד

קבלת פרמטרים נוספים כמידע סיכום

קבלת מידע בכותרת List-Unsubscribe

כותרת List-Unsubscribe מכילה את כתובת ה-URL לביטול מנוי מרשימות דואר אלקטרוני כגון פרסומות, ניוזלטרים וכו’. כדי לקבל את כותרת List-Unsubscribe, השתמש ב- ListUnsubscribe מאפיין של מידע הודעה Imap מחלקה. הדוגמה הבאה מציגה את השימוש ב- ListUnsubscribe מאפיין לקבלת הכותרת List-Unsubscribe.

Net: סינון הודעות משרת IMAP ב‑C#

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

סינון הודעות בסיסי

ה ImapClient class מספקת את ListMessages() מתודה אשר מקבלת את כל ההודעות מתיבת דואר. כדי לקבל רק הודעות שתואמות תנאי מסוים, השתמש ב- ListMessages() מתודה אשר מקבלת MailQuery כארגומנט. ה- MailQuery המחלקה מספקת מגוון מאפיינים לציון תנאים, לדוגמה תאריך, נושא, שולח, נמען וכד’. הדוגמה הראשונה מדגימה כיצד לסנן הודעות בהתבסס על תאריך ונושא. אנו גם מציגים כיצד לסנן לפי קריטריונים נוספים וכאיך לבנות שאילתות מורכבות יותר. ה-API גם מספק את היכולת להחיל קריטריונים של חיפוש רגיש לרישיות כדי להתאים לקריטריוני סינון מדויקים. בנוסף, ה-API מאפשר לציין את קידוד מחרוזת החיפוש עבור סינון הודעות מתיבת הדואר.

סינון הודעות מתיבת הדואר

התחבר והתחבר לשרת IMAP
צור מופע של MailQuery ולקבוע את המאפיינים
הפעל את ImapClient.ListMessages(MailQuery query) method והעבר את MailQuery עם הפרמטרים כדי לקבל רק הודעות מסוננות.

הקטע הקוד הבא מראה כיצד להתחבר לתיבת דואר IMAP ולקבל הודעות שהגיעו היום ובנושא יש את המילה "newsletter".

סינון הודעות לפי קריטריונים ספציפיים

דוגמות הקוד שלעיל מסנן הודעות בהתבסס על נושא ויום של הדוא"ל. אנו יכולים להשתמש במאפיינים אחרים כדי להגדיר תנאים נתמכים נוספים גם. להלן כמה דוגמאות לקביעת התנאים באמצעות MailQuery. קטעי הקוד הבאים מראים כיצד לסנן אימיילים על‑בסיס:

תאריך היום.
טווח תאריכים.
משולח ספציפי.
מדומיין ספציפי.
ממען ספציפי.

תאריך היום

הקטע הקוד הבא מראה כיצד לסנן אימיילים לפי התאריך של היום.

טווח תאריכים

הקטע הקוד הבא מראה כיצד לסנן אימיילים לפי טווח תאריכים.

שולח ספציפי

הקטע הקוד הבא מראה כיצד לסנן אימיילים לשולח ספציפי.

דומיין ספציפי

הקטע הקוד הבא מראה כיצד לסנן אימיילים לדומיין ספציפי.

מקבל ספציפי

הקטע הקוד הבא מראה כיצד לסנן אימיילים לנמען ספציפי.

בניית שאילתות מתקדמת

אם שונים MailQueryBuilder מאפיינים מוגדרים בהצהרות נפרדות, ואז כל התנאים יותאמו. לדוגמה, אם אנחנו רוצים לקבל הודעות בטווח תאריכים וממארח ספציפי, עלינו לכתוב שלוש הצהרות.

שילוב שאילתות עם AND

קוד הדוגמה הבא מציג כיצד לשלב שאילתות עם AND.

שילוב שאילתות עם OR

MailQueryBuilder מספקת את Or() מתודה שלוקחת שני MailQuery מופעים כפרמטרים. הוא מקבל את ההודעות שתואמות לאחד משני התנאים שהוגדרו. הקטע הקוד הבא מראה כיצד לסנן הודעות שהנושא שלהן מכיל "test" או שהן נשלחות מ-"noreply@host.com". הקטע הקוד הבא מראה איך לשלב שאילתות בעזרת OR.

סינון על בסיס InternalDate

ניתן לחלץ הודעות מהשרת בהתבסס על InternalDate, אך לפעמים השרת אינו מחזיר את כל ההודעות כפי שהן נראות בתיבת הדואר נכנסה. הסיבה יכולה להיות אזור זמן של השרת מכיוון שלא תמיד הוא UTC לכל השרתים כגון Gmail. Aspose שולחת פקודות כגון 008 SEARCH ON 4-May-2014 בהתאם ל- פרוטוקול IMAP עם זאת התוצאה יכולה להשתנות עקב הגדרות אזור זמן של השרת. חבר חדש נוסף ב- מידע הודעה Imap כ־ InternalDate שמסייעת יותר בסינון ההודעות. הקטע הקוד הבא מראה את השימוש ב- InternalDate לסינון הודעות.

סינון רגיש לאותיות גדולות/קטנות

הקטע הקוד הבא מראה כיצד להשתמש בסינון אימיילים רגיש לרישיות.

ציין קידוד עבור בניית השאילתא

של ה-API בונה שאילתות Imap הבנאי יכול לשמש לציון הקידוד עבור מחרוזת החיפוש. ניתן גם להגדיר זאת באמצעות ה- 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 מחלקה. היא מחזירה אובייקט של אוסף מידע תיקייה Imap סוג. עבר על האוסף הזה וקבל מידע על כל תיקייה בנפרד בלולאה. המתודה מעודנת. ניתן להעביר שם תיקייה כפרמטר כדי לקבל רשימת תתי‑תיקיות. קטע הקוד הבא מראה כיצד לקבל מידע על תיקיות משרת 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).
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 עם .NET API

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 שיטות למחיקת הודעות אחת אחת או מרובות. הקטע הקוד הבא מציג כיצד למחוק הודעת אימייל עם מזהה הודעה 1 משרת 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 המתודה מספקת מספר אפשרויות למחיקת הודעות מרובות מהשרת באמצעות מזהים ייחודיים, מספרי סדר או אוסף מידע הודעה Imap אלמנטים. הקטע הקוד הבא מראה כיצד למחוק הודעות מרובות.

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

Documentation – ביצוע עבודה עם לקוח IMAP

Net: התחברות לשרת IMAP

רשימת הרחבות שרת IMAP

חיבור IMAP סטנדרטי

חיבור IMAP עם SSL

הגדרת חיבור פרוקסי

התחברות לשרת דרך פרוקסי

התחברות לשרת דרך פרוקסי HTTP

חיבור במצב קריאה בלבד

הגדרת אימות CRAM-MD5

קביעת זמן קצוב לפעולות IMAP

הגדר זמן קצוב לפעולה

הגבל זמן קבלת הפנים

שימוש בפרוטוקולי קריפטוגרפיה עם IMAP

שימוש בפקודת IMAP IDLE

תמיכה בהרחבות IMAP

פקודת רשימה מורחבת של IMAP4

Net: ניהול הודעות בשרת IMAP

קבלת והצגת הודעות

איך לקבל מידע זיהוי עבור הודעות בתיבת דואר

רשימת מזהי הודעות MIME מהשרת

רשימת הודעות מהשרת

רשימת הודעות באופן רקורסיבי

רשימת הודעות עם מרובה חיבורים

רשימת הודעות עם תמיכת עימוד

רשימת קבצים מצורפים להודעה

אחזור ושמירת הודעות

שליפת הודעות מהשרת

שליפת הודעות בסדר יורד

שמירת הודעות בפורמט MSG

קיבוץ הודעות שנשלפו

שליפת תיקיות וקריאת הודעות באופן רקורסיבי

טיפול במידע הודעה מיוחד

קבלת פרמטרים נוספים כמידע סיכום

קבלת מידע בכותרת List-Unsubscribe

Net: סינון הודעות משרת IMAP ב‑C#

סינון הודעות בסיסי

סינון הודעות מתיבת הדואר

סינון הודעות לפי קריטריונים ספציפיים

תאריך היום

טווח תאריכים

שולח ספציפי

דומיין ספציפי

מקבל ספציפי

בניית שאילתות מתקדמת

שילוב שאילתות עם AND

שילוב שאילתות עם OR

סינון על בסיס InternalDate

סינון רגיש לאותיות גדולות/קטנות

ציין קידוד עבור בניית השאילתא

אפשרויות סינון מותאמות אישית

סינון הודעות עם דגל מותאם

חיפוש מותאם לסינון

סינון הודעות עם תמיכת דפדוף

Net: **ניהול דגלי הודעה בשרת IMAP**

הגדרה/שינוי של דגלי הודעה

הסר דגלי הודעה

הגדרת דגלים מותאמים

Net: **ניהול תיקיות בשרת IMAP**

פעולות על תיקיות

קבלת מידע על תיקייה

מחיקה ושינוי שם תיקיות

עבודה עם תיקיות תיבת דואר בשימוש מיוחד

פעולות על הודעות בתוך תיקיות

הוספת הודעה חדשה לתיקייה

הוספת הודעות מרובות עם MultiConnection

הזזת הודעות בין תיקיות

העתקת הודעות בין תיקיות

Net: **פעולות IMAP אסינכרוניות: אחזור, ניהול ושליחת אימיילים**

פעולות אסינכרוניות עם ImapClient

איחזור הודעות באופן אסינכרוני

רשימת הודעות בצורה אסינכרונית עם MailQuery

שלח הודעות אסינכרוניות

ניהול פעולות אסינכרוניות

הפסקת שיטת TAP

ביטול פעולות אסינכרוניות

Net: איך לאפשר רישום פעילות IMAP

אפשר רישום פעילות

שימוש בקובץ appsettings.json להפעלת רישום פעילות

הפעלת רישום פעילות בקוד התוכנית

Net: ניהול דגלי הודעה בשרת IMAP

Net: ניהול תיקיות בשרת IMAP

Net: פעולות IMAP אסינכרוניות: אחזור, ניהול ושליחת אימיילים

Net: אימות פרטי שרת דואר IMAP עם .NET API