Обробка вкладень електронної пошти Outlook та вбудованих повідомлень у C#

Вкладення електронної пошти – це файли, які надсилаються разом з повідомленням електронної пошти, що дозволяє користувачам ділитися документами, зображеннями, відео або будь-яким іншим цифровим контентом. Ефективна обробка вкладень електронної пошти є важливим аспектом сучасних комунікаційних систем, і для розробників C#, які шукають надійне рішення для управління ними в своїх додатках.

C# .NET API для управління вкладеннями електронної пошти

Щоб обробляти вкладення електронної пошти, ми будемо використовувати Aspose.Email для .NET, потужний та комплексний API, розроблений для розробників C# для роботи з повідомленнями електронної пошти та різними супутніми завданнями в їх .NET-додатках. Він забезпечує широкий спектр функцій для створення, обробки, конвертації та управління повідомленнями, що робить його цінним інструментом для бізнесу та розробників, які потребують інтеграції можливостей електронної пошти у свої програмні додатки. Щоб скористатися перевагами API, завантажте його DLL або встановіть його з NuGet.

Додавання регулярних вкладень

Регулярні вкладення – це окремі файли, які включені в повідомлення електронної пошти, зазвичай відображаються як окремі значки або посилання в тілі.

Приклад вкладення електронної пошти - Регулярне вкладення

Інтуїтивно зрозумілий API Aspose.Email дозволяє вам додати регулярне вкладення до повідомлення всього за кілька рядків коду. Виконавши кроки та приклад коду нижче, ви створите зразок повідомлення електронної пошти (MSG) і додасте до нього вкладення файлу (“document.pdf”) за допомогою класу MapiMessage у C#:

  1. Створіть або завантажте MapiMessage.
  2. Прочитайте вміст “document.pdf” у масив байтів.
  3. Додайте вкладення з ім’ям (“document.pdf”) та даними до колекції Attachments повідомлення.

Додавання вбудованих вкладень

Вбудовані вкладення призначені для відображення в тілі самого повідомлення електронної пошти. Це часто використовується для вбудовування зображень або інших медіа безпосередньо в контент електронної пошти, що дозволяє одержувачу переглядати контент без необхідності відкривати окреме вкладення.

Приклад вкладення електронної пошти - Вбудоване вкладення

Зображення в контенті повідомлення є вбудованим вкладенням. API Aspose.Email дозволяє перевірити, чи є вкладення вбудованим, перш ніж виконати інші маніпуляції з ним, а приклад коду нижче демонструє, як виконати це завдання.

  1. Завантажте повідомлення електронної пошти з файлу за допомогою методу MapiMessage.Load().
  2. Перейдіть через його колекцію вкладень.
  3. Для кожного вкладення в колекції виведіть їхні імена відображення разом з булевими значеннями, що вказують, чи є вони вбудованими або регулярними.

Додавання референсних вкладень

Референсні вкладення не містять фактичного вмісту файлу в повідомленні електронної пошти. Натомість вони включають посилання на зовнішні ресурси, такі як зображення, розміщені на веб-сервері. Коли одержувач відкриває електронну пошту, їхній клієнт або веб-браузер отримує ці ресурси з вказаних URL-адрес для відображення вмісту. Таким чином, користувач може надіслати його з посиланням на файл, збережений у Google Drive. Замість того, щоб безпосередньо прикріплювати документ до повідомлення, ви можете створити вкладення посилання, яке посилається на файл на Google Drive.

Приклад вкладення електронної пошти - Референсне вкладення

Приклад коду нижче демонструє, як створити повідомлення з референсним вкладенням:

  1. Створіть або завантажте об’єкт MapiMessage.
  2. Додайте референсне вкладення до повідомлення за допомогою методу MapiAttachmentCollection.Add, вказуючи ім’я файлу, URL-адресу файлу, URL-адресу папки та ім’я постачальника.
  3. Встановіть тип дозволу для вкладення за допомогою методу MapiAttachment.SetProperty, щоб вказати, хто може його редагувати.
  4. За бажанням, ви можете встановити додаткові властивості, такі як оригінальний тип дозволу, чи є вкладення папкою, URL-адресу кінцевої точки постачальника, URL-адресу попереднього перегляду та URL-адресу мініатюри.
  5. Збережіть повідомлення у файл за допомогою методу Save.

Додавання вбудованих повідомлень

Вбудовані повідомлення - це ті, що включені або вкладені в інше повідомлення електронної пошти. Вони можуть містити свій власний вміст, вкладення та метадані, і зазвичай вони інкапсульовані в тілі або як вкладення батьківського повідомлення.

Ця концепція зазвичай використовується в сценаріях, таких як пересилання або відповідь на електронні листи, де оригінальне повідомлення включається як частина нового повідомлення. У таких випадках оригінальне повідомлення стає вбудованим в тіло нового повідомлення, зберігаючи свій вміст, включаючи відправника, одержувачів, тему. Ця функція є основоположною для електронного спілкування і дозволяє користувачам підтримувати послідовність розмови під час обміну повідомленнями.

Приклад вбудованого повідомлення

Aspose.Email надає компоненти для реалізації цієї функції. Наступний приклад коду з кроками демонструє, як додати вбудований об’єкт до повідомлення електронної пошти:

  1. Створіть екземпляр класу MapiMessage.
  2. Завантажте існуюче повідомлення з файлу за допомогою методу MapiMessage.Load().
  3. Додайте завантажене повідомлення як вкладення до раніше створеного. Для цього використовуйте метод MapiAttachmentCollection.Add.

Збереження всіх вкладень у MSG як окремих файлів

Приклад коду нижче покаже вам, як завантажити повідомлення електронної пошти з файлу та зберегти кожне індивідуальне вкладення з повідомлення в окремий файл з його оригінальною назвою файлу.

  1. Створіть екземпляр класу MapiMessage.
  2. Перейдіть через колекцію вкладень завантаженого повідомлення.
  3. Для кожного вкладення збережіть його як окремий файл за допомогою методу Save, переконавшись, що кожне вкладення зберігається з його оригінальною назвою файлу.

Висновок

У цій статті ми розглянули практичну реалізацію додавання різних видів вкладень і вбудованих об’єктів до повідомлень електронної пошти, збереження вкладень у окремі файли в C#, надаючи стислі кодові приклади для ілюстрації процесів. Aspose.Email для .NET стає універсальним рішенням, яке надає розробникам можливість ефективно управляти вкладеннями електронної пошти та покращувати комунікаційні завдання в їхніх додатках, таким чином забезпечуючи послідовний і безперешкодний досвід для кінцевих користувачів.

Безкоштовні ресурси:

  • форум підтримки для поставлення запитань, пошуку допомоги та взаємодії з громадою з метою вирішення проблем або отримання порад щодо ефективного використання бібліотеки
  • обширна документація, яка всебічно охоплює різні аспекти функціональності бібліотеки з доступом до API довідки, підручників, кодових прикладів та найкращих практик
  • інформативний блог, що охоплює широкий спектр тем, пов’язаних з управлінням електронною поштою, обробкою вкладень та іншими відповідними питаннями з порадами, підказками та оновленнями останніх функцій і розробок в екосистемі Aspose.Email
  • безкоштовні додатки, призначені для підвищення управління електронною поштою та продуктивності для користувачів на різних платформах

Дивіться також: