Documentation – מאמרים טכניים

Net: למה Aspose.Email

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

Net: השוואה בין Aspose.Email.Mail ל‑APIs של מיקרוסופט

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

השוואה של Aspose Email Mail ל‑APIs של מיקרוסופט

System.Web.Mail הוא פשוט עטיפה סביב שתי ספריות COM: CDONTS.NewMail (ב‑cdonts.dll) ו‑CDO.Message (ב‑cdosys.dll). עליך גם להתקין אותן על השרת. באופן ברירת‑המחדל, cdonts.dll ו‑cdosys.dll מותקנות עם Windows NT/2000/XP/2003.

פרטיו של SmtpMail

אם תתחקה לתוך המחלקה System.Web.Mail.SmtpMail, תמצא כמה התנהגויות מוזרות:

תומך רק במערכות הפעלה Win32NT, לדוגמה Windows 2000, Windows 2003, Windows XP.
כאשר מחלקת SmtpMail שולחת הודעת דוא"ל, היא בודקת את גרסת מערכת ההפעלה. אם הגרסה ≤ 4, משתמשים באובייקט CDONTS.Newmail; עבור כל מערכת הפעלה גדולה מ‑4, משתמשים באובייקט CDO.Message.

מוזגרויות אלו מקשות משמעותית על פתרון בעיות, במיוחד כאשר מעבירים קוד למערכות הפעלה שונות. היישום עשוי לקבל תוצאות בלתי צפויות במערכות הפעלה שונות. Aspose.Email.Mail הוא רכיב .NET שנכתב בקוד מנוהל מלא ב‑C# טהור. אינו תלוי בשום ספריית COM, כולל CDONTS.NewMail או CDO.Message. עם Aspose.Email.Mail אתה נמנע מכינון קוד בלתי מנוהל ביישומים שלך, מה שמעלה את אמינותם ומשחרר אותך מדיבאַגינג מייגע של COM. Aspose.Email.Mail עשיר בתכונות ומספק שירותים רבים יותר מאלו של System.Web.Mail. System.Net.Mail הוא מימוש לקוח פרוטוקול SMTP ב‑.NET 2.0. הוא גם מימוש בקוד מנוהל טהור ב‑C#.

מטריצת השוואה

תכונות	Aspose.Email.Mail	System.Web.Mail	System.Net.Mail
תכונות תאימות
תומך ב‑.NET 2.0	X	X	X
תכונות משותפות
תלות ב‑CDO/CDONTS		X
קוד מנוהל טהור	X		X
אימות	X	X	X
כתובת השולח	X	X	X
כתובת הנמענים	X	X	X
גוף HTML	X	X	X
גוף טקסט	X	X	X
Bcc/Cc	X	X	X
שליחת קובץ מצורף	X	X	X
תמונה מקושרת	X		X
קידוד גוף (Unicode/ASCII)	X	X	X
קידוד נושא (Unicode/ASCII)	X		X
מודל תכנות סינכרוני	X		X
מודל תכנות אסינכרוני	X		X
תכונות ייחודיות
כותרת דוא"ל מותאמת	X
כותרת חשיבות	X
כותרת רגישות	X
כותרת X‑Mailer	X
Reply‑To	X
תאריך שליחה	X
מיזוג דוא"ל מבוסס תבנית	X
מיזוג דוא"ל מ‑DataSet	X
מיזוג דוא"ל מ‑DataTable	X
מיזוג דוא"ל מ‑DataReader	X
שליחה בכמויות עם ריבוי תהליכים	X
שליחת יומן	X
שליחת בקשת פגישה	X
טעינה ממבנה Microsoft Msg	X
טעינה ממבנה Microsoft Mht	X
שמירה למבנה Microsoft Mht	X
שמירה למבנה Eml	X
טעינה ממבנה Eml	X
טעינה מקובץ תואם RFC 822	X
תכונות אינטראופרציה
תמיכה ב‑Aspose.Email.Pop3	X
תמיכה ב‑Aspose.Email.Imap	X
תמיכה ב‑Aspose.Email.Mime	X

Net: ההבדל בין POP3 ל‑IMAP

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

ההבדל בין POP3 ל‑IMAP

להלן הסבר על ההבדל הכללי בין פרוטוקולי הדוא"ל IMAP ו‑POP3.

POP3 ו‑IMAP

POP3 ו‑IMAP הם שני פרוטוקולי דוא"ל שפועלים עם רוב לקוחות הדוא"ל המודרנים. ההבדל המרכזי ביניהם הוא באופן ניהול ואחסון ההודעות.

POP3

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

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

חשבון IMAP

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

להשאיר דוא"ל בשרת מול להסיר דוא"ל מהשרת

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

למה לבחור ב‑IMAP במקום ב‑POP3 ולהשאיר דוא"ל בשרת? ב‑POP3 רק הודעות הדוא"ל שלך נמצאות בשרת, אך ב‑IMAP גם תיקיות הדוא"ל שלך נמצאות בשרת.

Net: גישה ל‑Gmail ב‑SSL

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

SMTP

מאמר זה מציג כיצד לבצע התחברות לשרת Gmail ו שליחת דוא"ל באמצעות פרוטוקול SMTP על גבי SSL.

התחברות לשרת SMTP של Gmail

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

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

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

IMAP

מאמר זה מציג כיצד לבצע מספר פעולות על שרת דוא"ל עם SSL באמצעות פרוטוקול IMAP:

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

התחברות לשרת הדוא"ל

השתמש ב‑Aspos.Email’s ImapClient אובייקט מחלקה להתחברות לשרת הדוא"ל. נדרש לציין את כתובת השרת, הפורט, שם המשתמש והסיסמה כדי ליצור חיבור. Gmail משתמש בפורט 993 לפרוטוקול IMAP, וקטע הקוד שלהלן מציג כיצד להתחבר ל‑Gmail דרך פורט זה.

בחירת תיקייה וקבלת סך כל ההודעות

בדיקת תיקיית Inbox היא המשימה השכיחה ביותר בעת בדיקת דוא"ל. בעזרת Aspose.Email אפשר לבצע זאת בשתי שורות קוד פשוטות בלבד. קטע הקוד שלהלן מראה כיצד לגשת לתיקיית Inbox ולקבל את סך כל ההודעות בתיקייה.

שמירת הודעות בכונן הקשיח המקומי

לאחר בחירת תיקייה עם המתודה SelectFolder, השתמש במתודת ListMessages כדי לקבל רשימה של כל ההודעות בתיקייה כאובייקט ImapMessagesInfoCollection. עבור על האוסף ושמור את הודעות הדוא"ל לכונן המקומי כך:

יצירת תיקייה חדשה

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

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

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

POP3

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

דגימות הקוד שלהלן מציגות כיצד:

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

התחברות לשרת דוא"ל

התחבר לשרת דוא"ל עם SSL בעזרת Pop3client מחלקה כפי שמפורט למטה.

בדיקת מצב תיבת הדואר

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

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

דוגמה זו בודקת את כל ההודעות בתיבת הדואר באמצעות Pop3MessageInfoCollection מחלקה. השתמש ב- Pop3Client.ListMessages() פונקציה לקבלת ה- Pop3MessageInfoCollection אוסף. לאחר מכן עבור על האוסף כדי לקרוא את המידע על ההודעה: מזהה ההודעה, אינדקס, נושא וגודל

קבלת הודעות

כדי לקבל את ההודעות מתיבת הדואר, השתמש ב- Pop3Client מתודת FetchMessage() של המחלקה לקבלת ההודעה אל MailMessage אובייקט מסוג. קטע הקוד הבא מראה כיצד לספור את מספר ההודעות בתיבת הדואר ולאחר מכן לעבור ביניהן כדי לאחזר כל אחת.

Net: היכרות עם תבניות חזרה

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

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

כל יום שישי השני, למעט מחודשים יוני עד אוגוסט.
הראשון של כל חודש, למעט ינואר, שבו זה צריך להיות ב‑2.

תבניות חזרה הן לרוב מחזוריות, אך הן אינן חייבות להיות כך. ניתן לתאר תבנית חזרה באופן מלא כקבוצה של תאריכים ושעות של אירועים מוגדרים מראש. ה‑RFC של iCalendar מגדיר components, כגון VEVENT או VTODO המייצגים אירועים או משימות. לרכיבים יכולים להיות מאפיינים כגון זמן תחילת אירוע, תיאור, מיקום, משתתפים וחזרה. לכן, תבנית חזרה קיימת בדרך כלל כמאפיין של משימה חוזרת או של אירוע. מאפייני תבנית חזרה המוגדרים על ידי iCalendar הם:

DTSTART - תאריך ושעת ההתחלה של התבנית (כמו כן מייצג את האירוע הראשון אם לא הוצא במפורש).
RRULE - מציין כלל חזרה עבור קבוצת חזרה.
RDATE - מגדיר רשימת תאריכים ושעות שייכללו בקבוצת חזרה.
EXRULE - מציין כלל חזרה עבור חריגים מתוך קבוצת חזרה.
EXDATE - מגדיר רשימת תאריכים ושעות של חריגים מתוך קבוצת חזרה.

רק DTSTART נדרש ויש צורך ב‑DTSTART אחד בלבד. כל שאר המאפיינים הם אופציונליים וניתן לציין אותם יותר מפעם אחת. Aspose.iCalendar מקבל מחרוזת בפורמט iCalendar וקורא את תבנית החזרה אל RecurrencePattern אובייקט. המחרוזת יכולה להיות תיאור מלא של רכיב iCalendar (למשל, VEVENT מלא) או רק קטע שמכיל רק את תבנית החזרה. לאחר טעינת תבנית החזרה לאובייקט RecurrencePattern, ניתן:

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

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

