Documentation – עבודה עם לקוח POP3

Net: התחבר לשרת POP3

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

התחברות לשרת POP3

ה Pop3Client המחלקה מאפשרת ליישומים לנהל תיבות דוא"ל באמצעות פרוטוקול דואר אלקטרוני, גרסה 3 (POP3). מחלקה זו היא הכניסה העיקרית למפתחים הרוצים להוסיף ניהול POP3 ליישומי .NET שלהם.

להתחברות לשרת POP3:

צור מופע של Pop3Client מחלקה.
ציין את המארח, שם המשתמש והסיסמה ב‑ Pop3Client מופע.

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

התחברות לשרת SSL

התהליך להתחברות לשרת POP3 עם SSL דומה אך דורש להגדיר כמה מאפיינים נוספים:

SecurityOptions
פורט

כדי להתחבר לשרת POP3 עם SSL מופעל, הגדר את SecurityOptions ומאפייני Port. קטע הקוד הבא מראה כיצד להתחבר לשרת POP3 עם SSL מופעל.

התחברות לשרת APOP

POP הוא קיצור של Post Office Protocol. APOP הוא קיצור של Authenticated Post Office Protocol. APOP הוא גרסה מורחבת של הגדרות שרת POP3 המשמשת להצפנת שם המשתמש והסיסמה שלך ומשתמשת במנגנון אימות המיועד להגן על סיסמת חשבון POP3 שלך בעת בדיקת אימייל. אימות APOP אינו דורש שליחת סיסמת החשבון כטקסט גלוי לשרת הדואר POP3.

התחברות לשרת דרך Proxy

כתובות Proxy משמשות לקוחות דוא"ל כדי לגשת לתיבות דרך האינטרנט. Aspose.Email תומך בגרסאות 4, 4a ו‑5 של פרוטוקול SOCKS proxy.

לאחזור דוא"ל דרך שרת proxy:

אתחול פרוקסי עם המידע הנדרש, כלומר כתובת הפרוקסי, הפורט וגירסת SOCKS.
אתחול Pop3Client עם כתובת המארח, שם משתמש, סיסמה, וכל ההגדרות האחרות.
הגדר את מאפיין ה‑Proxy של הלקוח ל פרוקסי אובייקט שנוצר למעלה.

קוד הדוגמה הבא מראה כיצד לאחזר דוא"ל דרך שרת proxy.

התחברות לשרת דרך HTTP Proxy

התחברות עם אימות CRAM-MD5

באמצעות אימות CRAM-MD5, Aspose.Email for .NET מאפשר למשתמשים לבצע אימות בטוח ולגשת לשרתי דוא"ל התומכים בשיטה זו. קוד הדוגמה למטה מראה כיצד להשתמש במנגנון בפרויקט שלך:

popClient.AllowedAuthentication = Pop3KnownAuthenticationType.CramMD5;

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

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

קבלת הרחבות שרת

דוגמת הקוד הבאה מדגימה אחזור הרחבות שרת באמצעות POP3Client עבור שרת Gmail.

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

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

using (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.Timeout = 60000; // 60 seconds

    // some code...
}

השתמש בפרוטוקולים קריפטוגרפיים עם לקוח POP3

Aspose.Email תומך בפרוטוקולים הקריפטוגרפיים SSL (מיושן) ו‑TLS כדי לספק אבטחת תקשורת. ניתן להפעיל הצפנה קריפטוגרפית כדי להגן על חילופי נתונים בין היישום שלך לשרתי הדוא"ל.

הערה: יש להגדיר רק את גרסאות הפרוטוקול הנתמכות על ידי .NET Framework. אם גרסאות מסוימות של פרוטוקול קריפטוגרפי אינן נתמכות בגרסה הנוכחית שלך של .NET Framework, הן יתעלמו וידולגו. במקרה זה, לא ייווצרו שגיאות. אנא השתמש ב‑ SetSupportedEncryptionUnsafe השיטה אם ברצונך להגדיר את הפרוטוקולים ללא בדיקות תאימות.

