Створення та налаштування вмісту електронних листів

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

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

• Створіть екземпляр класу MailMessage.
• Встановіть властивості листа.
• Збережіть лист у різних форматах.

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

Вказування декількох отримувачів

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

• To – Адреси отримувачів можна вказати у полі ‘To’. Отримувачі в полі ‘To’ є основною аудиторією повідомлення. Може бути більше однієї адреси отримувача.
• Cc – CC означає «копія», або «ввічлива копія», і дозволяє додати отримувачів листа, які повинні його бачити, але не обов’язково повинні діяти за ним. Наприклад, менеджери чи члени вашої команди, яким потрібно бути в курсі розмови. За допомогою Aspose.Email можна вказати адреси CC у вашому коді. Таким чином, автоматичні листи або всі листи на певну адресу можуть копіюватися відповідальним особам.
• Bcc – Bcc (прихована копія) дозволяє надсилати лист отримувачу, який прихований від інших отримувачів. Там, де CC з’являється в інформації листа, яку бачать головні отримувачі, Bcc не відображається. Це призначено для прихованого сповіщення. 

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

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

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

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

Нижче наведені приклади коду демонструють, як замінити електронні адреси на дружні імена у листі. Дружнє ім’я — це назва, більш зрозуміла, ніж сама адреса, наприклад John Smith замість [e-mail]. При надсиланні листа можна пов’язати дружнє ім’я з електронною адресою у конструкторі класу 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.

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

Функції MailMessage

The MailMessage class представляє вміст електронного листа. Екземпляри the MailMessage class використовується для створення електронного листа, який передається SMTP‑серверу для доставки за допомогою the SmtpClient class. У цій статті показано, як використовувати MailMessage class містить утилітні функції для керування наступними можливостями електронної пошти:

• Date and time - Через the MailMessage Власність class Date дозволяє отримувати або встановлювати дату та час електронного листа.
• Пріоритет повідомлення – MailPriority клас визначає рівні пріоритету для відправки електронного листа. Він може бути низьким, звичайним або високим. Пріоритет впливає на швидкість передачі та доставку.
• Чутливість повідомлення – MailSensitivity клас визначає п’ять рівнів чутливості.
• Повідомлення про доставку – Повідомлення про доставку інформують відправників про те, що їх лист було доставлено у вхідні повідомлення одержувача.

За замовчуванням, дата – це фактична дата, коли повідомлення було надіслано, а час – час його відправки, як відображає Microsoft Outlook. Однак реальний час доставки електронної пошти додається самим SMTP‑сервером у заголовку листа. Наприклад, нижче наведено типовий заголовок листа, у якому поле Date задає дату.

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

Запит підтвердження прочитання

Нижче наведені програмні приклади, які показують, як можна запросити підтвердження прочитання. The MailMessage клас DeliveryNotificationOptions Властивість Enumeration описує параметри повідомлення про доставку електронного листа. Щоб запросити підтвердження прочитання після відправлення листа, виконайте такі кроки:

1. Створіть екземпляр MailMessage клас.
2. Вкажіть відправника, отримувача та HTML‑тіло листа у MailMessage екземпляр.
3. Вкажіть DeliveryNotificationOptions в інших MailMessage екземпляри.
4. Створіть екземпляр SmtpClient клас та надішліть лист за допомогою методу Send.

Запити на підтвердження прочитання можуть не завжди виконуватись, бо:

• Клієнт електронної пошти може не реалізовувати цю функцію.
• У кінцевого користувача ця функція може бути вимкнена.
• Кінцевий користувач може вирішити не надсилати його.

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

Встановити заголовки листа

Заголовки листа відповідають інтернет-стандарту, а RFC визначають поля заголовків, які включаються до інтернет‑повідомлень електронної пошти. Заголовок листа можна вказати за допомогою класу MailMessage. Типові типи заголовків визначені у класі HeaderType. Це запечатаний клас, що працює як звичайне перерахування.

Зазвичай заголовок електронного листа містить ці поля:

• To: Адреси одержувачів можна вказувати у полі To. Одержувачі у полі To — основна аудиторія повідомлення. Можна вказати більше однієї адреси одержувача.
• From: Це поле містить електронну адресу відправника повідомлення.
• Cc: Дозволяє користувачам надсилати повідомлення як «Carbon Copy» або «Courtesy Copy». Тобто одержувач не зобов’язаний відповідати чи діяти. Зазвичай це використовується для інформування керівного персоналу.
• Bcc: Скорочення від Blind Carbon Copy, означає надсилання повідомлення кільком одержувачам таким чином, щоб отримані листи не містили повного списку одержувачів. Призначено для прихованих сповіщень.
• ReplyTo: Це поле заголовка вказує, куди відправник хоче отримувати відповіді.
• Subject: Заголовок, назва, тема. Часто використовується як індикатор теми для повідомлень, що відповідають або коментують інші повідомлення.
• Date: Цей заголовок вказує дату (і час). Зазвичай це дата, коли повідомлення було створено та відправлено.
• XMailer: Інформація про клієнтське програмне забезпечення відправника. Приклад: X-Mailer: Aspose.Email XMailer використовується поштовими клієнтами. Різні поштові клієнти мають різні значення XMailer. Значення XMailer в MS Outlook — Microsoft Office Outlook, Build 11.0.5510. Воно ігнорується отримувачем електронної пошти або програмою для читання листів.

Зазвичай заголовок електронного листа виглядає приблизно так:

 Reply-To: [e-mail]

From: [e-mail]

To: [e-mail]

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

Щоб налаштувати заголовок електронного листа, виконайте такі кроки:

• Створіть екземпляр MailMessage клас.
• Вкажіть To, From, CC, Bcc, ReplyTo, Subject, Date та XMailer, використовуючи екземпляр MailMessage.
• Створіть екземпляр MimeHeader клас і вкажіть секретний заголовок.
• Додайте секретний заголовок до MailMessage екземпляр.

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

Наведений вище фрагмент коду створює заголовок листа у такому форматі. Це можна спостерігати, відкривши отриманий файл "MsgHeaders.msg" у Microsoft Outlook і переглянувши його властивості.

 Reply-To: [e-mail]

From: [e-mail]

To: [e-mail]

CC: [e-mail]

BCC: [e-mail]

Subject: test mail

Date: 6 Mar 2006 8:2:2 +0800

X-Mailer: Aspose.Email

secret-header: mystery

Вставити заголовок у конкретному місці

The Додати метод HeadersCollection клас вставляє заголовок у кінець колекції. Однак іноді може бути необхідно вставити заголовок у певне місце. У такому випадку, Додати метод не допоможе. Щоб досягти цього, використайте Insert метод HeadersCollection. Якщо колекція містить заголовки з однаковою назвою, цей заголовок буде вставлений перед іншими заголовками з тією ж назвою. Наступний фрагмент коду показує, як вставити заголовок у конкретне місце.

Додавання власних заголовків до листа

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

1. Створіть екземпляр MailMessage клас.
2. Вкажіть значення to, from та subject, використовуючи екземпляр MailMessage.
3. Додайте секретний заголовок у MailMessage екземпляр.
4. Створіть екземпляр класу SmtpClient і надішліть лист, використовуючи метод Send.

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