סינון מיילים משרת הדואר
סינון הודעות לפי שולח, נמען או תאריך
ה Pop3Client מחלקה, המתוארת ב- התחבר לשרת POP3, מספקת את ListMessages() מתודה אשר מקבלת את כל ההודעות מתיבת דואר. כדי לקבל רק הודעות שתואמות תנאי מסוים, השתמש ב- ListMessages() מתודה אשר מקבלת MailQuery כארגומנט. ה- MailQuery המחלקה מספקת מאפיינים שונים לציון תנאי השאילתה, כגון תאריך, נושא, שולח, נמען ועוד. ה- MailQueryBuilder מחלקה משמשת לבניית הביטוי החיפוש. ראשית, כל התנאים והמגבלות מוגדרים ולאחר מכן MailQuery מתמלא עם השאילתה שפותחה על ידי MailQueryBuilder. ה MailQuery אובייקט המחלקה משמש על ידי Pop3Client כדי לחלץ את המידע המסונן מהשרת. מאמר זה מראה כיצד לסנן הודעות אימייל מתיבת דואר. הדוגמה הראשונה מבהירה כיצד לסנן הודעות על פי תאריך ונושא. אנו גם מציגים סינון על פי קריטריונים אחרים וכיצד לבנות שאילתות מורכבות יותר. הוא גם מציג יישום של מסנן תאריך ושעה כדי לאחזר את האימיילים הספציפיים מתיבת הדואר. בנוסף, הוא מציג כיצד ליישם סינון רגיש לאותיות.
סינון הודעות מתיבת הדואר
כדי לסנן הודעות מתיבת דואר:
- התחבר לשרת POP3.
- צור מופע של MailQuery ולקבוע את המאפיינים הרצויים.
- הפעל את Pop3Client.ListMessages(MailQuery query) method והעבר את MailQuery בפרמטרים כדי לקבל רק את ההודעות המסוננות.
קוד הדוגמה הבא מציג כיצד להתחבר לתיבת דואר POP3 ולקבל הודעות שהגיעו היום ויש במושאן את המילה "newsletter".
// Connect and log in to POP3
const string host = "host";
const int port = 110;
const string username = "user@host.com";
const string password = "password";
Pop3Client client = new Pop3Client(host, port, username, password);
// Set conditions, Subject contains "Newsletter", Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.Subject.Contains("Newsletter");
builder.InternalDate.On(DateTime.Now);
// Build the query and Get list of messages
MailQuery query = builder.GetQuery();
Pop3MessageInfoCollection messages = client.ListMessages(query);
Console.WriteLine("Pop3: " + messages.Count + " message(s) found.");
קבלת הודעות לפי קריטריונים ספציפיים
דוגמות הקוד שלעיל מראה כיצד ניתן לסנן הודעות על פי נושא האימייל והתאריך. אנו יכולים להשתמש בתכונות אחרות כדי לקבוע תנאים נתמכים נוספים. להלן כמה דוגמאות להגדרת התנאים באמצעות MailQuery.
קוד הדוגמאות שלהלן מראה כיצד לסנן הודעות דוא"ל על פי קריטריונים אחרים:
- מצא הודעות שנמסרו היום.
- מצא הודעות שהתקבלו בטווח.
- מצא הודעות משולח ספציפי.
- מצא הודעות שנשלחו מדומיין ספציפי.
- מצא הודעות שנשלחו למקבל ספציפי.
תאריך היום
קוד הדוגמה הבא מציג כיצד למצוא הודעות שנמסרו היום.
// Emails that arrived today
MailQueryBuilder builder = new MailQueryBuilder();
builder.InternalDate.On(DateTime.Now);
טווח תאריכים
קוד הדוגמה הבא מראה כיצד למצוא הודעות שהתקבלו בטווח.
// Emails that arrived in last 7 days
builder.InternalDate.Before(DateTime.Now);
builder.InternalDate.Since(DateTime.Now.AddDays(-7));
שולח ספציפי
קוד הדוגמה הבא מראה כיצד למצוא הודעות משולח ספציפי.
// Get emails from specific sender
builder.From.Contains("saqib.razzaq@127.0.0.1");
דומיין ספציפי
קוד הדוגמה הבא מציג כיצד למצוא הודעות שנשלחו מדומיין ספציפי.
// Get emails from specific domain
builder.From.Contains("SpecificHost.com");
מקבל ספציפי
קוד הדוגמה הבא מראה כיצד למצוא הודעות שנשלחו למקבל ספציפי.
// Get emails sent to specific recipient
builder.To.Contains("recipient");
בניית שאילתות מורכבות
אם שונים MailQueryBuilder מאפיינים מוגדרים בהצהרות נפרדות, ואז כל התנאים יותאמו. לדוגמה, אם אנחנו רוצים לקבל הודעות בטווח תאריכים וממארח ספציפי, עלינו לכתוב שלוש הצהרות.
שילוב שאילתות עם AND
קוד הדוגמה הבא מציג כיצד לשלב שאילתות עם AND.
// Emails from specific host, get all emails that arrived before today and all emails that arrived since 7 days ago
builder.From.Contains("SpecificHost.com");
builder.InternalDate.Before(DateTime.Now);
builder.InternalDate.Since(DateTime.Now.AddDays(-7));
שילוב שאילתות עם OR
MailQueryBuilder מספקת את Or() מתודה שלוקחת שני MailQuery מופעים כפרמטרים. הוא משיג את ההודעות שעונות על אחת משתי התנאים המצוינים. קטע הקוד הבא מציג כיצד לסנן הודעות שיש להן את המילה “test” בכותרת או שהשולח שלהם הוא "noreply@host.com". קטע הקוד הבא מראה כיצד לשלב שאילתות עם OR.
// Specify OR condition
builder.Or(builder.Subject.Contains("test"), builder.From.Contains("noreply@host.com"));
מסננים רגישים לאותיות
ה-API גם מספק את היכולת לסנן הודעות דוא"ל מתיבת הדואר בהתבסס על קריטריון רגיש לרישיות. השיטות הבאות מאפשרות לחפש הודעות דוא"ל עם דגל רגיש לרישיות.
- Method Aspose.Email.StringComparisonField.Contains(string value, bool ignoreCase)
- Method Aspose.Email.StringComparisonField.Equals(string value, bool ignoreCase)
- Method Aspose.Email.StringComparisonField.NotContains(string value, bool ignoreCase)
- Method Aspose.Email.StringComparisonField.NotEquals(string value, bool ignoreCase)
// IgnoreCase is True
MailQueryBuilder builder1 = new MailQueryBuilder();
builder1.From.Contains("tesT", true);
MailQuery query1 = builder1.GetQuery();
Pop3MessageInfoCollection messageInfoCol1 = client.ListMessages(query1);