Documentation – עבודה עם הודעות MIME באמצעות API של C++ Email Parser

Cpp: יצירת והתאמת הודעות דוא"ל באמצעות Aspose.Email עבור C++

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

Aspose.Email for C++ מספקת את MailMessage class ליצירה, התאמה ושמירה של הודעות דוא"ל בפורמטים שונים. מחלקה זו מאפשרת להגדיר מאפיינים חיוניים כגון שולח, נמענים, נושא וגוף, ותומכת בשמירת הודעות בפורמטים EML, MSG ו‑MHTML.

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

דוגמת הקוד הבאה מציגה כיצד ליצור ולהגדיר הודעת דוא"ל חדשה באמצעות Aspose.Email עבור C++.

צור מופע של MailMessage מחלקה.
הגדר מאפייני הודעה כגון From, To, Cc, Subject ו‑HtmlBody.
אופציונלי, שמור את ההודעה במספר פורמטים (EML, MSG, MHTML וכו’).

שימוש בשמות ידידותיים לכתובות אימייל

שם ידידותי עושה את כתובת האימייל קריאה יותר. לדוגמה, John Smith <jsmith@domain.com> במקום רק jsmith@domain.com.

ניתן לקשר שמות ידידותיים לכתובות בעת בניית הודעת דוא"ל באמצעות ה‑ MailMessage מחלקה.

דוגמת הקוד למטה מציגה כיצד להוסיף שמות ידידותיים:

צור מופע חדש של ה‑ MailMessage מחלקה.
הוסף To, Cc, ו- Bcc נמענים עם כתובת ושם ידידותי.

הגדרת תוכן גוף האימייל

ה MailMessage המחלקה מאפשרת להגדיר את גוף האימייל בפורמט HTML. ניתן גם לספק תצוגות חלופיות ללקוחות אימייל שונים באמצעות ה‑ AlternateView מחלקה.

הגדרת גוף HTML

דוגמת הקוד הבאה מציגה כיצד לקבוע את תוכן ה-HTML של הודעת האימייל על ידי הקצאת מחרוזת HTML ל‑ set_HtmlBody property. השימוש במחרוזת זו כתוכן הודעה מצביע על כך שהודעת האימייל תשלח עם עיצוב HTML במקום טקסט פשוט.

הגדרת טקסט חלופי

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

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

ה AlternateView המחלקה גם מנהלת משאבים המשמשים בגוף האימייל:

LinkedResources – אוסף של פריטים משובצים (כגון תמונות או קבצים מצורפים) שנקשרים על‑ידי קישורים בתוכן ההודעה.
set_BaseUri() – מגדיר את ה‑URL הבסיסי המשמש לפתרון קישורים יחסיים או נתיבי משאבים בגוף ההודעה.

Cpp: יצירת והגדרת תוכן הודעות דוא"ל ב‑C++ ושליחת דוא"ל באמצעות SmtpClient

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

צור הודעת דוא"ל חדשה

המחלקה MailMessage מייצגת הודעת אימייל ומאפשרת למפתחים ליצור הודעת אימייל חדשה. ניתן להציב בקלות תכונות אימייל בסיסיות כגון From, To, Subject וה‑body עם הודעת המייל החדשה. באותו אופן ניתן לשמור את הודעת המייל בפורמטים שונים כמו EML, MSG ו‑MHTML.

<a name="csharp-create-new-email-msg" id="csharp-create-new-email-msg">שלבים: יצירת הודעת דוא"ל חדשה ב‑C#

צור מופע של המחלקה MailMessage.
הגדר מאפייני הודעת דואר.
שמור הודעת דואר בתבניות שונות.
צור מופע של המחלקה SmtpClient ושלח את הדוא"ל באמצעות השיטה Send.

קטע הקוד הבא ב‑C++ מראה לך כיצד ליצור הודעת דוא"ל חדשה עם מאפיינים שונים.