הסתכל על ה‑ תבניות חזרה לדוגמה להדגמות כיצד ליצור תבניות חזרה.

About Aspose.iCalendar Object Model

המרחב השמות Aspose.iCalendar מכיל את כל המחלקות המסופקות על ידי רכיב Aspose.iCalendar. RecurrencePattern ו‑RecurrenceRule הן המחלקות המרכזיות של Aspose.iCalendar, ומספקות מימושים קונקרטיים של ה‑elements המתאימים בתקן RFC 2445.

המחלקה RecurrencePattern מייצגת את כל תבנית החזרה. ניתן ליצור תבנית חזרה חדשה מאפס באמצעות הבנאי ברירת המחדל או לטעון תבנית קיימת בפורמט iCalendar באמצעות המתודה הסטטית FromiCalendar. המחלקה RecurrenceRule מייצגת את חלק ה‑RRULE או EXRULE של תבנית חזרה. RecurrenceRule מציגה מספר מאפיינים המתאימים במדויק למקבילים שלהם בתקן iCalendar. לדוגמה, ByMonth מומר ל‑BYMONTH ב‑iCalendar וכן הלאה. על‑ידי בחינה או שינוי של ערכי המאפיינים של RecurrenceRule ניתן לנתח או לשנות כלל חזרה. לקבלת מידע נוסף ודוגמאות קוד, ראו RecurrencePattern ו‑RecurrenceRule באינדקס ה‑API.

Sample Patterns

מקטע זה כולל את הנושאים הבאים:

היום האחרון של החודש.
יום העבודה האחרון של כל חודש.
יום שני האחרון של השנה.
יום שישי של השבוע הראשון לפי תקן ISO 8601 של השנה.
יום שישי הראשון של השנה.

The Last Day of The Month

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

RRULE:FREQ=MONTHLY;BYMONTHDAY=-1

באופן דומה, אם ברצונך ליצור הופעה ביום שלפני היום האחרון של החודש, השתמש ב‑BYMONTHDAY=-2. אם תציין BYMONTHDAY=31, אז לפי תקן iCalendar, לא ייווצרו הופעות בחודשים שיש בהם פחות מ‑31 יום.

The Last Workday of Every Month

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

RRULE:FREQ=MONTHLY;BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-1

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

The Last Monday of The Year

דוגמה זו תבנית חזרה מציין אירוע המתרחש ביום שני האחרון של השנה.

RRULE:FREQ=YEARLY;BYDAY=-1MO

Friday of the First ISO 8601 Week of the Year

דוגמה זו תבנית חזרה מציין את יום שישי של השבוע הראשון של השנה. במפרט ISO 8601, השבוע הראשון של השנה הוא השבוע המורכב ממינימום ארבעה ימים. כאשר השנה מתחילה ביום שבת, לדוגמה, השבוע הראשון הוא השבוע הבא מיד, המתחיל ביום שני, 3 בינואר.

FREQ=YEARLY;BYWEEKNO=1;BYDAY=FR

First Friday of the Year

דוגמה זו תבנית חזרה מציין אירוע המתרחש ביום שישי הראשון של השנה.

FREQ=YEARLY;BYDAY=1FR

בשנת 1999, לדוגמה, יום שישי הראשון של השנה הוא 1999/01/01, בעוד שיום שישי של השבוע הראשון לפי תקן ISO 8601 הוא 1999/01/08.

Net: פרטים חשובים של iCalendar RFC 2445

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

About Aspose.iCalendar Object Model

ה Aspose.iCalendar המרחב השמות מכיל את כל המחלקות המסופקות על ידי רכיב Aspose.iCalendar. RecurrencePattern ו‑RecurrenceRule הן המחלקות המרכזיות של Aspose.iCalendar, ומספקות מימושים קונקרטיים של ה‑elements המתאימים בתקן RFC 2445.

פרטים חשובים של iCalendar RFC 2445

מקטע זה כולל את הנושאים הבאים:

תבניות תאריך וזמן.
DATE.
DATE‑TIME עם זמן מקומי.
DATE‑TIME עם זמן UTC.
DATE‑TIME עם זמן מקומי ואזור זמן.
BYWEEKNO מספק התאמה ל‑ISO 8601

תבניות תאריך וזמן

תאריכים, או תאריכים עם זמנים משוייכים, ניתן להשתמש בהם ברכיבי DTSTART, UNTIL, EXDATE ו‑RDATE בעת הצגת תבנית חזרתיות. iCalendar מגדיר את סוג הערך DATE לזיהוי ערכים המורכבים מתאריך לוח שנה וכן מגדיר את סוג הערך DATE‑TIME לזיהוי ערכים המצביעים על תאריך לוח שנה מדויק וזמן ביום. ערכי DATE‑TIME יכולים להיות מפורטים בשלוש צורות, עם:

זמן מקומי.
זמן UTC.
זמן מקומי ואזור זמן.

DATE

לפי תקן iCalendar, ערכי DATE חייבים להיות בפורמט yyyyMMdd. הדוגמה הבאה מייצגת 14 ביולי 1997: 19970714

DATE‑TIME עם זמן מקומי

התאריך בצורת זמן מקומי הוא פשוט ערך תאריך‑זמן שאינו מכיל את מעצב ה‑UTC, ואינו מתייחס לאזור זמן. לדוגמה, הבא מייצג 18 בינואר 1998, בשעה 23:00: DTSTART:19980118T230000. ערכי תאריך‑זמן מסוג זה נקראים "צפים" ולא קשורים לאזור זמן מסוים. הם משמשים לייצוג אותו שעה, דקות ושניות ללא תלות באיזור הזמן שנצפה כרגע.

DATE‑TIME עם זמן UTC

תאריך עם זמן UTC, או זמן מוחלט, מזוהה על‑ידי תו סיומת LATIN קפיטל Z, מצביע ה‑UTC, המוצמד לערך הזמן. לדוגמה, הקוד הבא מייצג את 19 בינואר 1998, 07:00 UTC: DTSTART:19980119T070000Z. שימו לב ש‑Aspose.iCalendar מתעלם מסיומת ה‑Z בפורמט UTC ומתייחס לזמן כזמן מקומי. תקן RFC2445 קובע שחלק הזמן שמצוין בכלל UNTIL של תבנית חזרה חייב להיות בפורמט UTC. זוהי הצהרה מוזרה, ובפועל קיימים דוגמאות בתקן המחושבות באופן שגוי. Aspose.iCalendar מקבל זמן בכל פורמט בכלל UNTIL.

DATE‑TIME עם זמן מקומי ואזור זמן

להתייחס לאזור הזמן, משנים את DATE‑TIME עם מאפיין ה‑TZID. לדוגמה, הקוד הבא מייצג את השעה 02:00 בניו‑יורק ב־19 בינואר 1998: DTSTART;TZID=US-Eastern:19980119T020000. שימו לב ש‑Aspose.iCalendar כרגע מתעלם מפרמטר TZID ומתייחס לזמן כזמן מקומי.

BYWEEKNO מספק התאמה ל‑ISO 8601

השתמש ב‑BYWEEKNO רק כאשר יש צורך בהתאמה ל‑ ISO 8601 נדרש. מספרי שבוע כפי שמוגדרים ב‑ISO 8601 שונים מאוד ממספרי שבוע במשמעות הרגילה. לפי ISO 8601, מספר שבוע ראשון של שנת הלוח הוא השבוע הראשון של השנה שמכיל לפחות ארבעה ימים. כלל זה עושה את האלגוריתם ספציפי ליישומים הדורשים התאמה ל‑ISO 8601 ומקשה מאוד על שימושים אחרים. ISO 8601 נתמך על‑ידי כמה אפליקציות בנקאיות ופיננסיות באירופה. הוא משמש גם בטלוויזיה לתזמון פרסומות. כלל BYWEEKNO מציין רשימה מופרדת בפסיקים של מספרים המזהים שבועות של השנה. ערכים תקינים הם 1 עד 53 ו‑1 עד 53. זה תואם לשבועות לפי מספור שבוע כפי שמוגדר ב‑ISO 8601. BYWEEKNO תקף רק לכללים שנתיים.

Net: ניתוח קבצי הודעות של Microsoft Outlook

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

עם Aspose.Email ניתן לנתח הודעות Microsoft Outlook במספר שורות קוד בלבד. מאמר זה מציג כיצד. ל‑Aspose.Email יש מחלקות לביצוע מגוון משימות תכנות עם הודעות Outlook. דוגמת הקוד למטה מראה כיצד לבצע:

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

קטע הקוד הבא מראה איך לנתח קבצי הודעות של Microsoft Outlook.

Net: קבלת הודעות על הודעות שנשלחו בהצלחה וכאלו שנכשלו

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

כאשר ברצונך לקבל את הודעת האספקה הן עבור הודעות שנשלחו בהצלחה והן עבור אלו שנכשלו, ניתן להשתמש באופרטור הפייפ (|) עבור ה‑ DeliveryNotificationOptions מאפיין של MailMessage המחלקה. קטע הקוד הבא מראה כיצד לקבל הודעות על הודעות שנשלחו בהצלחה וכאלו שנכשלו.

Net: זיהוי הודעות דוא"ל חדשות בשרת POP3

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

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

קרא את כל ההודעות משרת הדוא"ל POP3 באמצעות Aspose.Email.
הורד את ההודעות למסד הנתונים המקומי שלך.

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

זיהוי הודעות חדשות

כדי לזהות הודעות דוא"ל חדשות מרשימת הודעות בשרת POP3:

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

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