דוגמת הקוד שלהלן מראה כיצד להגדיר TLS 1.3 עבור Pop3Client מופע של מחלקה.

using (Pop3Client pop3Client = new Pop3Client("host", 995, "username", "password", SecurityOptions.Auto))
{
    pop3Client.SupportedEncryption = EncryptionProtocols.Tls13;

    // some code...
}

במקרה שהפרוטוקול ההצפנה שהוגדר אינו נתמך בגרסה הנוכחית של .NET Framework, ההבדל בהתנהגות בין SetSupportedEncryptionUnsafe שיטה ו SupportedEncryption המאפיין הוא כדלקמן:

אם SupportedEncryption כאשר המאפיין משמש, לקוח הדוא"ל מוריד את פרוטוקול ההצפנה לרמה נתמכת.
אם SetSupportedEncryptionUnsafe כאשר השיטה משמשת, לקוח הדוא"ל זורק שגיאות.

Net: אימות פרטי כניסה של שרת POP3 ב-C#

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

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

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

using (Pop3Client client = new Pop3Client(server.Pop3Url, server.Pop3Port, "userName", "password", SecurityOptions.Auto))
{
    client.Timeout = 4000;
   
    if (client.ValidateCredentials())
    {
        //to do something
    }
}

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

Net: כיצד לאפשר רישום פעילות POP3 ב-.NET

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

הפעלת רישום פעילות בלקוח POP3

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

רישום פעילות משמש לניפוי באגים, וכן לאיסוף וניתוח מידע עובד על לקוח POP3.

הערה: אפשרות זו מועדפת ליישומי .NET Core.

כניסה Pop3Client ניתן להפעיל זאת בעזרת הצעדים ודוגמאות הקוד הבאים:

הוסף קובץ תצורת appsettings.json לפרויקט C#, אם הוא לא נוסף לפני כן.

ודא שקובץ הפרויקט מכיל את השורות הבאות במקטע ItemGroup.

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

לאחר מכן, הוסף את התוכן הבא לקובץ appsettings.json.

   {
     "Pop3DiagnosticLog": "Pop3.log",
     "Pop3DiagnosticLog_UseDate": true
   }

שתי המאפיינים שהוזכרו מעלה הם:

Pop3DiagnosticLog - מציין את הנתיב היחסי או המוחלט לקובץ הרישום.
Pop3DiagnosticLog_UseDate - מציין האם להוסיף ייצוג מחרוזת של התאריך הנוכחי לשם קובץ הרישום.

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

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

הערה: גם אם כבר הפעלת רישום באמצעות קובצי תצורה, אפשרות זו תיושם.

כניסה Pop3Client ניתן להפעיל זאת בעזרת הצעדים ודוגמאות הקוד הבאים:

