יצירה והגדרת תוכן של אימיילים

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

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

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

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

ציון נמענים מרובים

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

• To - ניתן לציין כתובות נמען בשדה ‘To’. נמעני שדה ‘To’ הם קהל היעד הראשי של ההודעה. ניתן לציין יותר מכתובת נמען אחת.
• Cc - CC מרמז על "Carbon Copy" או "Courtesy Copy", ומאפשר לך להוסיף נמעני דוא"ל שצריכים לראות את ההודעה אך אינם נדרשים לפעול על פיה. לדוגמה מנהלים או חברי צוות שצריכים להיות מודעים לשיחה. ב- Aspose.Email ניתן לציין כתובות CC בקוד שלך, כך שהודעות אוטומטיות, או כל הודעה לכתובת מסוימת, יועתקו לצוות רלוונטי.
• Bcc - Bcc, Blind Carbon Copy, מאפשר לך לשלוח דוא"ל לנמען המוסתר משאר הנמענים. בעוד ש-CC מופיע במידע של הדוא"ל שהנמענים הראשיים רואים, Bcc אינו נראה. הוא נועד להודעות מוסתרות. 

כדי לציין מספר כתובות דוא"ל בהודעה, פעל לפי הצעדים הבאים:

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

דוגמת הקוד למטה מציגה כיצד ניתן לציין מספר כתובות To, CC ו-BCC.

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

דוגמאות הקוד למטה מדגימות כיצד לשנות כתובות אימייל לשמות ידידותיים יותר בהודעת אימייל. שם ידידותי הוא שם שמזוהה בקלות יותר מאשר כתובת האימייל, לדוגמא John Smith במקום [e-mail]. כאשר שולחים אימייל, ניתן לשייך שם ידידותי לכתובת האימייל באמצעות הקונסטרקטור של מחלקת 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.

קטע הקוד הבא מראה איך להגדיר טקסט חלופי.

תכונות MailMessage

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

• Date and time - באמצעות MailMessage תכונת class Date משמשת לקבלת או הגדרת התאריך והשעה של אימייל.
• עדיפות הודעה - ה- MailPriority מחלקה המגדירה רמות עדיפות לשליחת הודעת דוא"ל. היא יכולה להיות נמוכה, רגילה או גבוהה. העדיפות משפיעה על מהירות השידור והמסירה.
• רגישות הודעה - ה- MailSensitivity מחלקה המגדירה חמש רמות של רגישות.
• הודעת מסירה - הודעות מסירה מודיעות לשולחים שהאימייל שהם שלחו נמסר לתיבת הדואר של הנמען.

בברירת מחדל, התאריך הוא התאריך האמיתי שבו נשלח ההודעה, והזמן הוא הזמן שבו נשלחה, כפי שמוצג ב-Microsoft Outlook. אולם זמן המשלוח האמיתי של האימייל מתווסף על ידי שרת ה-SMTP עצמו בכותרת המייל. לדוגמה, להלן כותרת מייל נפוצה, שבה Date מגדיר את השדה Date.

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

בקשת קבלה של קריאה

דוגמאות הקוד למטה מראות כיצד ניתן לבקש קבלה של קריאת הודעה. The MailMessage מחלקה DeliveryNotificationOptions תכונת Enumeration מתארת את אפשרויות הודעת המשלוח עבור אימייל. כדי לבקש קבלה של קריאת הודעה לאחר שליחת אימייל, עקוב אחרי הצעדים הבאים:

1. צור מופע של MailMessage מחלקה.
2. ציין את השולח, המקבל וגוף HTML עבור האימייל ב- MailMessage מופע.
3. ציין את DeliveryNotificationOptions באחרים MailMessage מופעים.
4. צור מופע של SmtpClient מחלקה ושלח את האימייל באמצעות שיטת Send.

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

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

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

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

כותרות אימייל מייצגות סטנדרט אינטרנט ו-RFC מגדיר שדות כותרת שנכללים באימיילים באינטרנט. ניתן לציין כותרת אימייל באמצעות מחלקת MailMessage. סוגי כותרות נפוצים מוגדרים במחלקת HeaderType. זו מחלקה sealed הפועלת כמו מונה רגיל.

בדרך כלל כותרת מייל מכילה את השדות הבאים:

• To: ניתן לציין כתובות נמען בשדה To. נמען בשדה To הוא הקהל הראשי של ההודעה. ניתן לציין יותר מכתובת אחת.
• From: שדה זה מציג את כתובת האימייל של שולח ההודעה.
• Cc: מאפשר למשתמשים לשלוח הודעה כ„Carbon Copy“ או „Courtesy Copy“. כלומר, לא מצופה שהמקבל יגיב או יפעל. בדרך כלל, צוות פיקוח מודיע באמצעות CC.
• Bcc: משמעותו Blind Carbon Copy, מתייחס לשיטת שליחת הודעה למספר נמענים כך שההודעה שהם מקבלים אינה כוללת את רשימת כל הנמענים. זה מיועד להודעה סמויה.
• ReplyTo: שדה כותרת זה נועד לציין לאן השולח רוצה שהתגובות ילכו.
• Subject: כותרת, נושא. משמש לעיתים כסמן נושא לשרשרות הודעות שמגיבות או מגיבות להודעות אחרות.
• Date: כותרת זו מציינת תאריך (וזמן). בדרך כלל זהו התאריך שבו ההודעה נכתבה ונשלחה.
• XMailer: מידע על תוכנת הלקוח של השולח. לדוגמה: X-Mailer: Aspose.Email. XMailer משמש על ידי לקוחות דוא"ל. לקוחות דוא"ל שונים יהיו בעלי ערכי XMailer שונים. ערך ה‑XMailer של MS Outlook הוא Microsoft Office Outlook, Build 11.0.5510. הוא מתעלם ממנו על ידי מקבל הדוא"ל או קורא הדוא"ל.

בדרך כלל, כותרת מייל נראית כך:

 Reply-To: [e-mail]

From: [e-mail]

To: [e-mail]

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

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

• צור מופע של MailMessage מחלקה.
• ציין את השדות To, From, CC, Bcc, ReplyTo, Subject, Date ו-XMailer באמצעות מופע של ה- MailMessage.
• צור מופע של MimeHeader מחלקה וציין כותרת סודית.
• הוסף את הכותרת הסודית ל- MailMessage מופע.

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

קטע הקוד למעלה מייצר כותרת אימייל בפורמט הבא. ניתן לראות זאת על ידי פתיחת הקובץ שנוצר "MsgHeaders.msg" ב-Microsoft Outlook ואז צפייה בתכונות.

 Reply-To: [e-mail]

From: [e-mail]

To: [e-mail]

CC: [e-mail]

BCC: [e-mail]

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

הכנסת כותרת במיקום ספציפי

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

הוספת כותרות מותאמות אישית למייל

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

1. צור מופע של MailMessage מחלקה.
2. ציין ערכי to, from ו‑subject באמצעות מופע של MailMessage.
3. הוסף את הכותרת הסודית אל MailMessage מופע.
4. צור מופע של המחלקה SmtpClient ושלח את הדוא"ל באמצעות השיטה Send.

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