הורד את כל המזהים הייחודיים של ההודעות לטבלת האש.
חפש בטבלת האש במקום במסד הנתונים עבור כל הודעת דוא"ל בלולאת foreach(…).

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

Net: קריאת הודעות דוא"ל מספרית מספרת SharePoint

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

מאמר זה מציג כיצד לקרוא הודעות דוא"ל מספריית מסמכי Microsoft SharePoint. כדי לגשת לקבצים בספריית המסמכים של SharePoint, יש להתקין את SDK של SharePoint במערכת. SDK מספק את ה‑API הדרוש להתחברות וגישה לקבצים מהספרייה.

קריאת הודעות דוא"ל מ‑SharePoint

דוגמאות הקוד למטה מניחות שקובץ הודעת Outlook (.msg) כבר מאוחסן בתיקייה SharedDocument של ספריית המסמכים של SharePoint. SDK של SharePoint משמש לקבלת קובץ ההודעה לזרם ולאחר מכן להעביר זרם זה למופע של Aspose.Email’s MailMessage המחלקה. מחלקת MailMessage טוענת את הזרם ומפענחת את קובץ ההודעה של Outlook. לאחר מכן, ניתן לגשת למאפייני MailMessage, כגון נושא, גוף טקסט, גוף HTML וכו’, לשימוש בפרויקט Visual Studio. למידע על התקנה והגדרה של Microsoft SharePoint Server וה‑SDK, עברו לחלקים הרלוונטיים בספריית MSDN. קטע הקוד שלהלן מציג כיצד לקרוא הודעות דוא"ל מ‑SharePoint.

Net: קביעת קידוד טקסט ברירת מחדל בהודעת דוא"ל

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

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

מאת: שם תצוגה
אל: שם תצוגה
נושא
גוף

קביעת קידוד טקסט ברירת מחדל

בגרסאות קודמות של Aspose.Email, קידוד הטקסט עבור תכונות from, to, subject ו‑body קבוע בנפרד. כדי לשפר את השימושיות, הוספנו את PreferredTextEncoding מאפיין שמגדיר הכל בבת אחת. כעת קל יותר להבטיח שכל הטקסט בתכונות שלמעלה מקודד כראוי בהודעת הדוא"ל. קטע הקוד הבא מראה כיצד להשתמש במילה בצרפתית כשם תצוגה עבור כתובות הדוא"ל, הנושא והגוף.

Net: המרת קובץ הודעת Outlook (MSG) לתמונת TIFF

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

במאמר זה, אנחנו מציגים כיצד להמיר קובץ Outlook MSG לתמונת TIFF.

קודם כל, קרא קובץ MSG והמר אותו לפורמט MHTML בעזרת Aspose.Email for .NET. השתמש ב‑ Aspose.Email.MailMessage מחלקה לטעינת קובץ ההודעה.
לאחר טעינת הקובץ, קרא את MailMessage.Save() מתודה ושמור אותו לזרם בפורמט MHTML.
השתמש ב‑Aspose.Words for .NET כדי להמיר את זרם MHTML ל‑TIFF. השתמש ב‑ Aspose.Words.Document מחלקה לטעינת זרם MHTML.
לבסוף, קרא את Document.Save() מתודה לשמירת מסמך MHTML ל‑TIFF.

אם המסמך מכיל כמה עמודים, נוצר קובץ TIFF מרובת עמודים. מקטעי הקוד שלהלן מציגים כיצד להמיר קובץ הודעת Outlook (MSG) לתמונת TIFF.

Net: שימוש במסמך Microsoft Word כגוף ההודעה ושליחת אימייל

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

מאמר זה מראה כיצד להשתמש במסמך Microsoft Word כשגוף הודעה ולשלוח אותו למקבלים. המסמך לדוגמה הוא חשבונית מכירות ממאגר Northwind, מיוצא לפורמט Microsoft Word. Aspose.Email for .NET מתמחה בפרוטוקולי רשת ובמאפייני Outlook ואינו יכול להתמודד עם מסמכי Word. כדי לעקוף זאת, הדוגמאות במאמר משתמשות ב‑ Aspose.Words for .NET לטעון את מסמך ה‑Word ולומר אותו לפורמט MHTML. Aspose.Email for .NET משתמש במסמך MHTML בגוף ההודעה.

שימוש במסמכי Microsoft Word כגוף אימייל

דוגמאות קוד למטה ממחישות כיצד לשלוח מסמך Word כגוף הודעה באמצעות Aspose.Words for .NET ו‑Aspose.Email for .NET:

טעינת מסמך Microsoft Word באמצעות Aspose.Word for .NET’s Document מחלקה.
שמור אותו בפורמט MHTML.
טעינת מסמך MHTML באמצעות Aspose.Email for .NET’s MailMessage מחלקה להגדרת גוף האימייל.
הגדר תכונות הודעה נוספות באמצעות שונות MailMessage תכונות ושיטות של המחלקה.
שליחת הדוא"ל באמצעות Aspose.Email for .NET’s SMTPClient מחלקה.

מסמך המקור, חשבונית מכירות שיוצאה ל‑Microsoft Word מדוגמת Microsoft Northwind, ניתן לראות למטה.

כאשר ההודעה נשלחה ומתקבלת ב‑Microsoft Outlook, היא נראית כפי שמופיעה למטה.

עיצוב ה‑HTML והתמונות נשמרים כפי שהם במסמך המקור כאשר מציגים את ההודעה ב‑Outlook או בלקוח דוא״ל ברשת כמו Gmail או Hotmail. למטה מצורפת תצלום מסך של ההודעה כשפתוחה ב‑Gmail בדפדפן Chrome.

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

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

// Load a Word document from disk and save it to stream as MHTML
Document wordDocument = new Document(folderPath + "invoice.docx");
MemoryStream mhtmlStream = new MemoryStream();
wordDocument.Save(mhtmlStream, SaveFormat.Mhtml);

// Load the MHTML in a MailMessage object
mhtmlStream.Position = 0;
using (MailMessage message = MailMessage.Load(mhtmlStream, new MhtmlLoadOptions()))
{
    message.Subject = "Sending Invoice by Email";
    message.From = "sender@gmail.com";
    message.To = "recipient@gmail.com";

    // Save the message in MSG format to disk
    message.Save(folderPath + "WordDocAsEmailBody_out.msg", SaveOptions.DefaultMsgUnicode);

    // Send the email message
    using (SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "sender@gmail.com", "password"))
    {
        client.SecurityOptions = SecurityOptions.SSLExplicit;
        client.Send(message);
    }
}

Net: תכונות הדפסה של Aspose.Email

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

תכונות הדפסה

ה Aspose.Email.Printing ה‑namespace מספק מערך עשיר של תכונות להדפסת הודעות דוא"ל לפורמטים שונים (XPS או TIFF) והגדרת פריסות עמוד. מאמר זה מתאר אותן. קיימות מספר אפשרויות כיצד ניתן להדפיס הודעת דוא"ל מ‑Aspose.Email:

הדפסת גוף ההודעה בלבד.
הדפסת גוף ההודעה והכותרות.
הדפסת גוף HTML.
הגדרת פריסת העמוד.
התאמה אוטומטית של TIFF למדפסת.
התאם DPI יעד עבור TIFF בפלט.

הדפסת גוף ההודעה

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

הדפסת כותרות הודעה וגוף

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

הדפסת הודעה עם גוף HTML

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

הגדרת פריסת עמוד להדפסה

Aspose.Email.Printing.MailPrinter מספק פקדים להגדרת המאפיינים הבאים של פריסת העמוד:

קיימים שני דגלים: MailInfo ו‑None
יחידות העמוד יכולות להיות Inch, Pixel, Point, Cm או Millimeter.

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

התאמה אוטומטית של TIFF

Aspose.Email.Printing מספקת את MessageFormattingFlags.AutoFitWidth מאפיין המאפשר להתאים אוטומטית את ה‑TIFF למדפסת. קטע הקוד הבא מראה כיצד להשתמש ב‑Auto-fit.

התאמת DPI יעד עבור TIFF בפלט

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

Net: שימוש בגיליון Microsoft Excel כגוף ההודעה ושליחת דוא"ל

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

מאמר זה משתמש בחוברת עבודה של Microsoft Excel כגוף ההודעה ושולח אותה למקבלים. Aspose.Email for .NET מתמחה בפרוטוקולים רשת ובמאפיינים של Outlook ואינו יכול להתמודד עם חוברות Excel. כדי לעקוף זאת, הדוגמאות במאמר משתמשות ב‑Aspose.Cells for .NET לטעון את חוברת ה‑Excel ולהמיר אותה לזרם HTML. לאחר מכן Aspose.Email for .NET משתמש בזרם HTML בגוף ההודעה. הדוגמה המוכתבת מציגה כיצד לשלוח גיליון Excel כגוף דוא"ל באמצעות Aspose.Cells for .NET ו‑Aspose.Email for .NET

טעינת חוברת עבודה של Microsoft Excel באמצעות מחלקת Workbook של Aspose.Cells
שמור את חוברת העבודה שהוטענה ל‑MemoryStream בפורמט HTML
קבל את ה‑HTML מהזרם כמחרוזת
הגדר אובייקט MailMessage חדש וקבע את HtmlBody לתוכן HTML מהשלב 3
שליחת הדוא"ל באמצעות מחלקת SmtpClient של Aspose.Email for .NET

חוברת העבודה של Excel המקורית ניתנת להצגה כך:

כאשר ההודעה נשלחה ונקבלה ב‑Microsoft Outlook, היא נראית כך:

קטעי הקוד שלהלן מראים כיצד לשלוח גיליון Excel של Microsoft כגוף ההודעה ולשלוח דוא"ל.

