کار با پیوست‌ها و اشیای درج‌شده

کار با پیوست‌ها

پیوست‌های ایمیل فایل‌هایی هستند که به همراه یک پیام ایمیل ارسال می‌شوند. این فایل‌ها می‌توانند شامل اسناد، تصاویر، آرشیوها و موارد دیگر باشند.

در Aspose.Email برای C++، پیوست‌ها از طریق Attachment کلاس، که همراه با MailMessage کلاس. می‌توانید پیوست‌ها را به‌صورت برنامه‌نویسی اضافه، حذف، استخراج یا نمایش دهید.

توجه: حداکثر اندازه پیوست بستگی به سرور ایمیل دارد (به عنوان مثال، Gmail حداکثر پیوست را به ۱۰ مگابایت محدود می‌کند).

اضافه کردن پیوست‌ها به یک ایمیل

برای پیوست کردن یک یا چند فایل به پیام ایمیل، مراحل زیر را دنبال کنید:

  1. یک نمونه از MailMessage کلاس.
  2. Create Attachment اشیاء برای هر فایل.
  3. پیوست‌ها را با استفاده از AddAttachment().
  4. در صورت نیاز پیام را ذخیره کنید.

نمونهٔ کد

حذف پیوست‌ها از یک ایمیل

به راحتی می‌توانید پیوست‌ها را از یک پیام با استفاده از Remove() متد از پیوست‌ها مجموعه.

قطعه کد زیر نشان می‌دهد چگونه یک پیوست را حذف کنید:

  1. بارگذاری یا ایجاد یک MailMessage نمونه.
  2. یک یا چند پیوست اضافه کنید.
  3. پیوست مورد نظر را حذف کنید.
  4. در صورت تمایل، پیوست‌های باقی‌مانده را نمایش دهید.

نمایش نام‌های فایل پیوست

می‌توانید تمام پیوست‌ها را پیمایش کنید و نام‌های آنها را در کنسول نمایش دهید:

استخراج پیوست‌ها از یک ایمیل

برای استخراج و ذخیره پیوست‌ها از یک فایل ایمیل موجود، مراحل زیر را دنبال کنید:

  1. پیام را با استفاده از MailMessage کلاس.
  2. در حلقه بگردید در پیوست‌ها مجموعه.
  3. هر پیوست را روی دیسک ذخیره کنید و در صورت تمایل نام آن را نمایش دهید.

قطعه کد زیر نشان می‌دهد چگونه پیوست‌های ایمیل استخراج شوند:

|پیوست‌های استخراج‌شده در ایمیل| | :- | |todo:image_alt_text|

خواندن توضیح محتوا پیوست

Aspose.Email به شما اجازه می‌دهد هدر Content-Description یک پیوست را برای متادیتای اضافه بخوانید.

نمونهٔ کد

کار با اشیاء جاسازی‌شده

یک شیء جاسازی‌شده فایلی است که در یک برنامه ایجاد شده و درون سند یا ایمیل دیگری قرار می‌گیرد. به عنوان مثال، یک صفحه‌گسترده Microsoft Excel می‌تواند در یک سند Word جاسازی شود، یا یک تصویر می‌تواند مستقیماً در بدنه ایمیل جاسازی شود.

وقتی یک شیء جاسازی می‌شود (نه فقط پیوست یا لینک می‌شود)، فرمت اصلی خود را حفظ می‌کند و می‌تواند در برنامهٔ بومی خود باز یا ویرایش شود.

جاسازی اشیاء در ایمیل

برای جاسازی یک تصویر یا شیء دیگر در پیام ایمیل، از LinkedResource کلاس همراه با MailMessage و AlternateView کلاس‌ها. این امکان را می‌دهد تا تصاویر یا محتوای رسانه‌ای درون‌خطی را که مستقیماً در بدنه پیام ظاهر می‌شوند، اضافه کنید.

نمونه کد زیر نشان می‌دهد چگونه یک پیام ایمیل با هر دو محتویات متن ساده و HTML ایجاد کنید که شامل یک تصویر جاسازی‌شده باشد:

  1. یک نمونه از MailMessage کلاس.
  2. فیلدهای فرستنده، گیرنده و موضوع را تنظیم کنید.
  3. یک بدنه متن ساده با استفاده از AlternateView.
  4. یک بدنه HTML حاوی ارجاع به شیء جاسازی‌شده با استفاده از cid (Content-ID).
  5. یک نمونه از LinkedResource کلاس و شیء را بارگذاری کنید.
  6. یک Content-ID به منبع لینک‌شده اختصاص دهید.
  7. منبع لینک‌شده و نماهای جایگزین را به پیام اضافه کنید.
  8. پیام ایمیل را ذخیره یا ارسال کنید.

توجه: > می‌توانید چندین شیء را جاسازی کنید، اما حداکثر اندازه پیام توسط سرور ایمیل شما محدود می‌شود. به عنوان مثال، Gmail اندازه پیام را به ۱۰ مگابایت محدود می‌کند.

استخراج اشیاء جاسازی‌شده از یک ایمیل

همچنین می‌توانید اشیاء جاسازی‌شده، مانند تصاویر یا فایل‌ها، را از یک پیام ایمیل موجود استخراج کنید. این فرآیند مشابه استخراج پیوست‌ها است:

  1. یک نمونه از MailMessage کلاس.
  2. فایل ایمیل را به داخل MailMessage نمونه.
  3. از مجموعهٔ پیوست‌ها عبور کنید.
  4. هر شیء جاسازی‌شده را روی دیسک ذخیره کنید.
  5. در صورت تمایل، نام‌های فایل را در کنسول نمایش دهید.

|اشیای جاسازی‌شده استخراج‌شده در ایمیل| | :- | |todo:image_alt_text|