צור Pop3Client.
הגדר את הנתיב לקובץ הרישום באמצעות LogFileName מאפיין.
הגדר את UseDateInLogFileName מאפיין אם זה נדרש.

   using (var client = new Pop3Client("your pop3 server", 995, "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.Pop3.log";

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

הפעלת רישום פעילות עם קובץ App.config

Pop3Client ניתן לרשום פעילות על ידי שינוי configSections בקובץ התצורה. להלן השלבים לביצוע רישום אבחון:

הוסף sectionGroup בשם "applicationSettings".
הוסף section בשם "Aspose.Email.Properties.Settings".
כלול את ההגדרה ImapDiagonosticLog שבה שם הקובץ מוגדר ב-applicationSettings/Aspose.Email.Properties.Settings.

הנה יישום טופס לדוגמה המשתמש ב- Pop3Client לעיבוד דואר. כל פעילות זו נרשמת על ידי שינוי קובץ App.config.

צור יישום מבוסס טופס עם כפתור יחיד. הוסף את קוד הדוגמה הבא ללחיצת הכפתור:

הוסף הפנייה ל-Aspose.Email.
כעת הוסף את קובץ App.Config ושנה אותו כך שתוכן הקובץ יהיה כדלקמן:

ב‑C# .NET השתמש באפשרות הבאה

|| | :- | עבור VB .NET השתמש באפשרות הבאה

הפעל את הקוד ולאחר מכן התבונן בתיקיית Log. הקובץ הבא יווצר.

Net: קבל ונהל הודעות משרת הדוא"ל

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

קבלת מידע על תיבת דואר

אנו יכולים לקבל מידע על תיבת הדואר כגון מספר ההודעות וגודל תיבת הדואר באמצעות ה- GetMailBoxSize ו GetMailBoxInfo מתודות של ה- Pop3Client מחלקה.

ה GetMailBoxSize המתודה מחזירה את גודל תיבת הדואר בתים.
ה GetMailBoxInfo המתודת מחזירה אובייקט מסוג Pop3MailBoxInfo.

ניתן גם לקבל את מספר ההודעות באמצעות ה- MessageCount מאפיין והגודל באמצעות ה- OccupiedSize מאפיין של Pop3MailBoxInfo מחלקה. קוד הדוגמה הבא מראה כיצד לקבל מידע על תיבת הדואר. הוא מציג כיצד:

צור Pop3Client.
התחבר לשרת POP3.
קבל את הגודל של תיבת הדואר.
קבל מידע על תיבת הדואר.
קבל את מספר ההודעות בתיבת הדואר.
קבל את הגודל הכבוש.

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

קוד הדוגמה הבא מראה כיצד לספור את הודעות הדוא"ל בתיבת הדואר.

Aspose.Email מאפשר למפתחים לעבוד עם הודעות דוא"ל במגוון דרכים. לדוגמה, הם יכולים לאחזר מידע כותרת לפני החלטה אם להוריד את ההודעה. או שהם יכולים לאחזר הודעות משרת ולשמור אותן ללא ניתוח (מהיר יותר) או אחרי ניתוח (איטי יותר).

אחזור כותרות דוא"ל

כותרות דוא"ל יכולות לספק לנו מידע על הודעת דוא"ל שעליו אנו יכולים להשתמש כדי להחליט האם לאחזר את כל ההודעה. בדרך כלל, מידע הכותרת כולל שולח, נושא, תאריך קבלה, וכו’. (כותרות דוא"ל מתוארות בפרוטרוט ב- התאמת כותרות דוא"ל. הדוגמאות הבאות מראות כיצד לאחזר כותרות דוא"ל משרת POP3 לפי מספר הרצף של ההודעה.

אחזור הודעות דוא"ל

ה MailMessage מחלקה מכילה כמה מאפיינים ומתודות למניפולציה על תוכן האימייל. באמצעות FetchMessage שיטה של Pop3Client מחלקה, אתה יכול לקבל MailMessage מופע ישירות מהשרת POP3. הקטע הקוד הבא מציג כיצד לשאוב הודעת אימייל מלאה מהשרת POP3.

אחזור תקציר הודעה עם מזהה ייחודי

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

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

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

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

הורדת הודעות מהשרת ושמירתן על דיסק

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

אם ברצונך להוריד הודעות דוא"ל משרת POP3 ללא פירושן, השתמש ב- Pop3Client מחלקה SaveMessage פונקציה. ה- SaveMessage פונקציה אינה מפענחת את הודעת האימייל ולכן היא מהירה יותר מה- FetchMessage פונקציה. קטע הקוד הבא מראה כיצד לשמור הודעה לפי מספר הרצף שלה. במקרה זה, ה SaveMessage מתודה שומרת את ההודעה בפורמט EML המקורי ללא פירוש.

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

קוד הדוגמה הבא משתמש ב- Pop3Client FetchMessage מתודה לאחזור הודעה משרת POP3 לפי מספר הסדרה שלה, ולאחר מכן לשמור את ההודעה לדיסק תוך שימוש בנושא כשם הקובץ.

הורדת הודעות קבוצתיות

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

Net: סינון מיילים משרת הדואר

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

סינון הודעות לפי שולח, נמען או תאריך

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

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

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

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

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

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

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

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

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

תאריך היום

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

טווח תאריכים

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

שולח ספציפי

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

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

קוד הדוגמה הבא מציג כיצד למצוא הודעות שנשלחו מדומיין ספציפי.

מקבל ספציפי

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

בניית שאילתות מורכבות

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

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

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

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

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

מסננים רגישים לאותיות

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

Net: מחיקת הודעות דוא"ל משרת POP3

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

מחיקת הודעות דוא"ל מהשרת

ה Pop3Client המחלקה משתמשת בפרוטוקול POP3 כדי להעתיק את הודעות הדוא"ל מתיבת הדואר למחשב שלך. לאחר שהדוא"ל נשלף, אינך צריך להיות מחובר לאינטרנט בזמן קריאתו, מכיוון שאתה יכול לקרוא את הדוא"ל שנשמר במחשב. אם אינך זקוק או אינו רוצה להחזיק עותק של הודעות מסוימות על שרת ה‑POP3, תמחוק אותן. סעיף זה מציג כיצד למחוק הודעות דוא"ל באמצעות Pop3Client מחלקה.

מחק אימייל לפי מזהה

הקטע הקוד הבא מוחק את כל הודעות הדואר בתיבת הדואר אחת אחרי השנייה, על בסיס האינדקס שלה. האינדקס לעולם אינו צריך להיות <=0 ב‑ Pop3Client.DeleteMessage.

מחק את כל האימיילים

אנו עשויים גם לקרוא ל‑ Pop3Client.DeleteMessages למחוק את כל ההודעות. הקטע הקוד שלהלן מציג כיצד למחוק את כל האימיילים.

// Delete all the messages
client.DeleteMessages();

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

ביטול מחיקת הודעות דוא"ל

Pop3Client.UndeleteMessages ניתן להשתמש בו לביטול מחיקת הודעות אימייל. הקטע הקוד הבא מציג כיצד לבטל מחיקות.

// Cancel deletes
client.UndeleteMessages();

Net: טיפול אסינכרוני בדוא"ל עם לקוח POP3

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

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

עבודה עם הודעות יכולה להתבצע גם אסינכרונית באמצעות Aspose.Email Pop3Client. מאמר זה מציג כיצד לשאוב הודעות מתיבת דואר בצורה אסינכרונית. הוא גם מציג כיצד לרשום הודעות על‑ידי אספקת קריטריוני חיפוש באמצעות MailQuery. יופיע בנפרד כיצד להפסיק פעולה עם תיבת דואר שהתחילה בתבנית אסינכרונית מבוססת משימה (TAP) שיטה.

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

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

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

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

הפסקת שיטת TAP

החל מ-.NET Framework 4.5, ניתן להשתמש במתודות אסינכרוניות המיושמות בהתאם למודל TAP. קטע הקוד שלהלן מציג כיצד לקבל מידע על תיבת דואר באמצעות שיטה מבוססת משימה בשם GetMailboxInfoAsync ואז להפריע לתהליך זה אחרי זמן מה.

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

using (Pop3Client client = new Pop3Client(host, 995, senderEmail, password, SecurityOptions.Auto))
{
    CancellationTokenSource cancellationTokenSource = new CancellationTokenSource();
    AutoResetEvent autoResetEvent = new AutoResetEvent(false);
    Exception exception = null;

    ThreadPool.QueueUserWorkItem(delegate
    {
        try
        {
            // start receiving mailbox information
            var task = client.GetMailboxInfoAsync(cancellationTokenSource.Token);
            Pop3MailboxInfo mailboxInfo = task.GetAwaiter().GetResult();
            Console.WriteLine("Message count: " + mailboxInfo.MessageCount);
        }
        catch (Exception e)
        {
            exception = e;
        }
        finally
        {
            autoResetEvent.Set();
        }
    });

    Thread.Sleep(2000);

    // stop receiving mailbox information
    cancellationTokenSource.Cancel();
    autoResetEvent.WaitOne();

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