החלפת כתובות דוא"ל לשם ידידותי

דוגמאות הקוד למטה מדגימות כיצד לשנות כתובות אימייל לשמות ידידותיים יותר בהודעת אימייל. שם ידידותי הוא שם שמזוהה בקלות יותר מאשר כתובת האימייל, לדוגמא John Smith במקום js346@domain.com. כאשר שולחים אימייל, ניתן לשייך שם ידידותי לכתובת האימייל באמצעות הקונסטרקטור של מחלקת MailMessage.

כדי להחליף כתובות דוא"ל לשמות ידידותיים בהודעת דוא"ל, פעל לפי הצעדים הבאים:

צור מופע של מחלקת MailMessage וציין כתובות דוא"ל בשדות To ו-From יחד עם שמות ידידותיים.
ציין את כתובות האימייל של Cc ו-Bcc יחד עם שמות ידידותיים על ידי קריאת הבונה של מחלקת MailMessage במופע MailMessage.
צור מופע של המחלקה SmtpClient ושלח את הדוא"ל באמצעות השיטה Send.

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

הגדר גוף הודעה

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

גוף HTML
גוף טקסט

בנוסף ל‑HtmlBody ו‑TextBody, Aspose.Email כוללת שתי תכונות קריאה‑ניתן בלבד נוספות הקשורות לגוף המייל:

IsBodyText: מודיע למשתמש האם הגוף הוא טקסט.
IsBodyHtml: מודיע למשתמש האם הגוף הוא HTML או טקסט רגיל.

מאמר זה מציג כיצד להגדיר טקסט רגיל או טקסט גוף HTML, להגדיר טקסט חלופי ולמקודד את גוף האימייל.

הגדרת גוף HTML

HtmlBody משמש לציון תוכן ה-HTML של גוף ההודעה. HtmlBody חייב להיות מוקף בתגי . קטע הקוד הבא מראה כיצד להגדיר גוף HTML.

הגדרת טקסט חלופי

השתמש במחלקת AlternateView כדי לציין עותקים של הודעת אימייל בפורמטים שונים. לדוגמה, אם אתה שולח הודעה ב‑HTML, ייתכן ותרצה לכלול גרסה בטקסט רגיל למקרה שהמקבלים משתמשים בתוכנות קריאת אימייל שאינן מציגות תוכן HTML. למחלקה זו שתי תכונות, LinkedResources ו‑BaseUri, המשמשות לפתרון כתובות URL בתוך תוכן האימייל.

LinkedResources הוא אוסף של אובייקטים מסוג LinkedResources. בעת רנדור, כתובות ה-URL בתוכן האימייל מתאימות תחילה לכתובות ה-URL בקישור התוכן של כל אובייקט LinkedResources באוסף, ונפתרות.
BaseUri משמש את קורא המייל לפתרון כתובות URL יחסיות בתוך הגוף, וכן לפתרון כתובות URL של קישורי תוכן יחסיים, באוסף LinkedResources.

קטע הקוד הבא ב‑C++ מראה לך כיצד להגדיר טקסט חלופי.

Cpp: קריאה והצגה של הודעות דוא"ל וכותרות ב‑C++

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

Aspose.Email for C++ מספקת את MailMessage class, המייצגת הודעת דוא"ל ומאפשרת למפתחים לגשת ולהציג את תוכנה וכותרותיה. ניתן בקלות לחלץ מידע כגון שולח, נמענים, נושא, גוף וכותרות מקובץ דוא"ל קיים (EML).

הצגת מידע דוא"ל

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

צור מופע של MailMessage מחלקה.
טען הודעת אימייל לתוך ה MailMessage מופע.
הצג את המאפיינים הרצויים (לדוגמה, From, To, Subject ו‑Body) במסוף.

הערה: לקבלת דוגמאות מלאות וקבצי נתונים, בקר ב‑ מאגר GitHub של Aspose.Email עבור C++.

