Documentation – Робота з MIME-повідомленнями за допомогою API C++ Email Parser

Cpp: Створення та налаштування листів за допомогою Aspose.Email for C++

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for C++ надає MailMessage клас для створення, налаштування та збереження листів у різних форматах. Цей клас дозволяє визначати основні властивості, такі як відправник, отримувачі, тема та тіло, і підтримує збереження листів у форматах EML, MSG та MHTML.

Створити новий лист

У наведеному прикладі коду показано, як створити та налаштувати новий лист за допомогою Aspose.Email for C++.

Створіть екземпляр MailMessage клас.
Встановіть властивості листа, такі як From, To, Cc, Subject та HtmlBody.
За бажанням збережіть лист у кількох форматах (EML, MSG, MHTML тощо).

Використання дружніх імен для електронних адрес

дружна назва робить електронну адресу більш читабельною. Наприклад, John Smith <jsmith@domain.com> замість просто jsmith@domain.com.

Ви можете прив’язати дружні назви до адрес при формуванні листа, використовуючи MailMessage клас.

Наведений нижче приклад коду показує, як додати дружні назви:

Створіть новий екземпляр MailMessage клас.
Додати To, Cc, та Bcc отримувачі з адресою та дружньою назвою.

Встановити вміст тіла листа

The MailMessage клас дозволяє визначати тіло листа у форматі HTML. Ви також можете надати альтернативні вигляди для різних клієнтів електронної пошти, використовуючи AlternateView клас.

Встановлення HTML‑тіла

Наступний приклад коду демонструє, як встановити HTML‑вміст електронного листа, присвоївши рядок HTML до set_HtmlBody властивість. Використання цього рядка в якості тіла повідомлення вказує, що лист буде надісланий з форматуванням HTML замість простого тексту.

Встановлення альтернативного тексту

Деякі клієнти електронної пошти не можуть відображати HTML‑вміст. Щоб забезпечити читабельність вашого повідомлення для всіх отримувачів, ви можете додати альтернативну просту текстову версію, використовуючи AlternateView клас. Він дозволяє включати кілька версій електронного повідомлення у різних форматах. Наприклад, якщо основне тіло вашого повідомлення — HTML, ви також можете додати просту текстову версію як альтернативу.

Нижче наведений приклад коду демонструє, як створити електронне повідомлення та додати до нього альтернативний вигляд, що містить простий текст.

The AlternateView клас також керує ресурсами, що використовуються у тілі листа:

LinkedResources – колекція вбудованих елементів (наприклад, зображень або вкладень), які посилаються у вмісті повідомлення.
set_BaseUri() – визначає базовий URL, який використовується для розв’язання відносних посилань або шляхів ресурсів у тілі повідомлення.

Cpp: Створення та налаштування вмісту електронних листів у C++ і надсилання листа за допомогою SmtpClient

Mon, 01 Jan 0001 00:00:00 +0000

Створити новий електронний лист

Клас MailMessage представляє електронний лист і дозволяє розробникам створювати нові листи. Основні властивості листа, такі як From, To, Subject та body, можна легко задати для створеного листа. Аналогічно, ми можемо зберігати лист у різних форматах, таких як EML, MSG та MHTML.

<a name="csharp-create-new-email-msg" id="csharp-create-new-email-msg">Кроки: створити нове повідомлення електронної пошти у C#

Створіть екземпляр класу MailMessage.
Встановіть властивості листа.
Збережіть лист у різних форматах.
Створіть екземпляр класу SmtpClient і надішліть лист, використовуючи метод Send.

У наведеному фрагменті коду C++ показано, як створити новий лист із різними властивостями.

Зміна електронних адрес на дружні імена

Нижче наведені приклади коду демонструють, як замінити електронні адреси на дружні імена у листі. Дружнє ім’я — це назва, більш зрозуміла, ніж сама адреса, наприклад John Smith замість js346@domain.com. При надсиланні листа можна пов’язати дружнє ім’я з електронною адресою у конструкторі класу MailMessage.

Щоб змінити електронні адреси на дружні імена у листі, виконайте такі кроки:

Створіть екземпляр класу MailMessage та вкажіть електронні адреси у полях To і From разом із дружніми іменами.
Вкажіть електронні адреси Cc та Bcc разом з дружніми іменами, викликавши конструктор класу MailMessage у екземплярі MailMessage.
Створіть екземпляр класу SmtpClient і надішліть лист, використовуючи метод Send.

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

Встановити тіло листа

Клас MailMessage представляє електронний лист. Екземпляри класу MailMessage використовуються для створення листів, які передаються SMTP‑серверу для доставки за допомогою класу SmtpClient. Тіло листа можна задати за допомогою класу MailMessage. Лист може мати кілька тіл. У класі MailMessage існує два типи тіл листа:

HTML‑тіло
Текстове тіло

Окрім HtmlBody та TextBody, Aspose.Email має ще дві лише для читання властивості, пов’язані з тілом листа:

IsBodyText: вказує, чи є тіло текстовим.
IsBodyHtml: вказує, чи є тіло HTML чи простим текстом.

У цій статті показано, як визначити простий текст або HTML‑текст тіла, задати альтернативний текст і закодувати тіло листа.

Встановлення HTML‑тіла

HtmlBody використовується для вказання HTML‑вмісту тіла повідомлення. HtmlBody має бути обгорнутий між тегами . Нижче наведений фрагмент коду показує, як задати HTML‑тіло.

Встановлення альтернативного тексту

Використовуйте клас AlternateView, щоб вказати копії листа в різних форматах. Наприклад, якщо ви надсилаєте лист у форматі HTML, ви можете також надати версію у вигляді простого тексту на випадок, якщо деякі одержувачі користуються поштовими клієнтами, що не підтримують HTML. Цей клас має два властивості — LinkedResources та BaseUri, які використовуються для розв’язання URL‑ів у вмісті листа.

LinkedResources — це колекція об’єктів LinkedResources. При рендерингу URL‑и у вмісті листа спочатку зіставляються з URL‑ами у Content Link кожного об’єкта LinkedResources у колекції LinkedResources та розв’язуються.
BaseUri використовується читачем листа для розв’язання відносних URL-адрес у тілі, а також для розв’язання відносних URL‑посилань на контент у колекції LinkedResources.

У наведеному фрагменті коду C++ показано, як встановити альтернативний текст.

Cpp: Читання та відображення листів і заголовків у C++

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for C++ надає MailMessage клас, який представляє лист електронної пошти і дозволяє розробникам отримувати доступ і відображати його вміст та заголовки. Ви можете легко витягти інформацію, таку як відправник, отримувачі, тема, тіло та заголовки, з існуючого файлу листа (EML).

Відобразити інформацію про лист

Завантажте файл листа і відобразіть його ключові властивості на екрані, такі як відправник, отримувачі, тема та тіло. Наведений нижче приклад коду покаже, як відобразити інформацію про лист за допомогою Aspose.Email API.

Створіть екземпляр MailMessage клас.
Завантажте електронний лист у the MailMessage екземпляр.
Відобразіть потрібні властивості (наприклад, From, To, Subject та Body) у консолі.

Примітка: Для повних прикладів та файлів даних відвідайте Репозиторій Aspose.Email for C++ на GitHub.

Видобути заголовки листа

Заголовок електронної пошти — це набір полів метаданих, які описують лист, включаючи інформацію про маршрутизацію, тип вмісту, кодування та дані про відправника/отримувача.

Aspose.Email for C++ дозволяє витягувати та працювати з цими заголовками за допомогою MailMessage клас.

Найпоширеніші типи заголовків доступні через HeaderType клас, який надає іменовані константи для стандартних полів заголовків.

У наведеному фрагменті коду показано, як витягти заголовки листа:

Створіть екземпляр MailMessage клас.
Завантажте файл листа в екземпляр.
Отримайте колекцію заголовків, використовуючи get_Headers() метод.
Переберіть колекцію, щоб прочитати або відобразити назви та значення заголовків.

Отримати декодовані значення заголовків

Деякі заголовки листа можуть містити закодований текст (наприклад, рядки теми або користувацькі заголовки, що використовують закодовані слова). Ви можете легко отримати декодоване значення, використовуючи GetDecodedValue() метод HeaderCollection клас.

Наведений нижче фрагмент коду показує, як отримати декодовані значення заголовків.

Cpp: Завантаження та збереження електронних листів за допомогою Aspose.Email for C++

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for C++ надає гнучкі можливості завантаження, збереження та конвертації електронних листів у кілька форматів, включно з EML, MSG, MHTML та HTML. Ви також можете налаштувати параметри завантаження та збереження для обробки кодування, вкладень та вимог до форматування.

Завантажити повідомлення з налаштованими параметрами завантаження

The MailMessage клас може завантажувати повідомлення з різних форматів, таких як EML, MSG, MHTML та HTML, використовуючи спеціалізовані параметри завантаження. Ці параметри дозволяють розробникам зазначати налаштування кодування, зберігати вкладення та керувати вбудованими ресурсами.