Net: מחלקת עטיפה לטעינת הודעות דוא"ל באופן אסינכרוני באמצעות Aspose.Email

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

Wrapper class for loading Email Messages

קיימות מספר מצבים שבהם רצוי לקיים פונקציית Timeout כדי לעצור פעולה שלוקחת זמן מיותר. מאמר זה מציע מחלקת דוגמה למימוש פונקציית Timeout בעת טעינת קבצי EML/MSG שיכולים לגרום לעיכובים ארוכים מאוד או לכשל בטעינה. מכיוון ש‑Timeout אינו קשור ישירות לפעולות קריאה/כתיבה של דיסק או רשת, אין הרבה תועלת ליישם תכונה זו בתוך ה‑API, עדיף לממש אותה אצל המשתמש על‑ידי כתיבת מחלקת עטיפה סביב Aspose.

ביטול של ת׳ד (thread) ארוך ניתן להשגה באמצעות שימוש במייצג עטוף שמעביר את הת׳ד, שיש להרוג, למשתנה מקומי בתוך המתודה שהחילה אותו. הת׳ד הארוך מבוטל על‑ידי שיבוטו והשליטה מוחזרת ליישום הראשי. קטע הקוד הבא מספק מחלקת עטיפה לדוגמה סביב ספריית Aspose.Email. הקוד מלווה בשימוש לדוגמה של מחלקת העטיפה.

Programming Sample with .NET 3.5 and above

Programming Sample with .NET 2.0

Example Usage

Net: יצירת אירועים מתבנית חזרה

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

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

חשב את המופע הבא או n מופעים הבאים

כדי לקבל את המופע "הבא", השתמש במתודת GenerateOccurrences עם הפרמטר nNextOccurrences=1. קטע הקוד שלהלן מציג כיצד לייצר 20 מופעים על‑ידי שימוש ב‑nNextOccurrences = 20. הפלט של הקוד הוא:

קבלת טקסט ידידותי למשתמש עבור חזרה

ניתן לקבל טקסט ידידותי למשתמש עבור כלל באמצעות המאפיין FriendlyText כפי שמוצג למטה. פלט הקוד יהיה: "מתרחש בכל חודש ביום הראשון והאחרון של היום(ים) של החודש למקסימום של 2 אירועים.". קטע הקוד הבא מראה כיצד לקבל טקסט ידידותי למשתמש עבור חזרה.

Net: גישה לשירותי דואר באמצעות OAuth

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

תמיכת OAuth 2.0 נוספה ל‑Aspose.Email וניתן להשתמש בה לגישה לשרתים SMTP, POP3, IMAP ו‑EWS. באופן כללי, ניתן להשתמש בכל השרתים התומכים באסימוני נושא OAuth 2.0 עם Aspose.Email, אך לקוחות הדוא"ל שלנו נבדקו עם שרתי הדוא"ל של Google ושרתי Microsoft Office 365. גישה לשרת מ‑ SmtpClient, Pop3Client, ImapClient ו EWSClient עם OAuth ניתן לממש ב-2 דרכים.

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

הגדרת חשבון על השרת המתאים

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

ל Office 365
ל Gmail

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

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

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    "accessToken",
    true,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.Auto))
{

}

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

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

ITokenProvider tokenProvider = TokenProvider.Google.GetInstance(
    "ClientId",
    "ClientSecret",
    "RefreshToken");

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

מימוש של ITokenProvider מותאם אישית עבור Office 365

ניתן להשתמש במימוש ספק האסימונים למטה לגישה לשירותי הדואר של Office 365.

using JsonConvert = Newtonsoft.Json.JsonConvert;
using Aspose.Email.Clients;
using Aspose.Email.Common.Utils;
using Aspose.Email.Tests.TestUtils;
using Newtonsoft.Json;
using System;
using System.IO;
using System.Net;
using System.Text;

namespace TestNS
{
    /// <summary>
    /// Azure resource owner password credential (ROPC) token provider
    /// https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
    /// https://portal.azure.com
    /// https://developer.microsoft.com/en-us/graph/graph-explorer/#
    /// token parser https://jwt.io
    /// </summary>
    internal class AzureROPCTokenProvider : ITokenProvider
    {
        private const string uriFormat = "https://login.microsoftonline.com/{0}/oauth2/v2.0/token";
        private const string bodyFormat =
            "client_id={0}" +
            "&scope={1}" +
            "&username={2}" +
            "&password={3}" +
            "&grant_type={4}";

        private readonly string scope;
        private const string grant_type = "password";
        private readonly object tokenSyncObj = new object();
        private OAuthToken token;
        private readonly string tenant;
        private readonly string clientId;
        private readonly string clientSecret;
        private readonly string userName;
        private readonly string password;

        /// <summary>
        /// Initializes a new instance of the <see cref="AzureROPCTokenProvider"/> class
        /// </summary>
        /// <param name="tenant"></param>
        /// <param name="clientId"></param>
        /// <param name="clientSecret"></param>
        /// <param name="scope"></param>
        /// <param name="userName"></param>
        /// <param name="password"></param>
        /// <param name="scopeAr"></param>
        public AzureROPCTokenProvider(
            string tenant, 
            string clientId, 
            string clientSecret, 
            string userName, 
            string password,
            string[] scopeAr)
        {
            this.tenant = tenant;
            this.clientId = clientId;
            this.clientSecret = clientSecret;
            this.userName = userName;
            this.password = password;
            this.scope = string.Join(" ", scopeAr);
        }

        /// <summary>
        /// Gets oAuth access token. 
        /// </summary>
        /// <param name="ignoreExistingToken">
        /// If ignoreExistingToken is true, requests new token from a server. Otherwise behaviour is depended on whether token exists or not.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </param>
        /// <returns>Returns oAuth access token</returns>
        public virtual OAuthToken GetAccessToken(bool ignoreExistingToken)
        {
            lock (tokenSyncObj)
            {
                if (this.token != null && !this.token.Expired && !ignoreExistingToken)
                    return this.token;
                token = null;
                string uri = string.Format(uriFormat, string.IsNullOrWhiteSpace(tenant) ? "common" : tenant);
                HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri);
                string body = string.Format(bodyFormat,
                    HttpUtility.UrlEncode(clientId),
                    HttpUtility.UrlEncode(scope),
                    HttpUtility.UrlEncode(userName),
                    HttpUtility.UrlEncode(password),
                    HttpUtility.UrlEncode(grant_type));
                byte[] bytes = Encoding.ASCII.GetBytes(body);
                request.Method = "POST";
                request.ContentType = "application/x-www-form-urlencoded";
                request.ContentLength = bytes.Length;
                MemoryStream ms = new MemoryStream(bytes);
                using (Stream requestStream = request.GetRequestStream())
                    requestStream.Write(bytes, 0, bytes.Length);
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                StringBuilder responseText = new StringBuilder();
                bytes = new byte[1024];
                int read = 0;
                using (Stream stream = response.GetResponseStream())
                {
                    while ((read = stream.Read(bytes, 0, bytes.Length)) > 0)
                        responseText.Append(Encoding.ASCII.GetString(bytes, 0, read));
                }
                string jsonString = responseText.ToString();
                AzureTokenResponse t = JsonConvert.DeserializeObject<AzureTokenResponse>(jsonString);
                token = new OAuthToken(
                    t.access_token,
                    TokenType.AccessToken,
                    DateTime.Now.AddSeconds(t.expires_in));
                return token;
            }
        }

        /// <summary>
        /// Gets oAuth access token.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </summary>
        /// <returns>Returns oAuth access token</returns>
        public OAuthToken GetAccessToken()
        {
            return GetAccessToken(false);
        }

        /// <summary>
        /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
        /// </summary>
        public virtual void Dispose()
        {
        }
    }

    /// <summary>
    /// A success response contains a JSON OAuth 2.0 response with the following parameters.
    /// </summary>
    public class AzureTokenResponse
    {
        /// <summary>
        /// The requested access token. The calling web service can use this token to authenticate to the receiving web service.
        /// </summary>
        public string access_token { get; set; }

        /// <summary>
        /// Indicates the token type value. The only type that Azure AD supports is Bearer For more information about bearer tokens, 
        /// see The OAuth 2.0 Authorization Framework: Bearer Token Usage (RFC 6750).
        /// </summary>
        public string token_type { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int expires_in { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int ext_expires_in { get; set; }

        /// <summary>
        /// The time when the access token expires. 
        /// The date is represented as the number of seconds from 1970-01-01T00:00:00Z UTC until the expiration time.
        /// This value is used to determine the lifetime of cached tokens.
        /// </summary>
        public int expires_on { get; set; }

        /// <summary>
        /// The App ID URI of the receiving web service.
        /// </summary>
        public string resource { get; set; }

        /// <summary>
        /// If an access token was returned, this parameter lists the scopes the access token is valid for.
        /// </summary>
        public string scope { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included the openid scope.
        /// </summary>
        public string id_token { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included offline_access.
        /// </summary>
        public string refresh_token { get; set; }
    }
}

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

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
    "Tenant",
    "ClientId",
    "ClientSecret",
    "EMail",
    "Password",
    scopes);

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.office365.com",
    587,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
    "outlook.office365.com",
    993,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "outlook.office365.com",
   995,
   "Test1@test.onmicrosoft.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

// Connecting to EWS server
const string mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
using (IEWSClient ewsClient = EWSClient.GetEWSClient(mailboxUri, credentials))
{

}

Net: הבדלה בין קבצים מצורפים מוטבעים לקבצים רגילים

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

זהו תרחיש נפוץ שבו הודעת דוא"ל מכילה תמונות מוטבעות בגופה וכן קבצים מצורפים רגילים. בעזרת MailMessage המחלקה, הקבצים המוטבעים ניתנים לחילוץ דרך LinkedResourceCollection מחלקה, בעוד שהקבצים הרגילים נגישים/ניתנים לחילוץ באמצעות AttachmentCollection מחלקת הודעה. עם זאת, המצב שונה כאשר ההודעה נטענת באמצעות מחלקת Aspose.Email.Mapi.MapiMessage, מכיוון שכל התמונות המוטבעות והקבצים המצורפים הרגילים נגישים למשתמש באותו מחלקת MapiAttachmentCollection. לכן יש צורך לבנות שיטה שתוכל להבדיל בין קובץ מוטבע לקובץ רגיל כאשר משתמשים ב‑MapiMessage.

שימוש ב‑Aspose.Email להבדלת קבצים מוטבעים מקבצים רגילים

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

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

גוף HTML: במקרה של הודעה עם גוף HTML, הקובץ המצורף צריך להכיל את המאפיין PR_ATTACH_FLAGS (0x37140003), והערך שלו צריך להיות 0x00000004 עבור קבצים מוטבעים. אם תנאי זה מתקיים, נקבע על פי תגים PR_ATTACH_CONTENT_LOCATION ו‑PR_ATTACH_CONTENT_ID את סוג הקובץ. במידה ואין את תג MAPI PR_ATTACH_FLAGS, נבדוק את המאפיין PR_ATTACH_DISPOSITION (0x3716001F או 0x3716001E) כדי לקבוע את סוג הקובץ.

גוף RTF: אם הגוף הוא RTF, כל קבצי ה‑OLE מצורפים הם קבצים מוטבעים. ערך PR_ATTACH_METHOD לכל קבצי ה‑OLE הוא 0x00000006.

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

Net: Send Mail Using DNS

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

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

Net: חילוץ נתוני אובייקטים משולבים

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

לפעמים נתוני OLE משובצים מיוצגים כקובץ מצורף "oleData.mso" על ידי MapiAttachment וצריך לחלץ בצורה ידנית. קבצי oleData.mso אלה הם בפורמט Microsoft Computer Document File (MCDF) והתמיכה בקבצים אלו היא מעבר לתחום של Aspose.Email. עם זאת, ניתן להשתמש ב‑Aspose.Email בשילוב עם ספריות קוד פתוח אחרות, כגון OpenMCDF, לקריאת תוכן הקבצים לצורך שמירה בכונן. Aspose.Email מספקת את InlineAttachmentExtractor מחלקה להצגת חבילות MSO מתוך הנתונים הבינריים של oledata.mso, שניתן להשתמש בהן לחילוץ תכנים על ידי ספריות קריאת קבצים מורכבים.

אם סוג גוף ההודעה הוא HTML (לא RTF), ויש אובייקטים של OLE בהודעה, המאפיין MapiPropertyTag.PR_ATTACH_DATA_OBJ אינו נמצא. במצב זה, המידע על אובייקטי OLE מצוי בקובץ oldedata.mso.

חילוץ אובייקטים משולבים

מאמר זה מראה כיצד לחלץ את התוכן מקובץ מסוג זה באמצעות Aspose.Email ו‑ OpenMCDF. זאת ניתן לבצע כך:

סופר חבילות MSO מתוך הנתונים הבינריים של קובץ ה‑oledata.mso המצורף
עבור כל נתוני OLE, קרא את ה‑CompoundFile
קרא את הזרם עם CONTENTS
שמור את התוכן ל‑FileStream

Net: שמירת הודעת דוא"ל כ‑PDF

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

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

המרת הודעת דוא"ל ל‑PDF

הקוד שלהלן מציג המרת הודעות דוא"ל ל‑PDF בעזרת Aspose.Email בשילוב עם Aspose.Words for .NET. הפעולה כוללת את השלבים הבאים:

טען את הודעת הדוא"ל באמצעות MailMessage
שמור את הודעת הדוא"ל ל‑MemoryStream כ‑MHTML
טען את הזרם באמצעות Aspose.Words
שמור את ההודעה כ‑PDF

הודעת הדוא"ל המקורית נראית כך:

ה‑PDF המומר מוצג בתמונה שלהלן:

קטע הקוד שלהלן מראה כיצד להמיר הודעות דוא"ל ל‑PDF.

string dataDir = RunExamples.GetDataDir_KnowledgeBase();
MailMessage mailMsg = MailMessage.Load(dataDir + "message3.msg");
MemoryStream ms = new MemoryStream();
mailMsg.Save(ms, Aspose.Email.SaveOptions.DefaultMhtml);

// create an instance of LoadOptions and set the LoadFormat to Mhtml
var loadOptions = new Aspose.Words.Loading.LoadOptions();
loadOptions.LoadFormat = LoadFormat.Mhtml;

// create an instance of Document and load the MTHML from MemoryStream
var document = new Aspose.Words.Document(ms, loadOptions);

// create an instance of HtmlSaveOptions and set the SaveFormat to Html
var saveOptions = new Aspose.Words.Saving.PdfSaveOptions();
document.Save(dataDir + "SaveEmailAsPDF_out.pdf", saveOptions);

Net: שליחת בקשת פגישה עם חזרתיות

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

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

יצירת בקשת פגישה עם חזרה

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

שליחת בקשת עדכון פגישה

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

Net: תמיכה בריבוי תהליכים בלקוחות הדוא"ל

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

לקוחות דוא"ל כגון ImapClient ו‑Pop3Client מאפשרים למשתמשים להשתמש בהם בסביבת ריבוי‑תהליכים. לקוחות דוא"ל מאפשרים קיום של חיבור אחד או יותר עם השרת. לניהול קבוצת חיבורים בתוך הלקוחות משתמשים מאגר חיבורים. מספר החיבורים שניתן ליצור ולהשתמש בהם בו‑זמן מוגבל על‑ידי המאפיין CredentialsByHostClient.MaxConnectionsPerServer. ניתן להגדיר מאפיין זה לערך של 1 או יותר. כברירת מחדל, ערך זה הוא 10. תור פקודות יושם עבור החיבור לתמיכה בפעולות ריבוי‑תהליכים. הפקודות מממשות את הפעולות הפשוטות המוגדרות בפרוטוקול, כגון Noop, Authenticate וכן הלאה. המשתמש יכול להתחיל בהרצת יותר פקודות מהכמות הזמינה של חיבורים, אך הן תבוצענה רק כאשר הלקוח יוכל ליצור חיבור לביצוע הפעולה.

שיטות לשימוש בלקוחות דוא"ל בסביבת ריבוי‑תהליכים

ללקוחות דוא"ל יש את ההתנהגות הבאה:

1. במקרה שה‑MaxConnectionsPerServer = 1, הלקוח יוצר חיבור אחד, מבצע אימות והauthorization. חיבור זה נשמר במצב פעילות עד שהלקוח יושמד. כל הפעולות מתהליכים שונים מופנות לתור פקודות יחיד הממוקם בחיבור הראשי.

2. במקרה שה‑MaxConnectionsPerServer > 1, הלקוח יוצר את מספר החיבורים הנדרש, מבצע אימות והרשאה לכל חיבור. חיבור אחד שמור כחיבור ראשי. חיבור זה נשמר במצב פעילות עד שהלקוח יתבצע השמדתו. כל שאר החיבורים נוצרים ומשתלמים לפי דרישה. הכמות המרבית של חיבורים כאלה מוגדרת על ידי המאפיין MaxConnectionsPerServer, לדוגמה אם MaxConnectionsPerServer = 2, אז אחד שמור כחיבור ראשי, והחיבור השני משמש כתוספת לפעולות המבוצעות בתהליכים אחרים. באופן דומה, אם MaxConnectionsPerServer = 3, החיבור הראשון שמור כחיבור ראשי, ושניים נוספים משמשים כתוספת לפעולות בתהליכים אחרים. במצב שבו מתבקשת חיבור נוסף מתהליך חדש, וכל החיבורים כבר תפוסים, הלקוח מחכה עד שמספר החיבורים בשימוש יופחת. זהו רגע חשוב שמבהיר מדוע השמדת חיבורים נכונה כה משמעותית.

דוגמאות

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

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

2. המשתמש יכול ליצור תהליכים באמצעות עצמים כגון Thread, ThreadPool, Task או כל עצם אחר שמיועד למטרה זו. בנוסף, המשתמש יכול להשתמש בתהליכים שנוצרו בקוד של צד שלישי. במהלך זאת, ללקוח יש שני מודלים של התנהגות

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

b. כאשר המשתמש מריץ שיטה ליצירת חיבור חדש לתהליל נוסף, תהליך זה חסום עד ששינוי ערך המquota לחיבורים חדשים יאפשר חיבור חדש. לאחר מכן נוצר חיבור חדש. חיבור זה מוגדר כחיבור ברירת המחדל לכל הפעולות בתהליך זה. לאחר שמסיימים את כל הפעולות בתהליך זה, יש לפנות את החיבור. כדי ליצור חיבורים חדשים השתמשו במתודה CredentialsByHostClient.CreateConnection. מתודה זו מחזירה אובייקט שמממש את הממשק IDisposable. לשחרור החיבור יש לקרוא למתודה Dispose. יצירת וחיסול חיבור חייבים להתבצע בתוך התהליך שבו מתבצעות פעולות הדוא"ל. ניסיון ליצור חיבור חדש בתהליך שבו נוצר לקוח הדוא"ל מוביל לשגיאה, מכיוון שתהליך זה במועד זה אינו יכול לשמש ליצירת חיבור חדש. כמו‑כן, יצירת חיבור חדש אינה אפשרית כאשר MaxConnectionsPerServer = 1. דוגמת קוד ליצירת חיבור חדש בתהליך נוסף:

המלצות

שווה לציין שאם המשתמש שולח את כל הפקודות דרך החיבור הראשי, ייתכנה מצב שבו פקודות משThreads שונים מתערבבות. על המשתמש להבין אילו פקודות תלויות ברצף שלהן ולנקוט אמצעים לסנכרון של פקודות אלו. יש גם לקחת בחשבון אפשרות לביצוע פקודות במפגשים שונים (IMAP/POP3). הפעולות שלוקחות את רוב הזמן, כגון FetchMessage, AppendMessage ו‑Send, ככל הנראה יש לבצע אותן באמצעות תהליך חדש וחיבור חדש. אך פעולות מהירות כגון Delete עדיף לבצען דרך החיבור הראשי. יש להבחין בכך שהאתחול של חיבור חדש הוא פעולה שגוזלת זמן.

Net: מבוא ויישומים לדוגמה

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

Aspose.Email.Mail Usage Scenarios

מאמר זה מציע מספר אפשרויות שימוש אפשריות עבור Aspose.Email ל‑.NET, תוך התמקדות בפרט בתכונות תכנות הדוא"ל של הרכיב.

תוכנת ניוזלטר

ה Aspose.Email.Mail ניתן להשתמש ב‑API ליצירת יישום ניוזלטר חזק. בעזרת התמיכה של Aspose.Email בהוספת אובייקטים משובצים (כגון תמונות, צלילים וכו’), אפשר ליצור ניוזלטרים עשירים ב‑HTML הכוללים תמונות (ואובייקטים משובצים נוספים). בעזרת תכונת השליחה המונית של Aspose.Email.Mail API, ניתן לשלוח מספר רב של הודעות במרווח זמן מוגבל. Aspose.Email.Mail גם מספקת תכונת מיזוג מכתבים מבוססת תבנית שניתן להשתמש בה ליצירת תבנית ניוזלטר. ניתן להשתמש בתבנית הניוזלטר לביצוע מיזוג מכתבים לשיגור ניוזלטרים מרובים. ישנן משימות נוספות רבות ש‑Aspose.Email.Mail יכולה לבצע ביישום שיווק בדוא"ל.

כלי שיווק אחרים

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

יישומים עסקיים

Aspose.Email.Mail ניתן להשתמש בו במגוון רחב של יישומי עסקיים לביצוע משימות שירות:

התראות דוא״ל: שלח התראות בדוא״ל כדי לעדכן משתמשים על פעילות.
בקשות פגישות: שלח בקשות לפגישות עסקיות בעזרת תמיכת iCalendar של Aspose.Email.Mail.
דיווח מתוזמן במייל: דוחות הם חלק בלתי נפרד מרוב יישומי העסק. דוחות רבים נוצרים במרווחים קבועים. השתמש ב‑Aspose.Email.Mail לשליחת דוחות מתוזמנים במייל.

לקוחות דוא״ל

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

Aspose.Email.Mail Sample Application

להמחשת השימוש ב‑Aspose.Email.Mail, ניצור אפליקציה בשם ‘My First Email’ המציגה כיצד לבנות הודעת דוא"ל עם ה‑ מחלקת MailMessage ולאחר מכן שלח אותה באמצעות מחלקת SmtpClient.

Mail : שלבי יישום לדוגמא

אנא פעל על פי הצעדים להלן כדי ליצור את האפליקציה ‘My First Mail’ באמצעות Aspose.Email.

פתח את Visual Studio.
בתפריט File, בחר New, ולאחר מכן Project. (בחר ליצור אפליקציית Windows ב‑C# או VB.NET).
אם ברשותך רישיון, החל אותו כדי להשתמש בגרסה המלאה של Aspose.Email.
ייבא את קובץ ה‑DLL של Aspose.Email לאפליקציה על‑ידי לחיצה ימנית על Reference בסייר הפתרון.
תכנן את אפליקציית ה‑Windows שלך: צור ממשק המקבל שלושה שדות: From, To ו‑Message.
הקלקה כפולה על כפתור Send בתצוגת העיצוב וכתוב את הקוד בעורך.
צור מופע של המחלקה MailMessage והשתמש במאפייניה לבנות הודעת דוא״ל. (מופעים של מחלקת MailMessage משמשים לבניית הודעות דוא״ל שמועברות לשרת SMTP לצורך משלוח באמצעות מחלקת SmtpClient).
צור מופע של המחלקה SmtpClient והשתמש במאפייניה כדי לשלוח הודעת דוא״ל.
בדוק את אפליקציית ה‑Windows שלך על‑ידי לחיצה על F5.
הקלד כתובות בשדות From ו‑To.
הקלד הודעה בשדה Message Body.
הקלק על Send.

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

כאשר מתחברים לשרת שמפעיל SSL, יש להגדיר את מאפייני האובייקט SMTPClient הבאים

סיכום

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

Aspose.Email.Pop3

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

Pop3 : תכונות מרכזיות

כחלק מ‑Aspose.Email, Aspose.Email.Pop3 תוכנן במיוחד ל‑.NET ונכתב בקוד C# מנוהל. הוא מאפשר לך:

התחבר והתחבר לשרתים של POP3.
תמיכה ב‑APOP.
שאילתת הודעות.
משיכת הודעות.
תמיכה מלאה בסגנון תכנות אסינכרוני.
תמיכה ב‑SSL.

Aspose.Email.Pop3 Scenarios

Aspose.Email.Pop3 יכול לשמש מפתחים במגוון תרחישים שונים. כאן נציג כמה מהם.

אוטומציית דוא״ל עסקית

Aspose.Email.Pop3 ניתן להשתמש בו לשאילת תיבות דוא"ל ולהורדת הודעות דוא"ל. הוא עובד באופן חלק עם רכיב שליחת הדוא"ל, Aspose.Email.Mail. Aspose.Email תומך באופן מלא באוטומציה של דוא"ל. שלח הודעות דוא"ל עם Aspose.Email.Mail והורד הודעות עם Aspose.Email.Pop3. ההודעות שהורדו ניתן לנתח בעזרת Aspose.Email.Mime.

לקוחות דוא״ל

Aspose.Email.Pop3 ניתן להשתמש בו ביישומי לקוחות דוא"ל לקבלת הודעות.

Pop3 : יישום לדוגמא

כאן, נציג כיצד להשתמש Aspose.Email.Pop3. מחלקה זו כוללת תכונות רבות אך נתמקד כיצד להתחבר לשרת POP3 ולשחזר הודעות. הדוגמה מציגה כיצד ליצור אפליקציה ב‑Visual Studio וכן קטעי קוד המביאים את האפליקציה לפעולה. עקוב אחר הצעדים שלהלן ליצירת אפליקציית דוגמה באמצעות Aspose.Email.Pop3.

פתח את Visual Studio.
בתפריט File, בחר New ולאחר מכן Project.
בחר אפליקציית Windows ב‑C# או VB.NET.
ייבא את הקובץ Aspose.Email.dll לאפליקציה על‑ידי לחיצה ימנית על Reference בסייר הפתרון.
כעת עצב אפליקציית Windows כפי שמופיע למטה.
צור מופע של Pop3Client.
הגדר את שם המארח של POP3, שם המשתמש והסיסמה במופע זה.
קרא לפונקציות Connect() ו‑Login() של Pop3Client.
צור מופע של MailMessage והורד אליה את המייל הראשון בחשבון שלך על‑ידי קריאה לפונקציה FetchMessage(). פעולה זו מביאה את המייל הראשון מחשבון הדוא"ל שלך אל מופע ה‑MailMessage.
השתמש במאפייני From, Subject ו-HtmlBody של מופע MailMessage כדי לראות את השולח, הנושא וגוף ההודעה.

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

לשרתים עם SSL מופעל, עלינו לשנות את המאפיינים הבאים של האובייקט Pop3Client:

Aspose.Email.Imap

Aspose.Email.Imap מיישם את פרוטוקול גישה להודעות אינטרנטיות (IMAP) על פלטפורמות .NET. Aspose.Email.Imap מאפשר למפתחים ב‑.NET להוסיף יכולות IMAP לאפליקציות שלהם במהירות, ללא צורך בהבנת פרטי הפרוטוקול. הרכיב תומך במשיכת והעלאת הודעות, בבדיקה האם הודעה חדשה/נקראה/לא נקראה, ועוד.

Imap : תכונות מרכזיות

Aspose.Email.Imap מאפשר לך:

הבא הודעות אימייל.
העלאת הודעות אימייל.
רשימת הודעות אימייל בתיקיות שונות.
בדיקת הסטטוס של הודעות אימייל.
עבודה עם MailMessage.
עבודה עם תמיכת SSL.

Using Aspose.Email.Imap

Aspose.Email.Imap מיישם את פרוטוקול גישה להודעות אינטרנטיות (IMAP) על פלטפורמות .NET. בעזרתו, מפתחים יכולים בקלות לשאול ולנהל הודעות דוא"ל משרת IMAP, וכן ליצור, למחוק או לשנות שם של תיקיות דוא"ל. באמצעות Aspose.Email.Imap, מפתחים נהנים מגישה נוחה לפרוטוקול IMAP דרך API קלים לשימוש. הם יכולים לגשת להודעות מכל מחשב מאחר שהודעות נשמרות על השרת. Aspose.Email.Imap מאפשר למפתחים ליצור יישומי אינטרנט או שולחן עבודה שמקבלים ומעבדים הודעות משרתים של IMAP. Aspose מימש את פרוטוקול IMAP בהתאם לאימות האינטרנט ולתקני RFC. לכן Aspose.Email.Imap הוא מימוש מאובטח ומלא של פרוטוקול IMAP עם מודל אובייקטים וממשקים קלים להבנה.

Imap : יישום דוגמה

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

פתח את Visual Studio.
בתפריט File, בחר New ולאחר מכן Project.
בחר אפליקציית Windows ב‑C# או VB.NET.
ייבא את הקובץ Aspose.Email.dll לאפליקציה זו על‑ידי לחיצה ימנית על Reference בסייר הפתרון.
צור מופע של ImapClient על‑ידי העברת שם שרת IMAP, שם משתמש וסיסמה.
קרא לפונקציה Connect() של מופע ImapClient כדי להתחבר לשרת.
קרא לפונקציה SelectFolder() של מופע ImapClient כדי לבחור את התיקייה שבה ברצונך לספור את מספר ההודעות.
הפעל כעת את המאפיין CurrentFolder.TotalMessageCount של מופע ImapClient כדי לקבל את ספירת הודעות האימייל.

Imap : דוגמאות קוד

דוגמאות הקוד שלהלן משולבות מאחורי כפתור או באירוע OnLoad בטופס. הן מציגות כיצד ליישם את השלבים המתוארים למעלה עם Aspose.Email.

לשרתים עם SSL מופעל, הגדר את המאפיינים הבאים של האובייקט ImapClient:

Aspose.Email.Exchange

Aspose.Email.Exchange מאפשר למפתחים לנהל אימיילים ב‑Microsoft Exchange Server. באמצעות רכיב זה ניתן להתחבר, לרשום הודעות ולהוריד אימיילים מתיבת דואר של שרת Exchange מבלי להבין את פרטי הפרוטוקול הפנימי. הרכיב תומך ברשימת הודעות, שליחת אימיילים, הורדת הודעות ושמירה לפורמט eml או msg על הדיסק המקומי וכד’.

Exchange : תכונות מרכזיות

Aspose.Email.Exchange מאפשר לך:

התחברות ל‑Microsoft Exchange Servers.
רשימת הודעות אימייל בתיבות Exchange.
רשימת הודעות אימייל מתיקיות שונות, לדוגמה תיבת הדואר הנכנס, נשלחו, נמחקו או טיוטות.
מחיקת הודעות בכל תיקייה ב‑Exchange Servers.

שימוש ב‑Aspose.Email.Exchange

באמצעות Aspose.Email.Exchange, מפתחים יכולים לגשת לתיבות דואר של Exchange Server מיישומי .NET שלהם. היא מספקת API קל לשימוש לניהול אימיילים בשרתים של Exchange. מפתחים יכולים ליצור יישומי קונסול, שולחן עבודה או ווב המנהלים אימיילים בתיבות הדואר של Exchange.

דוגמת אפליקציית Aspose.Email.Exchange

מאמר זה מדגים כיצד להשתמש ב‑ Aspose.Email.Exchangeאנו יוצרים יישום שולחניים פשוט שמתחבר לתיבת דואר ב‑Exchange Server, משיג את רשימת ההודעות בתיקיית הדואר הנכנס ומציג אותן בטופס ה‑Windows.

Exchange : שלבי יישום לדוגמה

פתח את Microsoft Visual Studio.
צור פרויקט חדש. (בחר את השפה המועדפת עליך C# או VB.NET)
הוסף רפרנס ל‑Aspose.Email.dll בפרויקט שלך על‑ידי לחיצה ימנית על הפרויקט ובחירת Add Reference מהתפריט.
תכנן טופס של Windows כמו זה שלהלן:

כדי להריץ את היישום בהצלחה, נדרש להשתמש באישורים המתאימים לגישה ל‑Exchange Server. כאן אנו מקבלים את פרטי האישור – כתובת ה‑Exchange Server, שם משתמש, סיסמה ותחום – מהטופס ב‑Windows. זוהי דוגמה בסיסית מאוד ולכן תכונות ההודעה – נושא, ממכיר ואל – מוצגות בפשטות ברשימת התיבות.

Exchange : דוגמאות קוד

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

Exchange : פלט

צילום המסך הזה מציג את ההודעות שהתקבלו מ‑Exchange Server. המתודה ListMessages() מחזירה מידע בסיסי כמו נושא, שולח, נמען ומזהה ההודעה. כדי לקבל את ההודעה המלאה, קרא למתודה ExchangeClient.SaveMessage(). (השתמש ב‑ExchangeClient.SaveMessage() מתואר במאמר שמירת הודעות מתיבת הדואר של Exchange Server בפורמט EML ו‑MSG.)

Aspose.Email.Mime

Multipurpose Internet Mail Extensions (MIME) הוא תקן אינטרנט המרחיב את פורמט האימייל כדי לתמוך בטקסט במערכי תווים שאינם US-ASCII, קבצים מצורפים שאינם טקסט, גופי הודעות מרובי חלקים, ומידע כותרות במערכי תווים שאינם ASCII. Aspose.Email.Mime מיישם את פרוטוקול MIMI על מסגרות .NET. הוא פועל כמתרגם, מכיוון שהוא יכול לקרוא אימייל מקובץ (.eml וכד’) או מזיכרון (מחרוזת). לאחר מכן הוא מנתח את קובץ או המחרוזת של האימייל לחלקים בעלי משמעות. אם ברצונך לעבור על קובץ אימייל מבלי להיכנס לפרטי פרוטוקול MIME, לדוגמה כדי לחלץ קובץ מצורף מאימייל, השתמש ב‑Aspose.Email.Mime.

תכונות עיקריות

Aspose.Email.Mime עובד מושלם עם Aspose.Email.Pop3 ו‑Aspose.Email.Mail.

Aspose.Email.Pop3 מקבל הודעות אימייל מתיבת דואר ספציפית.
Aspose.Email.Mail שולח הודעות אימייל לתיבת דואר ספציפית.
Aspose.Email.Mime הוא הציר של השניים למעלה, ומנתח הודעות אימייל.

Net: ביטול בקשות פגישה עם יומן

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

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

שליחת בקשות פגישה

לפני שנוכל ביטול בקשות פגישה, עלינו לשלוח כמה:

ראשית, צור מופע מסוג SmtpClient לצורך שליחת ההודעה.
כדי לאסוף מידע על המשתתפים, יצרנו גריד נתונים כך שהמשתמשים יכולים להזין שמות וכתובות של אנשים שההזמנה תישלח אליהם.
לאחר ביצוע לולאת for-each על האוסף Rows של הגריד, שמור את כל מידע המשתתפים באוסף MailAddressCollection.
צור מופע של מחלקת MailMessage והגדר מאפיינים נדרשים כגון From, To ו‑Subject.
צור מופע מסוג Appointment וספק מידע על המיקום, זמן ההתחלה, זמן הסיום, המארגנים והמשתתפים.
שמור את כל המידע בבסיס נתונים של SQL Server. העבודה הקשורה למסד הנתונים מתבצעת במתודת SaveIntoDB.

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

ביטול בקשת פגישה

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

בחירת השורה שממנה יש לשלוח את בקשת הביטול.
הקלק על Send Cancel Request כדי לשלוח את הבקשה.
הקוד מזין את המזהה מהשורה שנבחרה בגריד ושואל את מסד הנתונים לקבלת מידע על המשתתף, ההודעה והלוח.
צור מופעים של מחלקת Calendar ו‑ MailMessage מחלקות משתמשות במידע שהתקבל מהמסד נתונים.
השתמש במתודת Appointment.CancelAppointment() כדי לשלוח בקשת ביטול.
שלח את המייל באמצעות ה‑ SMTP.

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

Net: היישום הראשון עם Aspose.Email.Outlook

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

סעיף זה מדגים כיצד להשתמש ב- Aspose.Email.Mapiאנו יוצרים יישום קטן הטוען קובץ הודעת Outlook (TestMessage.msg) ומציג את הנושא, השולח והנמען, ואת תוכן הגוף בטופס Windows. עקוב אחרי הצעדים ליצירת היישום הראשון שלך באמצעות Aspose.Email.Outlook.

ב‑Visual Studio, בתפריט File, בחר New, ואז Project.
בחר ליצור יישום Windows ב‑C# או VB.NET.
ייבא את קובץ ה‑DLL של Aspose.Email אל היישום על‑ידי לחיצה ימנית על Reference בחוקר הפתרון. זה יהיה יישום מבוסס Windows שיציג רק את המידע הקיים בקובץ ההודעה.
צור מופע של MapiMessage מחלקה על ידי שצוין נתיב קובץ ההודעה.
השתמש במאפיינים הציבוריים כדי להציג את הנושא, השולח, הנמען והגוף בבקרי Windows.

היישום של הצעדים שלעיל מוצג למטה בקטע הקוד הבא. השתמש בקוד הבא מאחורי כפתור Load Msg File או באירוע OnLoad של הטפסים.

Net: מאגר חיבורים שוחזר

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

עם השחרור של Aspose.Email 19.3, מאגר החיבורים שוחזר. חדש EmailClient מחלקה הוצגה שתחליף בסופו את CredentialsByHostClient מחלקה. ה- EmailClient מחלקה מספקת ConnectionAsgmtMode מאפיין שמגדיר את מצב הקצאת החיבורים בסביבה מרובת תהליכים. EmailClient.ConnectionAsgmtMode מתוגדר באמצעות ConnectionAsgmtType enumerable.

סוגי חיבורים

הקיימים שלושה סוגי חיבורים הבאים:

החיבור הראשי: זהו החיבור שנוצר ונפטר יחד עם לקוח הדואר. לא ניתן ליצור או לפטר אותו ידנית.
חיבור ברירת מחדל: המשתמש יכול ליצור חיבורים ברירת מחדל לתילים עם CreateConnection מתודה. אם חיבור ברירת מחדל קיים, כל המתודות של לקוח הדוא"ל המבוצעות בתיל ישתמשו במרומז בחיבור זה. רק חיבור ברירת מחדל אחד יכול להתקיים לכל תיל. הוא יכול להיווצר ידנית או אוטומטית. זה תלוי במאפיין EmailClient.ConnectionAsgmtMode. חיבורים אלו ניתן ליצור ידנית באמצעות EmailClient.CreateConnection(createAsDefaultConnection = true) מתודה. אם חיבור ברירת המחדל אינו משמש (תלוי במצב הקצאת חיבור), החיבור הראשי משמש במרומז במקום זאת.
חיבורים עצמאיים: אלו חיבורים שאינם מקושרים לתילים. ניתן ליצור אותם ידנית וחייבים להשתמש בהם במפורש כפרמטר למתודה. חיבורים אלו ניתן ליצור ידנית באמצעות EmailClient.CreateConnection() מתודה או EmailClient.CreateConnection(createAsDefaultConnection = false) שיטה.

סוגי הקצאת חיבור

כדי להגדיר את ה‑ EmailClient.ConnectionAsgmtMode מאפיין, ConnectionAsgmtType ה‑enumerable משמש. סוגי ההקצאה שמסופקים על ידי ConnectionAsgmtType מופיעים למטה.

ConnectionAsgmtType.UseMainOrDefault מצב זה הוא ברירת‑המחדל בלקוחות דוא"ל. לקוח הדוא"ל משתמש בחיבור הראשי לכל הפעולות ממספר תהליכים אם חיבור ברירת‑המחדל לא נוצר, או אם לא הועבר חיבור במפורש כפרמטר למתודה. החיבור הראשי הוא החיבור שנוצר במקביל ליצירת לקוח הדוא"ל. המשתמש יכול ליצור חיבורי ברירת‑מחדל לתהליכים עם CreateConnection מתודה. אם חיבור ברירת מחדל לתיל נוצר, הוא משמש במרומז לכל המתודות של לקוח הדוא"ל שמוזמנות בתיל זה. אם חיבור ברירת מחדל לתיל אינו נוצר, החיבור הראשי משמש לכל המתודות של לקוח הדוא"ל שמוזמנות בתיל זה. המשתמש גם יכול ליצור חיבורים שאינם מקושרים לתילים (לא חיבורי ברירת מחדל) באמצעות CreateConnection מתודה. אם המשתמש רוצה להשתמש בחיבורים אחרים (לא הראשי ולא ברירת המחדל) עליו להעביר חיבור זה במפורש כפרמטר של מתודה שהוא רוצה להשתמש בו. המשתמש יכול בנוסף ליצור כל מספר של חיבורים. חיבור ברירת מחדל יכול להיות רק אחד לכל תיל. יש לשים לב שחיבורי ברירת מחדל פועלים כראוי אם המשתמש משתמש באובייקטי Thread לתכנות מרובה משימות. אם המשתמש משתמש ב‑ConnectionPool או באובייקטי Task לתכנות מרובה משימות, מצב זה עלול להוביל להתנהגות שגויה של האפליקציה. כדי למנוע בעיה זו, על המשתמש לפרק ידנית את חיבור ברירת המחדל (אם הוא משתמש בו) בסיום ביצוע הקוד.
ConnectionAsgmtType.UseMain לקוח הדוא"ל משתמש בחיבור הראשי לכל הפעולות ממספר תהליכים. החיבור הראשי הוא החיבור שנוצר במקביל ליצירת לקוח הדוא"ל. המשתמש אינו יכול ליצור חיבורי ברירת‑מחדל. המשתמש יכול ליצור חיבורים שאינם מקושרים לתהליכים (אינם חיבורים ברירת‑מחדל) בעזרת CreateConnection מתודה. אם המשתמש רוצה להשתמש בחיבורים אחרים (לא הראשי ולא ברירת המחדל) עליו להעביר חיבור זה במפורש כפרמטר של מתודה שהוא מעוניין להשתמש בו.
ConnectionAsgmtType.UseDefault לקוח הדוא"ל משתמש באופן בלתי מפורש בחיבורים ברירת‑המחדל לכל הפעולות ממספר תהליכים. בחיבור הראשי אינו משמש במצב זה. אם חיבור ברירת‑המחדל לא נוצר עבור תהליך (קריאה ראשונה למתודת לקוח הדוא"ל), לקוח הדוא"ל יוצר חיבור ברירת‑מחדל באופן בלתי מפורש לפני ביצוע הפעולה הראשונה. המשתמש אינו יכול ליצור חיבורי ברירת‑מחדל לתהליכים עם CreateConnectionמתודה מכיוון שהם נוצרים אוטומטית. כאשר חיבור ברירת מחדל לתיל נוצר, הוא משמש במרומז לכל המתודות של לקוח הדואר שמוזמנות בתיל זה. המשתמש יכול גם ליצור חיבורים שאינם מקושרים לתילים (לא חיבורי ברירת מחדל) באמצעות CreateConnectionמתודה. אם המשתמש רוצה להשתמש בחיבורים אחרים (לא הראשי ולא ברירת המחדל) עליו להעביר חיבור זה בפורמט מפורש כפרמטר של המתודה שהוא רוצה להשתמש בה. למשתמש ניתן additionally ליצור כל מספר של חיבורים. רק חיבור ברירת מחדל אחד יכול לשמש לכל תרחיש. יש לשים לב שחיבורי ברירת מחדל פועלים כראוי אם המשתמש משתמש באובייקטי Thread לתכנות מרובה משימות. אם המשתמש משתמש ב‑ConnectionPool או באובייקטי Task לתכנות מרובה משימות, מצב זה עלול להוביל להתנהגות שגויה של האפליקציה. כדי למנוע בעיה זו, על המשתמש לפרק ידנית את חיבור ברירת המחדל בסיום ביצוע הקוד.

Documentation – מאמרים טכניים

Net: למה Aspose.Email

Net: השוואה בין Aspose.Email.Mail ל‑APIs של מיקרוסופט

השוואה של Aspose Email Mail ל‑APIs של מיקרוסופט

פרטיו של SmtpMail

מטריצת השוואה

Net: ההבדל בין POP3 ל‑IMAP

ההבדל בין POP3 ל‑IMAP

POP3 ו‑IMAP

POP3

חשבון IMAP

להשאיר דוא"ל בשרת מול להסיר דוא"ל מהשרת

Net: גישה ל‑Gmail ב‑SSL

SMTP

התחברות לשרת SMTP של Gmail

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

IMAP

התחברות לשרת הדוא"ל

בחירת תיקייה וקבלת סך כל ההודעות

שמירת הודעות בכונן הקשיח המקומי

יצירת תיקייה חדשה

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

POP3

התחברות לשרת דוא"ל

בדיקת מצב תיבת הדואר

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

קבלת הודעות

Net: היכרות עם תבניות חזרה

About Aspose.iCalendar Object Model

Sample Patterns

The Last Day of The Month

The Last Workday of Every Month

The Last Monday of The Year

Friday of the First ISO 8601 Week of the Year

First Friday of the Year

Net: פרטים חשובים של iCalendar RFC 2445

About Aspose.iCalendar Object Model

פרטים חשובים של iCalendar RFC 2445

תבניות תאריך וזמן

DATE

DATE‑TIME עם זמן מקומי

DATE‑TIME עם זמן UTC

DATE‑TIME עם זמן מקומי ואזור זמן

BYWEEKNO מספק התאמה ל‑ISO 8601

Net: ניתוח קבצי הודעות של Microsoft Outlook

Net: קבלת הודעות על הודעות שנשלחו בהצלחה וכאלו שנכשלו

Net: זיהוי הודעות דוא"ל חדשות בשרת POP3

זיהוי הודעות חדשות

Net: קריאת הודעות דוא"ל מספרית מספרת SharePoint

קריאת הודעות דוא"ל מ‑SharePoint

Net: קביעת קידוד טקסט ברירת מחדל בהודעת דוא"ל

קביעת קידוד טקסט ברירת מחדל

Net: המרת קובץ הודעת Outlook (MSG) לתמונת TIFF

Net: שימוש במסמך Microsoft Word כגוף ההודעה ושליחת אימייל

שימוש במסמכי Microsoft Word כגוף אימייל

Net: תכונות הדפסה של Aspose.Email

תכונות הדפסה

הדפסת גוף ההודעה

הדפסת כותרות הודעה וגוף

הדפסת הודעה עם גוף HTML

הגדרת פריסת עמוד להדפסה

התאמה אוטומטית של TIFF

התאמת DPI יעד עבור TIFF בפלט

Net: שימוש בגיליון Microsoft Excel כגוף ההודעה ושליחת דוא"ל

Net: מחלקת עטיפה לטעינת הודעות דוא"ל באופן אסינכרוני באמצעות Aspose.Email

Wrapper class for loading Email Messages

Programming Sample with .NET 3.5 and above

Programming Sample with .NET 2.0

Example Usage

Net: יצירת אירועים מתבנית חזרה

חשב את המופע הבא או n מופעים הבאים

קבלת טקסט ידידותי למשתמש עבור חזרה

Net: גישה לשירותי דואר באמצעות OAuth

הגדרת חשבון על השרת המתאים

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

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

מימוש של ITokenProvider מותאם אישית עבור Office 365

Net: הבדלה בין קבצים מצורפים מוטבעים לקבצים רגילים

שימוש ב‑Aspose.Email להבדלת קבצים מוטבעים מקבצים רגילים

Net: Send Mail Using DNS

השוואה של Aspose Email Mail ל‑APIs של מיקרוסופט