חילוץ כותרות דוא"ל

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

Aspose.Email עבור C++ מאפשרת לך לחלץ ולעבוד עם כותרות אלו באמצעות ה‑ MailMessage מחלקה.

סוגי הכותרות הנפוצים ביותר זמינים דרך ה‑ HeaderType class, המספקת קבועים בשם לשדות כותרת סטנדרטיים.

קטע הקוד הבא מציג כיצד לחלץ כותרות דוא"ל:

צור מופע של MailMessage מחלקה.
טען קובץ דוא"ל לתוך המופע.
קבל את אוסף הכותרות באמצעות ה‑ get_Headers() שיטה.
עבור על האוסף כדי לקרוא או להציג שמות והערכי כותרות.

קבלת ערכי כותרת מפוענחים

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

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

Cpp: טעינה ושמירה של הודעות אימייל באמצעות Aspose.Email ל‑C++

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

Aspose.Email ל‑C++ מציע אפשרויות גמישות לטעון, לשמור ולהמיר הודעות אימייל במגוון פורמטים, כולל EML, MSG, MHTML, ו‑HTML. ניתן גם להתאים את אפשרויות הטעינה והשמירה כדי להתמודד עם קידוד, קבצים מצורפים ודרישות עיצוב.

טעינת הודעה עם אפשרויות טעינה מותאמות

ה MailMessage המחלקה יכולה לטעון הודעות ממגוון פורמטים כגון EML, MSG, MHTML, ו‑HTML באמצעות אפשרויות טעינה מיוחדות. אפשרויות אלו מאפשרות למפתחים לציין העדפות קידוד, לשמר קבצים מצורפים ולנהל משאבים משובצים.

הדוגמה הבאה ב‑C++ מציגה כיצד לטעון הודעות אימייל באמצעות אפשרויות טעינה שונות.

שמירת הודעות אימייל בפורמטים שונים

Aspose.Email ל‑C++ מאפשר המרה של הודעות בין פורמטים כגון EML, MSG, MHTML, ו‑HTML. מפתחים יכולים להשתמש ב‑ SaveOptions היררכיית המחלקות לציון פרמטרים מתקדמים של שמירה, כולל קידוד, קבצים מצורפים בפורמט TNEF, ושמירת גבולות.

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

EmlSaveOptions
MsgSaveOptions
MhtSaveOptions
HtmlSaveOptions

שמירת אימייל כ‑EML

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

שימור גבולות ה‑EML המקוריים

ניתן לשמר את גבולות ה‑MIME המקוריים בעת שמירת קובץ EML.

שימור קבצים מצורפים בפורמט TNEF ב‑EML

דוגמת הקוד הבאה מציגה כיצד לשמור אימייל תוך שמירה על קבצים מצורפים בפורמט TNEF (Transport Neutral Encapsulation Format).

Convert EML to MSG

בקלות ניתן להמיר קובץ EML לפורמט Outlook MSG. קטע הקוד הבא מדגים כיצד לטעון הודעת EML ולהמיר אותה ל‑MSG באמצעות האפשרות המתאימה מ‑ SaveOptions מחלקה.

שמירה כ‑MHTML

הדוגמה הבאה מציגה כיצד לטעון הודעת EML ולשמור אותה כקובץ MHTML.

ייצוא ל‑MHT עם אזור זמן מותאם

ניתן להגדיר אזור זמן מותאם או מערכת לשדות תאריך ההודעה לפני ייצוא לפורמט MHT. ה‑ MailMessage class מספקת את TimeZoneOffset property לקביעת אזור זמן מותאם. קטע הקוד הבא מציג כיצד לייצא אימייל ל‑MHT עם אזור זמן מותאם.

ייצוא אימייל ל‑EML

הדוגמה הבאה מציגה כיצד לייצא אימייל לפורמט EML:

Cpp: עבודה עם מצורפים ואובייקטים מוטמעים באמצעות API של C++

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

עבודה עם מצורפים

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

ב‑Aspose.Email עבור C++, מצורפים מנוהלים דרך ה‑ Attachment class, הפועל יחד עם ה‑ MailMessage class. ניתן להוסיף, להסיר, לחלץ או להציג מצורפים בצורה תכנותית.

הערה: גודל הקובץ המצורף המרבי תלוי בשרת הדואר (לדוגמה, Gmail מגביל מצורפים ל‑10 מ״ב).

נסו זאת!

הוספה או הסרה של קבצים מצורפים של דוא"ל באמצעות החינמי Aspose.Email Editor App.

הוספת מצורפים להודעת דוא"ל

כדי לצרף קובץ אחד או יותר להודעת דוא"ל, פעל לפי הצעדים למטה:

צור מופע של MailMessage מחלקה.
Create Attachment objects עבור כל קובץ.
הוסף את המצורפים להודעה באמצעות AddAttachment().
שמור את ההודעה במידת הצורך.

דוגמת קוד

הסרת מצורפים מהודעת דוא"ל

ניתן להסיר בקלות מצורפים מהודעה באמצעות ה‑ Remove() שיטה של קבצים מצורפים אוסף.

קטע הקוד הבא מציג כיצד להסיר מצורף:

טען או צור a MailMessage מופע.
הוסף קובץ אחד או יותר.
הסר את המצורף הרצוי.
אופציונלי, הצג את המצורפים הנותרים.

הצגת שמות קבצי מצורף

ניתן לעבור על כל המצורפים ולהציג את שמותיהם במסוף:

חילוץ מצורפים מדוא"ל

כדי לחלץ ולשמור מצורפים מקובץ דוא"ל קיים, פעל לפי הצעדים למטה:

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

קטע הקוד הבא מציג כיצד לחלץ מצורפי דוא"ל:

|קבצים מצורפים שחולצו בדוא"ל| | :- | ||

קריאת תיאור תוכן מצורף

Aspose.Email מאפשרת לקרוא את כותרת Content-Description של מצורף לקבלת מטא‑דטא נוספים.

דוגמת קוד

עבודה עם אובייקטים משובצים

אובייקט מוטמע הוא קובץ שנוצר באפליקציה אחת ומוקף בתוך מסמך או הודעת דוא"ל אחרת. לדוגמה, גיליון Excel של Microsoft ניתן לשבץ בתוך מסמך Word, או תמונה יכולה להיות משובצת ישירות בגוף הדוא"ל.

כאשר אובייקט מוטמע (לא רק מצורף או מקושר), הוא שומר על הפורמט המקורי שלו וניתן לפתוחו או לערוך אותו באפליקציה המקורית שלו.

שיבוץ אובייקטים בדוא"ל

כדי לשבץ תמונה או אובייקט אחר בהודעת דוא"ל, השתמש ב‑ LinkedResource class יחד עם ה‑ MailMessage ו AlternateView classes. זה מאפשר לכלול תמונות או תוכן מדיה משולב המופיעים ישירות בגוף ההודעה.

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

צור מופע של MailMessage מחלקה.
הגדר את שדות השולח, הנמען והנושא.
צור גוף טקסט פשוט באמצעות AlternateView.
צור גוף HTML המכיל הפנייה לאובייקט המוטמע באמצעות ה‑ cid (Content-ID).
צור מופע של LinkedResource class וטען את האובייקט.
הקצה Content-ID למשאב המקושר.
הוסף את המשאב המקושר ואת תצוגות החלופיות להודעה.
שמור או שלח את הודעת הדוא"ל.

הערה: > ניתן לשבץ מספר אובייקטים, אך הגודל המרבי של ההודעה מוגבל על‑ידי שרת הדואר שלך. לדוגמה, Gmail מגביל את גודל ההודעה ל‑10 מ״ב.