Наступний приклад C++ демонструє, як завантажувати електронні листи, використовуючи різні параметри завантаження.

Збереження електронних листів у різних форматах

Aspose.Email for C++ дозволяє конвертувати повідомлення між форматами, такими як EML, MSG, MHTML та HTML. Розробники можуть використати SaveOptions ієрархія класів для зазначення розширених параметрів збереження, включаючи кодування, TNEF‑вкладення та збереження меж.

Доступні параметри збереження включають:

EmlSaveOptions
MsgSaveOptions
MhtSaveOptions
HtmlSaveOptions

Зберегти лист у форматі EML

Наступний фрагмент коду демонструє, як завантажити повідомлення EML та зберегти його на диск у тому ж форматі.

Зберегти оригінальні межі EML

Ви можете зберегти оригінальні MIME‑межі під час збереження файлу EML.

Зберегти TNEF‑вкладення в EML

Наступний приклад коду демонструє, як зберегти лист, зберігаючи TNEF‑вкладення (Transport Neutral Encapsulation Format).

Конвертувати EML у MSG

Ви можете легко конвертувати файл EML у формат Outlook MSG. Наступний фрагмент коду демонструє, як завантажити повідомлення EML та конвертувати його у MSG, використовуючи відповідний параметр з SaveOptions клас.

Зберегти як MHTML

Наступний приклад демонструє, як завантажити повідомлення EML та зберегти його як файл MHTML.

Експорт у MHT з користувацьким часовим поясом

Ви можете встановити користувацький або системний часовий пояс для полів дати повідомлення перед експортом у формат MHT. MailMessage class надає TimeZoneOffset властивість для встановлення налаштованого часового поясу. Нижчевказаний фрагмент коду показує, як експортувати лист у MHT з налаштованим часовим поясом.

Експортувати лист у EML

Наступний приклад показує, як експортувати лист у формат EML:

Cpp: Робота з вкладеннями та вбудованими об’єктами за допомогою C++ API

Mon, 01 Jan 0001 00:00:00 +0000

Робота з вкладеннями

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

У Aspose.Email for C++ вкладення керуються через Attachment клас, який працює разом з MailMessage клас. Ви можете додавати, видаляти, витягати або відображати вкладення програмно.

Примітка: Максимальний розмір вкладення залежить від поштового сервера (наприклад, Gmail обмежує вкладення 10 МБ).

Спробуйте!

Додавати або видаляти електронні вкладення за допомогою безкоштовного Aspose.Email Editor App.

Додавання вкладень до листа

Щоб прикріпити один або декілька файлів до листа, виконайте наведені нижче кроки:

Створіть екземпляр MailMessage клас.
Create Attachment об’єктів для кожного файлу.
Додайте вкладення до листа за допомогою AddAttachment().
Збережіть лист за потреби.

Зразок коду

Видалення вкладень з листа

Ви можете легко видаляти вкладення з листа, використовуючи Remove() метод Вкладення колекція.

У наведеному фрагменті коду показано, як видалити вкладення:

Завантажте або створіть MailMessage екземпляр.
Додайте один або кілька вкладень.
Видаліть потрібне вкладення.
За бажанням відобразіть залишкові вкладення.

Відображення імен файлів вкладень

Ви можете перебрати всі вкладення та вивести їхні назви у консоль:

Витягування вкладень з листа

Щоб витягти та зберегти вкладення з існуючого файлу листа, виконайте наведені нижче кроки:

Завантажте лист, використовуючи MailMessage клас.
Перебрати Вкладення колекція.
Збережіть кожне вкладення на диск і за бажанням відобразіть його назву.

У наведеному фрагменті коду показано, як витягти вкладення електронної пошти:

|Витягнуті вкладення в електронному листі| | :- | ||

Читання опису вмісту вкладення

Aspose.Email дозволяє читати заголовок Content-Description вкладення для додаткових метаданих.

Зразок коду

Робота з вбудованими об’єктами

Вбудований об’єкт — це файл, створений в одній програмі та включений у інший документ або лист. Наприклад, електронна таблиця Microsoft Excel може бути вбудована в документ Word, або зображення може бути вбудоване безпосередньо в тіло листа.

Коли об’єкт вбудовується (а не просто прикріплюється чи посилається), він зберігає свій оригінальний формат і може бути відкритий або відредагований у рідному додатку.

Вбудовування об’єктів в електронний лист

Щоб вбудувати зображення або інший об’єкт у лист, використовуйте LinkedResource клас разом з MailMessage і AlternateView класи. Це дозволяє включати вбудовані зображення або медіа‑контент, який з’являється безпосередньо в тілі листа.

У наведеному прикладі коду показано, як створити лист з одночасним простим текстом та HTML‑вмістом, що містить вбудоване зображення:

Створіть екземпляр MailMessage клас.
Встановіть поля відправника, отримувача та теми.
Створіть простий текстовий тіло, використовуючи AlternateView.
Створіть HTML‑тіло, що містить посилання на вбудований об’єкт, використовуючи cid (Content-ID).
Створіть екземпляр LinkedResource клас і завантажте об’єкт.
Призначте Content-ID пов’язаному ресурсу.
Додайте пов’язаний ресурс та альтернативні вигляди до листа.
Збережіть або надішліть лист.

Примітка: > Ви можете вбудовувати кілька об’єктів, але максимальний розмір листа обмежений вашим поштовим сервером. Наприклад, Gmail обмежує розмір листа 10 МБ.

Витягування вбудованих об’єктів з листа

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

Створіть екземпляр MailMessage клас.
Завантажте файл листа у MailMessage екземпляр.
Переберіть колекцію вкладень.
Збережіть кожен вбудований об’єкт на диск.
За бажанням відобразіть назви файлів у консолі.

|Витягнуті вбудовані об’єкти у листі| | :- | ||

Cpp: Утиліти - MailMessage

Mon, 01 Jan 0001 00:00:00 +0000

Повідомлення з TNEF‑вкладеннями

Transport Neutral Encapsulation Format (TNEF) — це пропрієтарний формат вкладень електронної пошти, який використовується Microsoft Outlook та Microsoft Exchange Server. API Aspose.Email дозволяє читати листи, що містять TNEF‑вкладення, та змінювати їхній вміст. Після цього лист можна зберегти як звичайний лист або у тому ж форматі, зберігаючи TNEF‑вкладення. У цій статті наведено різні приклади коду для роботи з повідомленнями, що містять TNEF‑вкладення. Також у статті показано, як створювати TNEF‑EML файли з Outlook MSG файлів.

Читання повідомлення з збереженням TNEF‑вкладень

Нижче наведено фрагмент коду, який показує, як читати повідомлення, зберігаючи TNEF‑вкладення.

Перевірка повернутих листів

Дуже часто повідомлення, надіслане одержувачу, може повернутися з будь‑якої причини, наприклад, через недійсну адресу отримувача. API Aspose.Email має можливість обробляти таке повідомлення для перевірки, чи є воно повернутим листом, чи звичайним листом. Метод CheckBounced об’єкта MailMessage повертає дійсний результат, якщо лист був повернений. У цій статті показано використання класу BounceResult, який забезпечує можливість перевірки, чи є повідомлення повернутим листом. Також надається докладна інформація про отримувачів, виконані дії та причину сповіщення. Наведений нижче фрагмент коду показує, як обробляти повернені листи.

Cpp: Робота з вкладеннями TNEF у Aspose.Email for C++

Mon, 01 Jan 0001 00:00:00 +0000

Transport Neutral Encapsulation Format (TNEF) — це пропрієтарний формат вкладень електронної пошти, який використовується Microsoft Outlook та Exchange Server. Ці вкладення часто містять багаті дані повідомлення, такі як форматований текст, вбудовані зображення або запити на зустрічі.

Aspose.Email for C++ забезпечує повну підтримку читання та збереження TNEF‑вкладень під час завантаження електронних листів. Ви можете отримати доступ і змінити вміст TNEF‑вкладень, а потім зберегти повідомлення у його оригінальному або іншому форматі, зберігаючи всі вбудовані дані.

Читати листи, зберігаючи TNEF‑вкладення

Щоб завантажити електронний лист і зберегти його TNEF‑вкладення, використовуйте MsgLoadOptions клас та встановіть PreserveTnefAttachments властивість для true.

У наведеному прикладі показано, як завантажити та відобразити імена вкладень з повідомлення, що містить дані TNEF.

Cpp: Виявлення та обробка повернутих листів за допомогою Aspose.Email for C++

Mon, 01 Jan 0001 00:00:00 +0000

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

Aspose.Email for C++ забезпечує зручний спосіб виявлення та аналізу повернутих листів за допомогою MailMessage і BounceResult класи. The MailMessage::CheckBounced() метод визначає, чи повідомлення є поверненням, і повертає BounceResult об’єкт, що містить докладну інформацію, наприклад:

Чи є повідомлення повернутим
Адреса одержувача
Тип дії повернення
Причина та код стану повернення

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

Наступний приклад коду демонструє, як перевірити, чи лист був повернений, та отримати докладну інформацію про нього: