Read and Create Outlook Items

מאמר זה מתמקד בעבודה עם אלמנטים שונים של Outlook, כולל לוח שנה, איש קשר, משימה, יומן, הערה ורשימות תפוצה. ב-Aspose.Email עבור .NET, אלמנטים אלו מיוצגים על ידי הקלאסים הבאים: MapiCalendar, MapiContact, MapiTask, MapiJournal, MapiNote, ו-MapiDistributionList. קלאסים אלו משמשים כעטיפות עבור הקלאס MapiMessage כדי לפשט את תהליך הטיפול בנתוני פריטים מתוך מאפייני MAPI, ומספקים ממשק אינטואיטיבי יותר לגישה ולתמרון נתוני פריטים.

API של C# .NET לביצוע משימות הקשורות לדואר אלקטרוני

כדי לעבוד עם פריטי Outlook בצורה מתוכנתת ב-C#, אנחנו נשתמש ב-Aspose.Email עבור .NET, ספריה מתקדמת המאפשרת לך לנהל בקלות דוא"ל, אנשי קשר, פגישות, משימות ודברים אחרים של Outlook. כמה תכונות עיקריות של הספריה כוללות קריאה וכתיבה של דוא"ל בפורמטים שונים, ניהול פגישות ומשימות, עבודה עם אנשי קשר, אינטגרציה עם שרת Exchange, וביצוע פעולות דואר אלקטרוני מתקדמות. בפוסט בבלוג הזה, נציג כיצד להשתמש בזה כדי לקיים אינטראקציה עם פריטי Outlook בתוך יישומי .NET. דוגמאות מעשיות וקטעי קוד מסופקים כדי לעזור לך להבין וליישם את הפונקציות של Aspose.Email עבור .NET בצורה חלקה בפרויקטי C# שלך.

כדי לנצל את הכוח של ה-API, ניתן להוריד את ה-DLL שלו או להתקין אותו מ-NuGet באמצעות הפקודה הבאה:

PM> Install-Package Aspose.Email

גישת כללית

הגישת הכללית לעבודה עם פריטי Outlook כרוכה בטעינת MapiMesage, המרה שלו לקלאס פריט Outlook ספציפי (כגון MapiContact או MapiCalendar), ולאחר מכן גישה או תמרון של המאפיינים שלו. גישה זו מפשטת את העבודה עם מאפייני MAPI ומספקת דרך ישירה לנהל סוגים שונים של פריטי Outlook. מאידך, אתה יכול תמיד לחזור לאובייקט MapiMessage פשוט על ידי קריאה ל-GetUnderlyingMessage על כל אובייקט פריט.

הפעלת פריטי לוח שנה

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

קריאת פריטי לוח שנה

קטע הקוד למטה מדגים כיצד לטעון קובץ .msg כאובייקט MapiMessage. לאחר מכן, הוא בודק אם ההודעה שהוטענה היא מסוג לוח שנה באמצעות המאפיין SupportedType. אם זו אכן פריט לוח שנה, הקוד Casting את ההודעה כאובייקט MapiCalendar וממשיך להוציא פרטי של פריט הלוח שנה.

השלבים לקוד הם:

  1. טוען את הקובץ כאובייקט MapiMessage באמצעות השיטה Load.
  2. בודק אם ההודעה שהוטענה היא מסוג לוח שנה.
  3. אם זהו פריט לוח שנה, Casting את ההודעה כאובייקט MapiCalendar.
  4. מוציא את המיקום, הנושא, תאריך ההתחלה, ותאריך הסיום של פריט הלוח שנה.

יצירת פריט לוח שנה

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

  1. צור פריט לוח שנה חדש MapiCalendar עם פרטים ספציפיים כמו מיקום, נושא, תיאור, זמן התחלה, וזמן סיום.
  2. קרא לשיטה Save על האובייקט של הלוח שנה עם פרמטרים המפרטים את שם הקובץ המוצא ואת אפשרויות השמירה. פריט הלוח שנה נשמר כקובץ ICS (iCalendar) עם הסיומת “.ics” באמצעות MapiCalendarSaveOptions.DefaultIcs.
  3. באופן דומה, השיטה Save נקראת שוב על האובייקט של הלוח שנה כדי לשמור את פריט הלוח שנה כקובץ MSG (הודעת Outlook) עם הסיומת “.msg” באמצעות MapiCalendarSaveOptions.DefaultMsg.

הפעלת פריטי קשר

Aspose.Email מציעה את הקלאס MapiContact שמשמש לעבודה עם פריטי קשר של Microsoft Outlook. הוא מאפשר למפתחים ליצור, לקרוא, לעדכן ולתמרן אנשי קשר של Outlook בפורמטים שונים כמו MSG ו-VCF. קלאס זה מספק מאפיינים ושיטות לקביעת והחזרת מידע על קשרים, כולל שם, כתובת דוא"ל, מספרי טלפון, תואר מקצועי, חברה, ופרטי קשר נוספים.

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