חילוץ אובייקטים מוטמעים מדוא"ל

ניתן גם לחלץ אובייקטים מוטמעים, כגון תמונות או קבצים, מהודעת דוא"ל קיימת. תהליך זה דומה לחילוץ מצורפים:

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

|עצמים משובצים שחולצו במייל| | :- | ||

Cpp: תכונות שירות - MailMessage

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

הודעות אימייל המכילות קבצים מצורפים ב‑TNEF

Transport Neutral Encapsulation Format (TNEF) הוא פורמט קובץ מצורף קבוע בבעלות Microsoft Outlook ו- Microsoft Exchange Server. ממשק Aspose.Email API מאפשר לקרוא הודעות דוא"ל עם קבצים מצורפים בפורמט TNEF ולשנות את תוכן הקובץ המצורף. ניתן לשמור את ההודעה כדוא"ל רגיל או באותו פורמט, תוך שמירת קבצים מצורפים בפורמט TNEF. מאמר זה מציג דוגמאות קוד שונות לעבודה עם הודעות המכילות קבצים מצורפים בפורמט TNEF. הוא מציג גם עבודה עם יצירת קבצי TNEF EML מקבצי Outlook MSG.

קריאת הודעה תוך שמירת קבצים מצורפים בפורמט TNEF

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

בדיקת הודעות חוזרות

זה נפוץ מאוד שהודעה שנשלחה לנמען תחזור (bounce) מסיבה כלשהי כגון כתובת נמען לא חוקית. ל‑Aspose.Email API יש יכולת לעבד הודעה כזו כדי לבדוק אם מדובר באימייל חוזר או בהודעה רגילה. המתודה CheckBounced של MailMessage מחזירה תוצאה תקפה אם הודעת האימייל חזרה. מאמר זה מציג את השימוש במחלקת BounceResult המספקת אפשרות לבדוק אם הודעה היא אימייל חוזר. בנוסף, הוא מספק מידע מפורט על הנמענים, הפעולה שננקטה והסיבה להודעה. קטע הקוד הבא מראה כיצד לעבד הודעות חוזרות.

Cpp: עבודה עם קבצי מצורף TNEF ב‑Aspose.Email עבור C++

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

Transport Neutral Encapsulation Format (TNEF) הוא פורמט קבצים מצורפים קנייני שנמצא בשימוש ב‑Microsoft Outlook וב‑Exchange Server. מצורפים אלו כוללים לעיתים נתוני הודעה עשירים כגון טקסט מעוצב, תמונות מוטמעות או בקשות פגישות.

Aspose.Email עבור C++ מספקת תמיכה מלאה בקריאת ושמירת מצורפי TNEF בעת טעינת הודעות דוא"ל. ניתן לגשת ולשנות את תוכן מצורפי TNEF ואז לשמור את ההודעה בפורמט המקורי או בפורמט שונה תוך שמירה על כל הנתונים המוטמעים.

קריאת הודעות דוא"ל תוך שמירה על מצורפי TNEF

כדי לטעון הודעת דוא"ל ולשמור את מצורפי TNEF שלה, השתמש ב‑ MsgLoadOptions מחלקה והגדר את PreserveTnefAttachments מאפיין ל true.

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

Cpp: זיהוי ועיבוד אימיילים חוזרים באמצעות Aspose.Email ל‑C++

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

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

Aspose.Email ל‑C++ מציע דרך נוחה לזהות ולנתח הודעות חוזרות באמצעות ה‑ MailMessage ו BounceResult מחלקות. ה‑ MailMessage::CheckBounced() מתודה שקובעת האם הודעה היא חזרה ומחזירה BounceResult אובייקט המכיל מידע מפורט כגון:

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

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

דוגמת הקוד הבאה מציגה כיצד לבדוק אם הודעת אימייל חזרה (bounced) ולשלוף מידע מפורט עליה: