- اضافه کردن پیوست‌های معمولی
- اضافه کردن پیوست‌های درون‌خط
- اضافه کردن پیوست‌های مرجع
- اضافه کردن پیام‌های جاسازی‌شده
- ذخیره‌سازی تمام پیوست‌ها به MSG به عنوان فایل‌های جداگانه
پیوست‌های ایمیل فایل‌هایی هستند که همراه با یک پیام ایمیل ارسال می‌شوند و به کاربران این امکان را می‌دهند که اسناد، تصاویر، ویدیوها یا هر محتوای دیجیتال دیگری را به اشتراک بگذارند. مدیریت مؤثر پیوست‌های ایمیل جنبه‌ای حیاتی از سیستم‌های ارتباطی مدرن است و برای توسعه‌دهندگان C# که به دنبال راه‌حلی قوی برای مدیریت آن‌ها به‌طور یکپارچه در برنامه‌های خود هستند، ضروری است.
API C# .NET برای مدیریت پیوست‌های ایمیل
برای پردازش پیوست‌های ایمیل، ما از Aspose.Email for .NET استفاده خواهیم کرد، یک API قدرتمند و جامع طراحی شده برای توسعه‌دهندگان C# که با پیام‌های ایمیل و وظایف مرتبط مختلف در برنامه‌های .NET خود کار کنند. این API مجموعه وسیعی از قابلیت‌ها را برای ایجاد، پردازش، تبدیل و مدیریت پیام‌ها فراهم می‌کند و آن را به ابزاری ارزشمند برای مشاغل و توسعه‌دهندگانی که نیاز به ادغام قابلیت‌های ایمیل در نرم‌افزارهای خود دارند، تبدیل می‌کند. برای بهره‌مندی از قدرت این API، DLL آن را دانلود کنید یا از NuGet نصب کنید.
اضافه کردن پیوست‌های معمولی
پیوست‌های معمولی فایل‌های مستقل هستند که همراه با یک پیام ایمیل شامل می‌شوند و معمولاً به‌عنوان نمادها یا لینک‌های جداگانه در بدنه نمایش داده می‌شوند.
API شهودی Aspose.Email به شما این امکان را می‌دهد که تنها با چند خط کد، یک پیوست معمولی به یک پیام اضافه کنید. با مراحل و نمونه کد زیر، شما یک پیام ایمیل نمونه (MSG) ایجاد کرده و یک پیوست فایل (“document.pdf”) به آن اضافه خواهید کرد که از کلاس MapiMessage در C# استفاده می‌کند:
- یک MapiMessage ایجاد یا بارگذاری کنید.
- محتوای “document.pdf” را به یک آرایه بایت بخوانید.
- پیوست را با نام (“document.pdf”) و داده‌ها به مجموعه Attachments پیام اضافه کنید.
اضافه کردن پیوست‌های درون‌خط
پیوست‌های درون‌خط به‌منظور نمایش در داخل بدنه پیام ایمیل خود طراحی شده‌اند. این معمولاً برای جاسازی تصاویر یا رسانه‌های دیگر به‌طور مستقیم در محتوای ایمیل استفاده می‌شود، به‌طوری‌که گیرنده بتواند محتوا را بدون نیاز به باز کردن یک پیوست جداگانه مشاهده کند.
تصویر در محتوای پیام یک پیوست درون‌خط است. API Aspose.Email اجازه می‌دهد تا بررسی کنید که آیا یک پیوست درون‌خط است قبل از انجام دیگر دستکاری‌ها با آن، و نمونه کد زیر نشان می‌دهد که چگونه این کار را انجام دهید.
- پیام ایمیل را از فایل با استفاده از متد MapiMessage.Load() بارگذاری کنید.
- از طریق مجموعه پیوست‌های آن تکرار کنید.
- برای هر پیوست در مجموعه، نام‌های نمایشی آن‌ها را به همراه مقادیر بولی که نشان می‌دهند آیا آن‌ها درون‌خط یا معمولی هستند، چاپ کنید.
اضافه کردن پیوست‌های مرجع
پیوست‌های مرجع محتویات واقعی فایل را درون پیام ایمیل شامل نمی‌شوند. در عوض، آن‌ها شامل لینک‌هایی به منابع خارجی، مانند تصاویری هستند که بر روی یک سرور وب میزبانی می‌شوند. هنگامی که گیرنده ایمیل را باز می‌کند، مشتری یا مرورگر وب آن‌ها این منابع را از URLهای مشخص شده برای نمایش محتوا بارگیری می‌کند. بنابراین، کاربر می‌تواند این را با یک لینک به فایلی که در Google Drive ذخیره شده است ارسال کند. به‌جای اینکه مستقیماً سند را به پیام پیوست کنید، می‌توانید یک پیوست لینک ایجاد کنید که به فایل در Google Drive متصل باشد.
نمونه کد زیر نشان می‌دهد که چگونه یک پیام با یک پیوست مرجع ایجاد کنید:
- یک شیء MapiMessage ایجاد یا بارگذاری کنید.
- یک پیوست مرجع به پیام اضافه کنید با استفاده از متد MapiAttachmentCollection.Add، با ارائه نام فایل، URL فایل، URL پوشه و نام ارائه‌دهنده.
- نوع مجوز برای پیوست را با استفاده از متد MapiAttachment.SetProperty تنظیم کنید تا مشخص کنید چه کسی می‌تواند آن را ویرایش کند.
- به‌طور اختیاری، می‌توانید ویژگی‌های اضافی مانند نوع مجوز اصلی، اینکه آیا پیوست یک پوشه است، URL نقطه پایانی ارائه‌دهنده، URL پیش‌نمایش و URL تصویر بندانگشتی را تنظیم کنید.
- پیام را با استفاده از متد Save به یک فایل ذخیره کنید.
اضافه کردن پیام‌های جاسازی‌شده
پیام‌های جاسازی‌شده آن‌هایی هستند که درون یک پیام ایمیل دیگر شامل می‌شوند یا درون آن قرار دارند. آن‌ها می‌توانند محتوای خود، پیوست‌ها و متاداده‌های خود را داشته باشند و معمولاً درون بدنه یا به‌عنوان پیوست‌های پیام والد قرار می‌گیرند.
این مفهوم معمولاً در سناریوهایی مانند Forwarding یا Replying به ایمیل‌ها استفاده می‌شود، جایی که پیام اصلی به‌عنوان بخشی از پیام جدید شامل می‌شود. در این حالت، پیام اصلی به یک پیام جاسازی‌شده درون بدنه پیام جدید تبدیل می‌شود و محتوای خود را حفظ می‌کند، از جمله فرستنده، گیرندگان و موضوع. این ویژگی برای ارتباطات ایمیلی بنیادی است و به کاربران این امکان را می‌دهد که یک رشته مکالمه منسجم را در حین تبادل پیام‌ها حفظ کنند.
Aspose.Email اجزای لازم برای پیاده‌سازی این ویژگی را فراهم می‌کند. نمونه کد زیر با مراحل نشان می‌دهد که چگونه یک شیء جاسازی‌شده به یک پیام ایمیل اضافه کنید:
- یک نمونه از کلاس MapiMessage ایجاد کنید.
- پیام موجود را از فایل با استفاده از متد MapiMessage.Load() بارگذاری کنید.
- پیام بارگذاری‌شده را به‌عنوان یک پیوست به پیام قبلاً ایجاد شده اضافه کنید. برای این منظور از متد MapiAttachmentCollection.Add استفاده کنید.
ذخیره‌سازی تمام پیوست‌ها به MSG به عنوان فایل‌های جداگانه
نمونه کد زیر به شما نشان می‌دهد که چگونه یک پیام ایمیل را از یک فایل بارگذاری کرده و هر پیوست فردی را از پیام به‌عنوان یک فایل جداگانه با نام فایل اصلی خود ذخیره کنید.
- یک نمونه از کلاس MapiMessage ایجاد کنید.
- از طریق مجموعه پیوست‌های پیام بارگذاری شده تکرار کنید.
- برای هر پیوست، آن را به‌عنوان یک فایل جداگانه با استفاده از متد Save ذخیره کنید و اطمینان حاصل کنید که هر پیوست با نام فایل اصلی خود ذخیره شده است.
نتیجه‌گیری
در این مقاله، ما پیاده‌سازی عملی اضافه کردن انواع مختلف پیوست‌ها و اشیای جاسازی‌شده به پیام‌های ایمیل را بررسی کردیم، پیوست‌ها را به فایل‌های جداگانه در C# ذخیره کردیم و نمونه کدهای مختصری را برای نشان دادن فرآیندها ارائه دادیم. Aspose.Email for .NET به‌عنوان یک راه‌حل چندکاره ظاهر می‌شود که به توسعه‌دهندگان این امکان را می‌دهد که به‌طور مؤثر پیوست‌های ایمیل را مدیریت کرده و وظایف ارتباطی را درون برنامه‌های خود بهبود بخشند و بدین ترتیب تجربه‌ای منسجم و یکپارچه برای کاربران نهایی فراهم کنند.
منابع رایگان:
- فروم پشتیبانی برای پرسش‌ها، جستجوی کمک و تعامل با جامعه برای حل مسائل یا کسب بینش در مورد استفاده مؤثر از کتابخانه
- مستندات گسترده که به‌طور جامع جنبه‌های مختلف عملکرد کتابخانه را پوشش می‌دهد و به مراجع API، آموزش‌ها، نمونه‌های کد و بهترین شیوه‌ها دسترسی دارد
- وبلاگ اطلاعاتی که موضوعات گسترده‌ای مرتبط با مدیریت ایمیل، مدیریت پیوست‌ها و سایر موضوعات مربوطه را با بینش‌ها، نکات و به‌روزرسانی‌ها در مورد آخرین ویژگی‌ها و تحولات در اکوسیستم Aspose.Email پوشش می‌دهد
- برنامه‌های رایگان که به بهبود مدیریت ایمیل و بهره‌وری برای کاربران در پلتفرم‌های مختلف طراحی شده‌اند