خواندن و ایجاد موارد Outlook با استفاده از API .NET

• رویکرد کلی
• دستکاری موارد تقویم
  • خواندن موارد تقویم
  • ایجاد یک مورد تقویم
• دستکاری موارد مخاطب
  • خواندن موارد مخاطب
  • ایجاد یک مورد مخاطب
• دستکاری موارد وظیفه
  • خواندن موارد وظیفه
  • ایجاد یک مورد وظیفه
• مدیریت موارد journal
  • خواندن یک مورد MapiJournal
  • ایجاد یک مورد MapiJournal
• مدیریت موارد یادداشت
  • خواندن یک مورد یادداشت
  • ایجاد یک مورد یادداشت
• مدیریت لیست‌های توزیع
  • خواندن یک لیست توزیع
  • ایجاد یک لیست توزیع

این مقاله بر روی کار با عناصر مختلف Outlook، از جمله تقویم، مخاطب، وظیفه، journal، یادداشت و لیست‌های توزیع تمرکز دارد. در Aspose.Email برای .NET، این عناصر توسط کلاس‌های زیر نمایش داده می‌شوند: MapiCalendar، MapiContact، MapiTask، MapiJournal، MapiNote، و MapiDistributionList. این کلاس‌ها به عنوان wrapper برای کلاس MapiMessage عمل می‌کنند تا فرآیند مدیریت داده‌های موارد از خواص MAPI را ساده کنند و رابط کاربری شهودی‌تری را برای دسترسی و دستکاری داده‌های مورد فراهم کنند.

API C# .NET برای انجام وظایف مرتبط با ایمیل

برای کار با موارد Outlook به‌طور برنامه‌نویسی در C#، ما از Aspose.Email برای .NET استفاده خواهیم کرد، یک کتابخانه پیشرفته که به شما اجازه می‌دهد تا به راحتی ایمیل‌ها، مخاطبین، قرار ملاقات‌ها، وظایف و سایر موارد Outlook را مدیریت کنید. برخی از ویژگی‌های کلیدی این کتابخانه شامل خواندن و نوشتن ایمیل‌ها در فرمت‌های مختلف، مدیریت قرار ملاقات‌ها و وظایف، کار با مخاطبان، ادغام با Exchange Server و انجام عملیات پیشرفته ایمیل است. در این پست وبلاگ، ما نشان خواهیم داد که چگونه از آن برای تعامل با موارد Outlook در برنامه‌های .NET استفاده کنیم. نمونه‌های عملی و کدهای نمونه برای کمک به شما در درک و پیاده‌سازی قابلیت‌های Aspose.Email برای .NET به‌طور یکپارچه در پروژه‌های C# خود ارائه می‌شود.

برای استفاده از قدرت API، می‌توانید DLL آن را دانلود کنید یا از NuGet با استفاده از فرمان زیر نصب کنید:

PM> Install-Package Aspose.Email

رویکرد کلی

رویکرد کلی برای کار با موارد Outlook شامل بارگذاری یک MapiMessage، تبدیل آن به یک کلاس خاص مورد Outlook (مانند MapiContact یا MapiCalendar) و سپس دسترسی یا دستکاری خواص آن است. این رویکرد کار با خواص MAPI را ساده کرده و راهی مستقیم برای مدیریت انواع مختلف موارد Outlook فراهم می‌کند. از طرف دیگر، شما همیشه می‌توانید با تماس با GetUnderlyingMessage در هر شیء مورد به شیء MapiMessage بازگردید.

دستکاری موارد تقویم

موارد تقویم Outlook توسط کلاس MapiCalendar نمایندگی می‌شود. این کلاس خواص و متدهایی برای ایجاد، دستکاری و مدیریت موارد تقویم مانند قرار ملاقات‌ها، جلسات و رویدادها در یک تقویم Outlook فراهم می‌کند. کاربران می‌توانند از این کلاس برای ایجاد، ویرایش و تعامل با موارد تقویم به‌طور برنامه‌نویسی در برنامه‌های .NET خود استفاده کنند. در پاراگراف‌های زیر، شما یاد خواهید گرفت که چگونه موارد تقویم را ایجاد و بخوانید.

خواندن موارد تقویم

نمونه کد زیر نشان می‌دهد که چگونه یک فایل .msg را به‌عنوان یک شیء MapiMessage بارگذاری کنید. سپس بررسی می‌کند که آیا پیام بارگذاری شده از نوع تقویم است یا خیر با استفاده از خواص SupportedType. اگر واقعاً یک مورد تقویم باشد، کد پیام را به‌عنوان یک شیء MapiCalendar cast کرده و به ادامه خروجی جزئیات مورد تقویم می‌پردازد.

مراحل کد به شرح زیر است:

1. فایل را به‌عنوان یک شیء MapiMessage با استفاده از متد Load بارگذاری کنید.
2. بررسی کنید که آیا پیام بارگذاری شده از نوع تقویم است.
3. اگر یک مورد تقویم باشد، پیام را به‌عنوان یک شیء MapiCalendar cast کنید.
4. مکان، موضوع، تاریخ شروع و تاریخ پایان مورد تقویم را خروجی دهید.

ایجاد یک مورد تقویم

برای ایجاد یک مورد تقویم جدید و ذخیره آن در فرمت‌های مختلف، از نمونه کد زیر که توسط Aspose.Email ارائه شده است، استفاده کنید:

1. یک مورد تقویم جدید MapiCalendar با جزئیات خاص مانند مکان، موضوع، توضیحات، زمان شروع و زمان پایان ایجاد کنید.
2. متد Save را بر روی شیء تقویم با پارامترهایی که نام فایل خروجی و گزینه‌های ذخیره‌سازی را مشخص می‌کند، فراخوانی کنید. مورد تقویم به‌عنوان یک فایل ICS (iCalendar) با پسوند “.ics” با استفاده از MapiCalendarSaveOptions.DefaultIcs ذخیره می‌شود.
3. به‌طور مشابه، متد Save دوباره بر روی شیء تقویم فراخوانی می‌شود تا مورد تقویم به‌عنوان یک فایل MSG (پیام Outlook) با پسوند “.msg” با استفاده از MapiCalendarSaveOptions.DefaultMsg ذخیره شود.

دستکاری موارد مخاطب

Aspose.Email کلاس MapiContact را ارائه می‌دهد که برای کار با موارد مخاطب 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 Task است.
3. اگر پیام یک وظیفه باشد، آن را به نوع MapiTask cast کنید.
4. جزئیات وظیفه را با چاپ موضوع، وضعیت و درصد تکمیل نمایش دهید.

ایجاد یک مورد وظیفه

نمونه کد زیر نشان می‌دهد که چگونه یک مورد وظیفه ایجاد کنید، خواص آن را مانند عنوان، توضیحات، تاریخ‌های شروع و پایان، درصد تکمیل و وضعیت را تنظیم کنید و آن را به‌عنوان یک فایل MSG ذخیره کنید:

1. یک شیء وظیفه جدید با استفاده از کلاس MapiTask با جزئیات مشخص شده از جمله عنوان، توضیحات، تاریخ شروع، تاریخ پایان، درصد تکمیل و وضعیت ایجاد کنید.
2. خواص PercentComplete و Status وظیفه را تنظیم کنید.
3. وظیفه ایجاد شده را با استفاده از متد Save به یک فایل MSG با پارامتر فرمت TaskSaveFormat.Msg ذخیره کنید.

مدیریت موارد journal

یک ورودی journal Outlook توسط کلاس MapiJournal نمایندگی می‌شود. دستورالعمل‌های زیر شما را در ایجاد و خواندن یک ورودی journal راهنمایی می‌کند.

خواندن یک مورد MapiJournal

برای خواندن یک مورد MapiJournal، می‌توانید پیام journal را با استفاده از متد MapiMessage.Load بارگذاری کنید. پس از تأیید اینکه نوع پشتیبانی شده یک journal است، می‌توانید جزئیات journal مانند موضوع، وضعیت سند، زمان شروع و زمان پایان را بازیابی و نمایش دهید.

1. یک پیام MAPI را از فایل بارگذاری کنید.
2. بررسی کنید که آیا نوع پشتیبانی شده پیام بارگذاری شده یک مورد journal است.
3. اگر پیام از نوع journal باشد، آن را به یک شیء MapiJournal تبدیل کنید.
4. جزئیات journal شامل موضوع، وضعیت، زمان شروع و زمان پایان را خروجی دهید.

ایجاد یک مورد MapiJournal

اکنون ما در حال ایجاد یک ورودی journal و شامل جزئیات آن هستیم. این ورودی همچنین شامل یک توصیف مختصر از جلسه خواهد بود. این کد نشان می‌دهد که چگونه یک MapiJournal ایجاد و ذخیره شود.

1. یک ورودی journal جدید با استفاده از کلاس MapiJournal با جزئیات خاص از جمله عنوان، توضیحات، توصیف جلسه و خلاصه بحث تعریف کنید.
2. زمان شروع و پایان را تنظیم کنید.
3. شرکت را مشخص کنید و ورودی را دسته‌بندی کنید.
4. ورودی journal ایجاد شده را با استفاده از متد Save به یک فایل ذخیره کنید.

مدیریت موارد یادداشت

Aspose.Email کلاس MapiNote را ارائه می‌دهد که نمایانگر یک یادداشت Outlook است. این کلاس راه حلی برای ایجاد و بازیابی اطلاعات یادداشت به‌طور مؤثر ارائه می‌دهد. بیایید ببینیم چگونه کار می‌کند.

خواندن یک مورد یادداشت

برای دسترسی و نمایش جزئیات یک یادداشت، پیام یادداشت را با استفاده از متد MapiMessage.Load بارگذاری کنید و شیء یادداشت را بازیابی کنید. سپس می‌توانید جزئیات خاص مانند موضوع، بدنه و رنگ یادداشت را برای پردازش بیشتر دسترسی و نمایش دهید.

1. یک MapiMessage را از یک فایل بارگذاری کنید.
2. اگر پیام بارگذاری شده از نوع Note باشد، MapiMessage را به یک شیء MapiNote تبدیل کنید.
3. موضوع، بدنه و رنگ شیء MapiNote تبدیل شده را چاپ کنید.

ایجاد یک مورد یادداشت

ایجاد یک یادداشت جدید به راحتی با تعریف خواص موضوع، بدنه و رنگ یادداشت در یک شیء جدید MapiNote انجام می‌شود. پس از پیکربندی یادداشت، می‌توان آن را به‌عنوان یک فایل پیام با استفاده از متد Save با فرمت فایل مشخص شده برای ارجاع و مدیریت آینده ذخیره کرد.

1. یک شیء جدید MapiNote با موضوع، بدنه و رنگ ایجاد کنید.
2. یادداشت را با فراخوانی متد Save به فایل MSG ذخیره کنید.

مدیریت لیست‌های توزیع

برای ایجاد و خواندن یک لیست توزیع 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 مانند تقویم‌ها، مخاطبین، وظایف، ورودی‌های journal، یادداشت‌ها و لیست‌های توزیع را به‌طور برنامه‌نویسی در C# بررسی کردیم. برای برنامه‌نویسی، از Aspose.Email برای .NET، یک کتابخانه جامع استفاده کردیم که کار با وظایف مرتبط با ایمیل را شامل دستکاری‌های مختلف عناصر Outlook آسان می‌سازد. با استفاده از کلاس‌های ارائه شده توسط این کتابخانه، می‌توانید این عناصر را به راحتی ایجاد، بخوانید و دستکاری کنید. این پست مثال‌های پایه‌ای از هر عنصر را پوشش داد و زمینه‌ای برای عملیات پیچیده‌تری که ممکن است در برنامه‌های خود نیاز داشته باشید فراهم کرد. نمونه‌های کد شهودی به شما کمک می‌کند تا قابلیت‌های کتابخانه را ارزیابی کرده و درک کنید که چگونه می‌توانید قابلیت‌های آن را در پروژه خود پیاده‌سازی کنید.

لطفاً از منابع عمومی ما استفاده کنید:

• مرجع API اطلاعات عمیق‌تری در مورد کلاس‌ها و متدها ارائه می‌دهد.
• مستندات راهنماهای جامع با مثال‌ها را فراهم می‌کند.
• انجمن پشتیبانی به کاربران اجازه می‌دهد تا کمک بگیرند و مسائل را مورد بحث قرار دهند.
• وبلاگ به‌روزرسانی‌ها، آموزش‌ها و بهترین شیوه‌ها را ارائه می‌دهد.

همچنین ببینید

• اضافه کردن و ذخیره پیوست‌های ایمیل Outlook و پیام‌های جاسازی شده در C#
• مدیریت موارد تقویم Outlook: ایجاد، بارگذاری و ذخیره در C#
• مدیریت مخاطبین MS: بارگذاری، تجزیه، ذخیره فایل‌های MSG در C# .NET
• پردازش ایمیل‌های فرمت TNEF Outlook در C# .NET
• کار با وظایف Outlook از فایل‌های PST با استفاده از C#
• کار با لیست‌های توزیع در فایل‌های PST Outlook با استفاده از C#