קריאת פריטי קשר

תהליך קריאת פריט קשר כולל טעינת הודעת קשר מקובץ הודעת MAPI והצגת פרטי הקשר:

  1. טען MapiMessage מקובץ באמצעות MapiMessage.Load.
  2. בדוק אם סוג הנתמך של MapiMessage הוא קשר.
  3. אם זהו קשר, המרה את MapiMessage לאובייקט MapiContact.
  4. הצג את פרטי השם, הדוא"ל, והחברה של הקשר.

יצירת פריט קשר

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

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

  1. צור אובייקט MapiContact חדש והתחל את המאפיינים שלו כולל השם, כתובת הדוא"ל, ומידע על החברה.
  2. שמור את פרטי הקשר לפורמט VCARD באמצעות השיטה Save עם הפרמטר ContactSaveFormat.VCard.
  3. שמור את פרטי הקשר לפורמט MSG באמצעות השיטה Save עם הפרמטר ContactSaveFormat.Msg.

הפעלת פריטי משימה

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

קריאת פריטי משימה

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

  1. טען משימה מהקובץ באמצעות MapiMessage.Load.
  2. בדוק אם ההודעה שהוטענה היא מסוג MapiItemType משימה.
  3. אם ההודעה היא משימה, המרה אותה לסוג MapiTask.
  4. הצג פרטי משימה על ידי הדפסת הנושא, הסטטוס, ואחוז ההשלמה.

יצירת פריט משימה

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

  1. צור אובייקט משימה חדש באמצעות MapiTask עם פרטים ספציפיים כמו כותרת, תיאור, תאריך התחלה, תאריך סיום, אחוז השלמה, וסטטוס.
  2. קבע את מאפיין PercentComplete של המשימה ואת מאפיין Status.
  3. שמור את המשימה שנוצרה לקובץ MSG באמצעות השיטה Save עם TaskSaveFormat.Msg כפרמטר הפורמט.

ניהול פריטי יומן

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

קריאת פריט MapiJournal

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

  1. טען הודעת MAPI מהקובץ.
  2. בדוק אם סוג הנתמך של ההודעה שהוטענה הוא פריט יומן.
  3. אם ההודעה היא מסוג יומן, המרה אותה לאובייקט MapiJournal.
  4. הוצא את פרטי היומן כולל נושא, מצב, זמן התחלה, וזמן סיום.

יצירת פריט MapiJournal

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

  1. הגדר רשומת יומן חדשה באמצעות הקלאס MapiJournal עם פרטים ספציפיים כמו כותרת, תיאור, תיאור הפגישה, וסיכום הדיון.
  2. קבע את זמן ההתחלה והסיום.
  3. ציין את החברה וקטגור את הרשומה.
  4. שמור את רשומת היומן שנוצרה לקובץ באמצעות השיטה Save.

ניהול פריטי הערה

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

קריאת פריט הערה

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

  1. טען MapiMessage מקובץ.
  2. אם ההודעה שהוטענה היא מסוג הערה, המרה את MapiMessage לאובייקט MapiNote.
  3. הדפס את הנושא, הגוף, וצבע האובייקט MapiNote שהומר.

יצירת פריט הערה

יצירת הערה חדשה מועילה בקלות על ידי הגדרת מאפייני הנושא, הגוף, והצבע בתוך אובייקט MapiNote חדש. ברגע שההערה מוגדרת, אפשר לשמור אותה כקובץ הודעה באמצעות השיטה Save עם פורמט הקובץ המוגדר לעיונך ולניהול עתידי.

  1. צור אובייקט חדש של MapiNote עם נושא, גוף, וצבע.
  2. שמור את ההערה לקובץ msg על ידי קריאה לשיטה Save.

ניהול רשימות תפוצה

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

קריאת רשימת תפוצה

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

  1. טען רשימת תפוצה מקובץ.
  2. בדוק אם ההודעה שהוטענה היא מסוג רשימת תפוצה (DistList).
  3. המרה את ההודעה לאובייקט MapiDistributionList.
  4. הצג את השם של רשימת התפוצה וחברים.

יצירת רשימת תפוצה

כדי ליצור רשימת תפוצה חדשה, השתמש במרחב השמות Aspose.Email.Mapi. הוסף חברים לרשימה, וציין את השמות וכתובות הדוא"ל שלהם. תוכל לשמור את רשימת התפוצה בפורמט VCF או MSG לשימוש עתידי.

  1. צור רשימת תפוצה חדשה עם הקלאס MapiDistributionList.
  2. הוסף חברים לרשימת התפוצה יחד עם כתובות הדוא"ל שלהם.
  3. שמור את רשימת התפוצה בפורמט VCF באמצעות השיטה Save.
  4. שמור את רשימת התפוצה בפורמט MSG עם אותה Save שיטה.

סיכום

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

אל תהסס להשתמש במשאבים הציבוריים שלנו:

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

ראו גם