Documentation – Технічні статті

Net: Чому Aspose.Email

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

Net: Порівняння Aspose.Email.Mail з API Microsoft

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

Порівняння Aspose Email Mail з API Microsoft

System.Web.Mail — це просто обгортка навколо двох COM‑бібліотек: CDONTS.NewMail (знаходиться у cdonts.dll) та CDO.Message (знаходиться у cdosys.dll). Вам також потрібно, щоб вони були встановлені на вашому сервері. За замовчуванням cdonts.dll та cdosys.dll встановлюються разом із Windows NT/2000/XP/2003.

Особливості SmtpMail

Якщо ви розберете клас System.Web.Mail.SmtpMail, ви виявите деякі дивні поведінки:

Він підтримує лише операційні системи Win32NT, наприклад Windows 2000, Windows 2003, Windows XP.
Коли клас SmtpMail надсилає повідомлення електронної пошти, він перевіряє версію ОС. Якщо версія ≤ 4, використовується об’єкт CDONTS.Newmail; для всіх операційних систем з версією > 4 використовується об’єкт CDO.Message.

Ці особливості ускладнюють усунення несправностей, особливо при перенесенні коду на різні операційні системи. Додаток може отримувати несподівані результати на різних ОС. Aspose.Email.Mail — це компонент .NET, написаний повністю керованим кодом на чистому C#. Він не залежить ні від яких COM‑бібліотек, включаючи CDONTS.NewMail або CDO.Message. Використовуючи Aspose.Email.Mail, ви уникаєте виклику некерованого коду у своїх застосунках, підвищуючи надійність і звільняючися від нудного налагодження COM. Aspose.Email.Mail багатий на функції і надає набагато більше можливостей, ніж архітектура System.Web.Mail. System.Net.Mail — це нова реалізація клієнта протоколу SMTP у .NET 2.0. Це також чиста керована реалізація на C#.

Матриця порівняння

Особливості	Aspose.Email.Mail	System.Web.Mail	System.Net.Mail
Функції сумісності
Supports .NET 2.0	X	X	X
Загальні функції
Залежність CDO/CDONTS		X
Чистий керований код	X		X
Автентифікація	X	X	X
Адреса відправника	X	X	X
Адреса отримувачів	X	X	X
HTML‑тіло	X	X	X
Текстове тіло	X	X	X
Bcc/Cc	X	X	X
Надсилання вкладень	X	X	X
Вбудоване зображення	X		X
Кодування тіла (Unicode/ASCII)	X	X	X
Кодування теми (Unicode/ASCII)	X		X
Синхронна модель програмування	X		X
Асинхронна модель програмування	X		X
Унікальні функції
Налаштований заголовок листа	X
Заголовок важливості	X
Заголовок чутливості	X
Заголовок X‑Mailer	X
Відповісти	X
Дата відправлення	X
Злиття листів за шаблоном	X
Злиття листів з DataSet	X
Злиття листів з DataTable	X
Злиття листів з DataReader	X
Масове надсилання з багатопотоковістю	X
Надсилання календаря	X
Надсилання запиту на зустріч	X
Завантаження з формату Microsoft Msg	X
Завантаження з формату Microsoft Mht	X
Збереження у формат Microsoft Mht	X
Збереження у формат Eml	X
Завантаження з формату Eml	X
Завантаження з файлу, сумісного з RFC 822	X
Функції взаємодії
Працює з Aspose.Email.Pop3	X
Працює з Aspose.Email.Imap	X
Працює з Aspose.Email.Mime	X

Net: Різниця між POP3 та IMAP

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

Різниця між POP3 та IMAP

Нижче подано пояснення загальної різниці між поштовими протоколами IMAP та POP3.

POP3 та IMAP

POP3 та IMAP — це поштові протоколи, що працюють з більшістю сучасних поштових клієнтів. Основна їх різниця полягає в способі управління та зберігання листів.

POP3

У POP3‑обліковому записі у вас є лише одна папка: папка Вхідних. Коли ви відкриваєте скриньку, нова пошта переміщується з сервера хоста та зберігається на вашому комп’ютері. Якщо хочете читати старі листи, вам потрібно перейти до того комп’ютера, на якому ви їх останній раз відкривали. (Деякі поштові клієнти дозволяють зберігати листи на сервері, щоб мати доступ до них з кількох місць. Далі – докладніше.)

З таким типом облікового запису вам не треба постійно перебувати підключеним до інтернету. Ви можете підключатися, коли хочете отримати чи надіслати нові повідомлення. Після того, як нові листи завантажено на комп’ютер, ви можете вийти з мережі, щоб їх читати. POP3‑облікові записи підходять, коли ви підключаєтесь через модем до DAS і за це платите, або коли у вас старий комп’ютер.

Обліковий запис IMAP

Використовуючи цей протокол, вся ваша пошта залишається на сервері у декількох папках, деякі з яких ви створюєте самі. Це дозволяє підключатися з будь‑якого комп’ютера та бачити всю вашу пошту і папки. Загалом IMAP підходить, якщо у вас постійне підключення до інтернету або ви перевіряєте пошту з різних місць.

Залишити листи на сервері vs. Видалити листи з сервера

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

Навіщо вибирати IMAP замість POP3 та залишати електронну пошту на сервері? У POP3 ваші повідомлення зберігаються лише на сервері, а у IMAP ваші поштові папки також зберігаються на сервері.

Net: Доступ до Gmail через SSL

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

SMTP

У цій статті показано, як виконати підключитися до сервера Gmail і надіслати електронний лист використовуючи протокол SMTP через SSL.

Підключення до SMTP‑сервера Gmail

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

Надсилання електронного листа

Вищеподаний код налаштував об’єкт SMTPClient для підключення до сервера Gmail. Щоб відправити повідомлення за допомогою того ж об’єкта, створіть MailMessage об’єкт класу та відправити повідомлення за допомогою об’єкта SMTP‑клієнта. Наведений фрагмент коду показує, як задати властивості повідомлення, наприклад тему, одержувача та тіло:

IMAP

У цій статті показано, як виконати низку дій на поштовому сервері з увімкненим SSL, використовуючи протокол IMAP:

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

Підключення до поштового сервера

Використайте Aspose.Email ImapClient об’єкт класу для підключення до поштового сервера. Потрібні адреса сервера, порт, ім’я користувача та пароль, щоб встановити з’єднання. Gmail використовує порт 993 для протоколу IMAP, наведений фрагмент коду показує, як підключитися до Gmail, використовуючи цей порт.

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

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

Збереження повідомлень на локальний жорсткий диск

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

Створення нової папки

Протокол IMAP також дозволяє створити нову папку на поштовому сервері. Це можна зробити простим викликом функції.

Створення нового повідомлення у папці

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

POP3

У цій статті представлені приклади, які використовують протокол POP3 поверх SSL. Щоб підключитися до сервера, захищеного SSL, потрібно визначити SSL‑порт і дві додаткові властивості. Решта коду така ж, як при підключенні до звичайного сервера POP3.

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

Підключитися до SSL‑сервера.
Перевірити статус поштової скриньки
Отримати інформацію про повідомлення
Отримати електронні листи.

Підключення до поштового сервера

Підключіться до поштового сервера з SSL, використовуючи Pop3client клас, як описано нижче.

Перевірка статусу скриньки

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

Перевірка інформації про повідомлення

Цей приклад перевіряє всі повідомлення у скриньці, використовуючи Pop3MessageInfoCollection клас. Використайте Pop3Client.ListMessages() функція для отримання Pop3MessageInfoCollection колекцію. Потім ітеруйте колекцію, щоб прочитати інформацію про повідомлення: ID повідомлення, індекс, тему та розмір

Отримання повідомлень

Щоб отримати повідомлення зі скриньки, використайте Pop3Client метод FetchMessage() класу, щоб отримати повідомлення у MailMessage об’єкт типу. Наступний фрагмент коду показує, як підрахувати кількість електронних листів у скриньці, а потім ітерувати їх, щоб отримати кожен.

Net: Введення шаблонів повторень

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

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

Кожна друга п’ятниця, крім періоду з червня по серпень.
1‑ше число кожного місяця, крім січня, коли має бути 2‑ге.

Шаблони повторень зазвичай є періодичними, але це не обов’язково. Шаблон повторення може бути повністю описаний лише як набір попередньо визначених дат і часу появи. RFC iCalendar визначає компоненти, такі як VEVENT або VTODO, які представляють події або завдання. Компоненти можуть мати властивості, такі як дата та час початку, опис, місце, учасники та повторення. Таким чином, шаблон повторення зазвичай існує як властивість повторюваного завдання або події. Властивості шаблону повторення, визначені iCalendar, це:

DTSTART — дата та час початку шаблону (також представляє перше входження, якщо його явно не виключено).
RRULE — визначає правило повторення для набору повторень.
RDATE — визначає список дат і часів, які слід включити до набору повторень.
EXRULE — визначає правило повторення для виключень з набору повторень.
EXDATE — визначає список дат і часів‑виключень з набору повторень.

Лише DTSTART є обов’язковим, і має бути лише один DTSTART. Усі інші властивості є необов’язковими та можуть бути вказані більше одного разу. Aspose.iCalendar приймає рядок у форматі iCalendar і зчитує шаблон повторення у RecurrencePattern об’єкт. Рядок може бути повним описом компонента iCalendar (наприклад, повним VEVENT) або лише фрагментом, що містить лише шаблон повторення. Після завантаження шаблону повторення у об’єкт RecurrencePattern ви можете:

Досліджувати та змінювати шаблон програмно за допомогою методів і властивостей, наданих Aspose.iCalendar
Створити дати/часи випадків у вказаному діапазоні дат.
Зберегти шаблон у форматі iCalendar.

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

Подивіться на зразки шаблонів повторень для ілюстрацій щодо створення шаблонів повторень.

Про модель об’єктів Aspose.iCalendar

Простір імен Aspose.iCalendar містить усі класи, надані компонентом Aspose.iCalendar. RecurrencePattern і RecurrenceRule є центральними класами Aspose.iCalendar і забезпечують конкретні реалізації відповідних елементів RFC 2445.

Клас RecurrencePattern представляє весь шаблон повторення. Ви можете створити новий шаблон повторення з нуля, використовуючи конструктор за замовчуванням, або завантажити існуючий шаблон у форматі iCalendar за допомогою статичного методу FromiCalendar. Клас RecurrenceRule представляє частину RRULE або EXRULE шаблону повторення. RecurrenceRule надає ряд властивостей, які безпосередньо відповідають їх аналогам у стандарті iCalendar. Наприклад, ByMonth відповідає BYMONTH в iCalendar тощо. Перевіряючи або встановлюючи значення властивостей RecurrenceRule, ви можете аналізувати або змінювати правило повторення. Для отримання додаткової інформації та прикладів коду дивіться розділи RecurrencePattern і RecurrenceRule у довіднику API.

Зразки шаблонів

Цей розділ включає наступні теми:

Останній день місяця.
Останній робочий день кожного місяця.
Останній понеділок року.
П’ятниця першого тижня ISO 8601 року.
Перша п’ятниця року.

Останній день місяця

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

RRULE:FREQ=MONTHLY;BYMONTHDAY=-1

Аналогічно, якщо вам потрібна подія за день до останнього дня місяця, використовуйте BYMONTHDAY=-2. Якщо вказати BYMONTHDAY=31, то згідно зі стандартом iCalendar у місяцях, що мають менше 31 дня, подія не буде створена.

Останній робочий день кожного місяця

Ці зразки шаблон повторення вказує останній робочий день місяця, кожного місяця. Робочі дні визначаються як дні, у які ви працюєте. Наприклад, у Європі робочі дні зазвичай з понеділка по п’ятницю.

RRULE:FREQ=MONTHLY;BYDAY=MO,TU,WE,TH,FR;BYSETPOS=-1

Вказане правило визначає всі робочі дні місяця та обирає останній з них. Результатом є останній робочий день місяця.

Останній понеділок року

Цей приклад шаблон повторення вказує подію, що відбувається в останній понеділок року.

RRULE:FREQ=YEARLY;BYDAY=-1MO

П’ятниця першого тижня ISO 8601 року

Цей приклад шаблон повторення вказує п’ятницю першого тижня року. У специфікації ISO 8601 першим тижнем року вважається тиждень, у якому є принаймні чотири дні. Коли рік починається в суботу, наприклад, тиждень 1 — це наступний тиждень, що починається в понеділок, 3 січня.

FREQ=YEARLY;BYWEEKNO=1;BYDAY=FR

Перша п’ятниця року

Цей приклад шаблон повторення вказує подію, що відбувається в першу п’ятницю року.

FREQ=YEARLY;BYDAY=1FR

У 1999 році, наприклад, перша п’ятниця року — 1999/01/01, тоді як п’ятниця першого тижня ISO 8601 — 1999/01/08.

Net: Важливі деталі iCalendar RFC 2445

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

Про модель об’єктів Aspose.iCalendar

The Aspose.iCalendar Простір імен містить усі класи, надані компонентом Aspose.iCalendar. RecurrencePattern і RecurrenceRule є центральними класами Aspose.iCalendar і забезпечують конкретні реалізації відповідних елементів RFC 2445.

Важливі деталі iCalendar RFC 2445

Цей розділ включає наступні теми:

Формати дати та часу.
DATE.
DATE‑TIME з локальним часом.
DATE‑TIME з часом UTC.
DATE‑TIME з локальним часом та часовим поясом.
BYWEEKNO забезпечує відповідність ISO 8601

Формати дати та часу

Дати, або дати з пов’язаними часами, можуть використовуватись у елементах DTSTART, UNTIL, EXDATE та RDATE при визначенні рекурентного шаблону. iCalendar визначає тип значення DATE для ідентифікації значень, що містять календарну дату, а також тип DATE‑TIME для ідентифікації значень, що вказують точну календарну дату та час доби. Значення DATE‑TIME можуть бути зазначені у трьох формах, з:

Локальний час.
Час UTC.
Локальний час та часовий пояс.

DATE

Згідно стандарту iCalendar, значення DATE мають мати формат yyyyMMdd. Наведений приклад представляє 14 липня 1997 року: 19970714

DATE‑TIME з локальним часом

Дата у формі локального часу — це просто значення date‑time, яке не містить позначки UTC і не посилається на часовий пояс. Наприклад, наступне представляє 18 січня 1998 року о 23:00: DTSTART:19980118T230000. Значення date‑time такого типу називаються "плаваючими" і не прив’язані до жодного конкретного часового поясу. Вони використовуються для представлення однакових годин, хвилин і секунд незалежно від того, який часовий пояс наразі застосовується.

DATE‑TIME з часом UTC

Дата з часом у UTC, або абсолютним часом, позначається латинською великою літерою Z наприкінці, що є індикатором UTC, доданим до значення часу. Наприклад, наступне представляє 19 січня 1998 о 07:00 UTC: DTSTART:19980119T070000Z. Зауважте, що Aspose.iCalendar ігнорує суфікс Z у форматі UTC і розглядає час як локальний. Стандарт RFC2445 стверджує, що часова частина, вказана в правилі UNTIL шаблону повторення, має бути у форматі UTC. Це дуже дивне твердження, і насправді в стандарті є приклади, обчислені неправильно. Aspose.iCalendar приймає час у будь‑якому форматі у правилі UNTIL.

DATE‑TIME з локальним часом та часовим поясом

Щоб посилатися на часовий пояс, DATE‑TIME модифікується параметром TZID. Наприклад, наступне представляє 2 години ранку у Нью‑Йорку 19 січня 1998: DTSTART;TZID=US-Eastern:19980119T020000. Зауважте, що наразі Aspose.iCalendar ігнорує параметр TZID і розглядає час як локальний.

BYWEEKNO забезпечує відповідність ISO 8601

Використовуйте BYWEEKNO лише коли потрібна відповідність ISO 8601 необхідний. Номери тижнів, визначені згідно ISO 8601, сильно відрізняються від звичних номерів тижнів. За ISO 8601, перший номер тижня календарного року — це перший тиждень року, у якому є принаймні чотири дні. Це правило робить алгоритм специфічним для застосувань, що вимагають відповідності ISO 8601, і практично робить його непридатним для інших випадків. ISO 8601 підтримується деякими європейськими банківськими та фінансовими застосунками. Він також використовується у телебаченні для планування рекламних роликів. Правило BYWEEKNO визначає список номерів тижнів року, розділених комами. Допустимі значення — від 1 до 53 і від 1 до 53. Це відповідає тижням згідно нумерації, визначеної в ISO 8601. BYWEEKNO діє лише для річних (YEARLY) правил.

Net: Парсинг файлів повідомлень Microsoft Outlook

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

За допомогою Aspose.Email ви можете розпарсити повідомлення Microsoft Outlook всього за кілька рядків коду. У цій статті показано, як це зробити. Aspose.Email містить класи для виконання різноманітних програмних задач з Outlook‑повідомленнями. Нижчий приклад коду демонструє, як:

Завантажте лист.
Отримайте тему листа.
Отримайте ім’я відправника.
Отримайте повне тіло листа.
Перевірте, чи є вкладення.
Отримайте імена файлів усіх вкладень і збережіть їх.

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

Net: Отримання сповіщень про успішно надіслані та невдалі повідомлення

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

Коли ви хочете отримати сповіщення про доставку як успішних, так і невдаліх повідомлень, ви можете використати оператор вертикальної риски (|) для DeliveryNotificationOptions властивість MailMessage клас. Нижче наведено фрагмент коду, який показує, як отримувати сповіщення про успішно надіслані та невдалі повідомлення.

Net: Виявлення нових електронних листів на POP3 сервері

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

З використанням POP3-акаунтів ви можете залишати листи на сервері під час їх завантаження та читання. Залишення листів на сервері означає, що вони доступні іншим програмам і користувачам, наприклад, користувачам, які отримують пошту з кількох пристроїв. Або ви можете захотіти завантажувати лише листи, які відповідають певним критеріям, наприклад, листи з певною темою. Для управління поштою ви можете;

Прочитайте всі листи з POP3 сервера за допомогою Aspose.Email.
Завантажте листи у вашу локальну базу даних.

Листи не видаляються, а залишаються на сервері. Перший запуск проходить успішно: всі потрібні листи завантажуються у базу даних. При другому запуску ті ж листи завантажуються знову, оскільки вони все ще перебувають на сервері, що призводить до дублювання записів. Щоб вирішити цю проблему, використовуйте Pop3MessageInfo.UniqueID властивість для перевірки, чи був лист вже завантажений. Унікальний ідентифікатор листа має зберігатися в базі даних: це ключ пошуку для виявлення нових листів.

Виявлення нових повідомлень

Щоб визначити нові листи у списку листів на POP3 сервері:

Підключаєтесь до сервера.
Отримуєте список листів.
Підключаєтеся до бази даних.
Отримуєте список листів.
Порівнюєте списки.
Зберігаєте нові листи у базу даних.

Процес швидший, коли ви:

Отримайте всі унікальні ідентифікатори листів у хеш-таблицю.
Шукати у хеш‑таблиці замість бази даних для кожного електронного листа в циклі foreach(…) .

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

Net: Читання повідомлень електронної пошти з бібліотеки документів Microsoft SharePoint

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

У цій статті показано, як читати повідомлення електронної пошти з бібліотеки документів Microsoft SharePoint. Щоб отримати доступ до файлів у бібліотеці документів SharePoint, на системі має бути встановлено SDK SharePoint. SDK надає необхідний API для входу та доступу до файлів з бібліотеки документів.

Читання повідомлень електронної пошти з SharePoint

Нижче наведені приклади коду передбачають, що файл повідомлення Microsoft Outlook (.msg) вже збережено у папці SharedDocument бібліотеки документів SharePoint. SDK SharePoint використовується для отримання файлу повідомлення у потік і передавання цього потоку екземпляру Aspose.Email MailMessage клас. Клас MailMessage завантажує потік і аналізує файл повідомлення Outlook. Після цього отримуйте доступ до властивостей класу MailMessage, наприклад, тема, текстове тіло, HTML‑тіло тощо, щоб використати інформацію у проєкті Visual Studio. Для отримання інформації про встановлення та налаштування Microsoft SharePoint Server і SDK, будь ласка, зверніться до відповідних розділів у бібліотеці MSDN. Наведений нижче фрагмент коду показує, як читати повідомлення електронної пошти з SharePoint.

Net: Встановлення кодування тексту за замовчуванням у листі

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

У цій статті представлено MailMessage.PreferredTextEncoding властивість і пояснює, як її використовувати. За допомогою цієї властивості ви можете встановити кодування тексту за замовчуванням для наступних властивостей:

From: Відображуване ім’я
To: Відображуване ім’я
Subject
Тіло

Встановлення кодування тексту за замовчуванням

У попередніх версіях Aspose.Email кодування тексту для властивостей from, to, subject та body встановлювалося окремо. Щоб підвищити зручність, ми додали PreferredTextEncoding властивість, що встановлює все одразу. Тепер легше гарантувати, що весь текст у зазначених вище властивостях правильно закодований у листі. Наведений фрагмент коду показує, як використати французьке слово як відображуване ім’я для електронних адрес, теми та тіла листа.

Net: Перетворення файлу повідомлення Outlook (MSG) у зображення TIFF

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

У цій статті ми показуємо, як конвертувати файл Outlook MSG у зображення TIFF.

Спочатку прочитайте файл MSG і конвертуйте його у формат MHTML за допомогою Aspose.Email для .NET. Використайте Aspose.Email.MailMessage клас для завантаження файлу повідомлення.
Після завантаження файлу, викличте MailMessage.Save() метод і збережіть його у потік у форматі MHTML.
Використовуйте Aspose.Words для .NET, щоб конвертувати потік MHTML у TIFF. Використайте Aspose.Words.Document клас для завантаження потоку MHTML.
Нарешті, викличте Document.Save() метод для збереження документа MHTML у TIFF.

Якщо документ містить кілька сторінок, генерується багатосторінковий файл TIFF. Наведені фрагменти коду показують, як конвертувати файл повідомлення Outlook (MSG) у зображення TIFF.

Net: Використання документа Microsoft Word як тіла повідомлення та надсилання електронної пошти

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

У цій статті показано, як використовувати документ Microsoft Word як тіло електронного листа та надсилати його одержувачам. Приклад документа — рахунок-фактура продажу з бази даних Northwind, експортований у формат Microsoft Word. Aspose.Email для .NET працює з мережевими протоколами та функціями Microsoft Outlook і не може обробляти документи Microsoft Word. Щоб обійти це, у прикладах статті використовується Aspose.Words для .NET для завантаження документа Word і перетворення його у формат MHTML. Aspose.Email для .NET використовує документ MHTML у тілі листа.

Використання документів Microsoft Word як тіла електронного листа

Нижче наведені приклади коду, які ілюструють, як надіслати документ Word як тіло електронного листа, використовуючи Aspose.Words для .NET та Aspose.Email для .NET:

Завантажте документ Microsoft Word, використовуючи Aspose.Word для .NET Document клас.
Збережіть його у форматі MHTML.
Завантажте документ MHTML, використовуючи Aspose.Email для .NET MailMessage клас для встановлення тіла електронного листа.
Встановіть інші властивості повідомлення, використовуючи різні MailMessage властивостей та методів класу.
Надішліть електронний лист, використовуючи Aspose.Email для .NET SMTPClient клас.

Вихідний документ, рахунок‑фактура продажу, експортований у Microsoft Word з прикладу Microsoft Northwind, можна бачити нижче.

Коли повідомлення було надіслано та отримано в Microsoft Outlook, воно виглядає так, як нижче.

HTML‑форматування та зображення зберігаються так само, як у вихідному документі, при перегляді в Outlook або веб‑клієнті електронної пошти, такому як Gmail чи Hotmail. Нижче — скріншот повідомлення, відкритого у Gmail у браузері Chrome.

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

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET

// Load a Word document from disk and save it to stream as MHTML
Document wordDocument = new Document(folderPath + "invoice.docx");
MemoryStream mhtmlStream = new MemoryStream();
wordDocument.Save(mhtmlStream, SaveFormat.Mhtml);

// Load the MHTML in a MailMessage object
mhtmlStream.Position = 0;
using (MailMessage message = MailMessage.Load(mhtmlStream, new MhtmlLoadOptions()))
{
    message.Subject = "Sending Invoice by Email";
    message.From = "sender@gmail.com";
    message.To = "recipient@gmail.com";

    // Save the message in MSG format to disk
    message.Save(folderPath + "WordDocAsEmailBody_out.msg", SaveOptions.DefaultMsgUnicode);

    // Send the email message
    using (SmtpClient client = new SmtpClient("smtp.gmail.com", 587, "sender@gmail.com", "password"))
    {
        client.SecurityOptions = SecurityOptions.SSLExplicit;
        client.Send(message);
    }
}

Net: Функції друку Aspose.Email

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

Функції друку

The Aspose.Email.Printing простір імен надає широкий набір можливостей для друку поштових повідомлень у різні формати (XPS або TIFF) та налаштування макетів сторінок. У цій статті описані ці можливості. Існує кілька варіантів, як можна надрукувати електронне повідомлення за допомогою Aspose.Email:

Друк лише тіла повідомлення.
Друк тіла повідомлення та заголовків.
Друк HTML‑тела.
Встановлення макету сторінки.
Автоматично підганяти TIFF під принтер.
Налаштуйте цільовий DPI для вихідного TIFF.

Друк тіла повідомлення

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

Друк заголовків та тіла повідомлення

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

Друк повідомлення з HTML‑тілом

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

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

Aspose.Email.Printing.MailPrinter надає елементи керування для встановлення наступних властивостей макету сторінки:

Існує два прапорці: MailInfo та None
Одиниці вимірювання сторінки можуть бути: дюйм (Inch), піксель (Pixel), пункт (Point), см (Cm) або міліметр (Millimeter).

Наступний фрагмент коду використовує довільні налаштування, щоб проілюструвати використання цих властивостей. Він створює сторінку висотою 20 см і шириною 8 см, з полями 2 см.

Автоматичне підганяння TIFF

Aspose.Email.Printing надає MessageFormattingFlags.AutoFitWidth властивість, яка дозволяє автоматично підганяти TIFF під принтер. Наступний фрагмент коду показує, як використовувати Auto-fit.

Налаштування цільового DPI для вихідного TIFF

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

Net: Використання робочого листа Microsoft Excel як тіла повідомлення та надсилання електронної пошти

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

У цій статті як тіло електронного листа використовується книга Microsoft Excel, яку надсилають одержувачам. Aspose.Email для .NET працює з мережевими протоколами та функціями Microsoft Outlook і не може обробляти книги Microsoft Excel. Щоб подолати це, у прикладах статті використовується Aspose.Cells для .NET для завантаження книги Excel і перетворення її у HTML‑потік. Потім Aspose.Email для .NET використовує цей HTML‑потік у тілі листа. Приклад коду демонструє, як надіслати робочий лист Excel як тіло електронного листа, використовуючи Aspose.Cells для .NET та Aspose.Email для .NET.

Завантаження книги Microsoft Excel за допомогою класу Workbook з Aspose.Cells
Збережіть завантажену книгу у MemoryStream у форматі HTML
Отримайте HTML з потоку у вигляді рядка
Створіть новий об’єкт MailMessage і задайте його HtmlBody HTML‑вмістом зі кроку 3
Надішліть електронний лист, використовуючи клас SmtpClient з Aspose.Email для .NET

Вихідну книгу Excel можна побачити наступним чином:

Після надсилання та отримання повідомлення у Microsoft Outlook, воно виглядає наступним чином:

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

Net: Обгортковий клас для асинхронного завантаження електронних повідомлень за допомогою Aspose.Email

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

Обгортковий клас для завантаження електронних повідомлень

Існує багато випадків, коли потрібна функція часу очікування, щоб перервати дію, яка триває занадто довго. У цій статті представлено зразковий клас, що реалізує функціональність часу очікування під час завантаження файлів EML/MSG, що може призвести до тривалих затримок або помилок завантаження. Оскільки час очікування не стосується безпосередньо операцій читання/запису з диска чи мережі, його доцільно реалізовувати не в API, а на боці користувача, написавши обгортковий клас навколо Aspose.

Скасування довгої роботи потоку можна здійснити за допомогою обгортаючого делегата, який передає посилання на потік, що має бути завершений, у локальну змінну всередині методу, який його запустив. Довгий потік скасовується його перериванням, і контроль повертається до головного застосунку. Нижче наведений приклад коду, що забезпечує обгортковий клас навколо бібліотеки Aspose.Email. Код демонструє приклад використання обгорткового класу.

Зразок програмування з .NET 3.5 і вище

Зразок програмування з .NET 2.0

Приклад використання

Net: Генерувати випадки за шаблоном повторення

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

За допомогою Aspose.Email можна генерувати події, використовуючи шаблон повторення. Ця стаття пояснює як, як саме згенерувати наступну подію і отримати зручні для користувача описання елементів. Події з шаблону повторення календаря MAPI можна генерувати за допомогою Aspose.Email. Наведений нижче фрагмент коду показує, як генерувати події з шаблонів повторення.

Обчислити наступну подію або n наступних подій

Щоб отримати «наступний» випадок, використайте метод GenerateOccurrences з параметром nNextOccurrences=1. Наведений фрагмент коду показує, як згенерувати 20 випадків, використовуючи nNextOccurrences = 20. Результат коду нижче виглядає так:

Отримати дружній для користувача текст для повторення

Дружній для користувача текст правила можна отримати, використовуючи властивість FriendlyText, як показано нижче. Результат коду буде: "Повторювати щомісяця в 1-й і 1-й з кінця дня(днів) місяця, максимум 2 випадки.". Наступний фрагмент коду показує, як отримати дружній для користувача текст для повторення.

Net: Доступ до поштових сервісів за допомогою OAuth

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

Підтримку OAuth 2.0 додано до Aspose.Email, і її можна використовувати для доступу до серверів SMTP, POP3, IMAP та EWS. Загалом, всі сервери, що підтримують токени типу Bearer OAuth 2.0, можуть бути використані з Aspose.Email, однак наші клієнти електронної пошти протестовані на серверах пошти Google та серверах Microsoft Office 365. Доступ до сервера з SmtpClient, Pop3Client, ImapClient і EWSClient за допомогою OAuth може бути реалізовано 2 способами.

Надайте токен доступу безпосередньо у конструктор клієнта електронної пошти. У цьому випадку користувач повинен розуміти, що термін дії токенів обмежений. Коли токен прострочений, клієнт електронної пошти не може бути використаний для доступу до сервера.
Надайте користувацьку реалізацію постачальника токенів на основі ITokenProvider інтерфейс у конструктор клієнта електронної пошти. У цьому випадку клієнт перевіряє час закінчення терміну дії токена і запитує ITokenProvider для отримання нового токену доступу, коли попередній прострочений. Таким чином, клієнт періодично оновлює токени і може працювати з сервером необмежений час. Часто сервіси підтримують простий спосіб оновлення токенів доступу. Наприклад, використання токенів оновлення у сервісах Google або потік автентифікації ROPC у платформі Microsoft Identity може бути використано для реалізації постачальника токенів.

Налаштування облікового запису на відповідному сервері

Наступні статті допоможуть вам налаштувати облікові записи для доступу до поштових сервісів.

Для Office 365
Для Gmail

Доступ до поштових сервісів за допомогою токенів доступу

Наступні приклади коду показують, як підключитися до поштових сервісів, використовуючи токени доступу.

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    "accessToken",
    true,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   "accessToken",
   true,
   SecurityOptions.Auto))
{

}

Доступ до поштових сервісів за допомогою постачальників токенів

Наступні приклади коду показують, як підключитися до поштових сервісів, використовуючи постачальник токенів.

ITokenProvider tokenProvider = TokenProvider.Google.GetInstance(
    "ClientId",
    "ClientSecret",
    "RefreshToken");

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.gmail.com",
    587,
    "user1@gmail.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
   "imap.gmail.com",
   993,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "pop.gmail.com",
   995,
   "user1@gmail.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

Реалізація користувацького ITokenProvider для Office 365

Ви можете використати нижченаведену реалізацію постачальника токенів для доступу до поштових сервісів Office 365.

using JsonConvert = Newtonsoft.Json.JsonConvert;
using Aspose.Email.Clients;
using Aspose.Email.Common.Utils;
using Aspose.Email.Tests.TestUtils;
using Newtonsoft.Json;
using System;
using System.IO;
using System.Net;
using System.Text;

namespace TestNS
{
    /// <summary>
    /// Azure resource owner password credential (ROPC) token provider
    /// https://docs.microsoft.com/en-us/azure/active-directory/develop/v2-oauth-ropc
    /// https://portal.azure.com
    /// https://developer.microsoft.com/en-us/graph/graph-explorer/#
    /// token parser https://jwt.io
    /// </summary>
    internal class AzureROPCTokenProvider : ITokenProvider
    {
        private const string uriFormat = "https://login.microsoftonline.com/{0}/oauth2/v2.0/token";
        private const string bodyFormat =
            "client_id={0}" +
            "&scope={1}" +
            "&username={2}" +
            "&password={3}" +
            "&grant_type={4}";

        private readonly string scope;
        private const string grant_type = "password";
        private readonly object tokenSyncObj = new object();
        private OAuthToken token;
        private readonly string tenant;
        private readonly string clientId;
        private readonly string clientSecret;
        private readonly string userName;
        private readonly string password;

        /// <summary>
        /// Initializes a new instance of the <see cref="AzureROPCTokenProvider"/> class
        /// </summary>
        /// <param name="tenant"></param>
        /// <param name="clientId"></param>
        /// <param name="clientSecret"></param>
        /// <param name="scope"></param>
        /// <param name="userName"></param>
        /// <param name="password"></param>
        /// <param name="scopeAr"></param>
        public AzureROPCTokenProvider(
            string tenant, 
            string clientId, 
            string clientSecret, 
            string userName, 
            string password,
            string[] scopeAr)
        {
            this.tenant = tenant;
            this.clientId = clientId;
            this.clientSecret = clientSecret;
            this.userName = userName;
            this.password = password;
            this.scope = string.Join(" ", scopeAr);
        }

        /// <summary>
        /// Gets oAuth access token. 
        /// </summary>
        /// <param name="ignoreExistingToken">
        /// If ignoreExistingToken is true, requests new token from a server. Otherwise behaviour is depended on whether token exists or not.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </param>
        /// <returns>Returns oAuth access token</returns>
        public virtual OAuthToken GetAccessToken(bool ignoreExistingToken)
        {
            lock (tokenSyncObj)
            {
                if (this.token != null && !this.token.Expired && !ignoreExistingToken)
                    return this.token;
                token = null;
                string uri = string.Format(uriFormat, string.IsNullOrWhiteSpace(tenant) ? "common" : tenant);
                HttpWebRequest request = (HttpWebRequest)HttpWebRequest.Create(uri);
                string body = string.Format(bodyFormat,
                    HttpUtility.UrlEncode(clientId),
                    HttpUtility.UrlEncode(scope),
                    HttpUtility.UrlEncode(userName),
                    HttpUtility.UrlEncode(password),
                    HttpUtility.UrlEncode(grant_type));
                byte[] bytes = Encoding.ASCII.GetBytes(body);
                request.Method = "POST";
                request.ContentType = "application/x-www-form-urlencoded";
                request.ContentLength = bytes.Length;
                MemoryStream ms = new MemoryStream(bytes);
                using (Stream requestStream = request.GetRequestStream())
                    requestStream.Write(bytes, 0, bytes.Length);
                HttpWebResponse response = (HttpWebResponse)request.GetResponse();
                StringBuilder responseText = new StringBuilder();
                bytes = new byte[1024];
                int read = 0;
                using (Stream stream = response.GetResponseStream())
                {
                    while ((read = stream.Read(bytes, 0, bytes.Length)) > 0)
                        responseText.Append(Encoding.ASCII.GetString(bytes, 0, read));
                }
                string jsonString = responseText.ToString();
                AzureTokenResponse t = JsonConvert.DeserializeObject<AzureTokenResponse>(jsonString);
                token = new OAuthToken(
                    t.access_token,
                    TokenType.AccessToken,
                    DateTime.Now.AddSeconds(t.expires_in));
                return token;
            }
        }

        /// <summary>
        /// Gets oAuth access token.
        /// If token exists and its expiration date is not expired returns current token, otherwise requests new token from a server.
        /// </summary>
        /// <returns>Returns oAuth access token</returns>
        public OAuthToken GetAccessToken()
        {
            return GetAccessToken(false);
        }

        /// <summary>
        /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
        /// </summary>
        public virtual void Dispose()
        {
        }
    }

    /// <summary>
    /// A success response contains a JSON OAuth 2.0 response with the following parameters.
    /// </summary>
    public class AzureTokenResponse
    {
        /// <summary>
        /// The requested access token. The calling web service can use this token to authenticate to the receiving web service.
        /// </summary>
        public string access_token { get; set; }

        /// <summary>
        /// Indicates the token type value. The only type that Azure AD supports is Bearer For more information about bearer tokens, 
        /// see The OAuth 2.0 Authorization Framework: Bearer Token Usage (RFC 6750).
        /// </summary>
        public string token_type { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int expires_in { get; set; }

        /// <summary>
        /// How long the access token is valid (in seconds).
        /// </summary>
        public int ext_expires_in { get; set; }

        /// <summary>
        /// The time when the access token expires. 
        /// The date is represented as the number of seconds from 1970-01-01T00:00:00Z UTC until the expiration time.
        /// This value is used to determine the lifetime of cached tokens.
        /// </summary>
        public int expires_on { get; set; }

        /// <summary>
        /// The App ID URI of the receiving web service.
        /// </summary>
        public string resource { get; set; }

        /// <summary>
        /// If an access token was returned, this parameter lists the scopes the access token is valid for.
        /// </summary>
        public string scope { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included the openid scope.
        /// </summary>
        public string id_token { get; set; }

        /// <summary>
        /// Issued if the original scope parameter included offline_access.
        /// </summary>
        public string refresh_token { get; set; }
    }
}

Наступні приклади коду показують, як підключитися до сервісів Office 365, використовуючи користувацький постачальник токенів.

ITokenProvider tokenProvider = new AzureROPCTokenProvider(
    "Tenant",
    "ClientId",
    "ClientSecret",
    "EMail",
    "Password",
    scopes);

// Connecting to SMTP server
using (SmtpClient client = new SmtpClient(
    "smtp.office365.com",
    587,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLExplicit))
{

}

// Connecting to IMAP server
using (ImapClient client = new ImapClient(
    "outlook.office365.com",
    993,
    "Test1@test.onmicrosoft.com",
    tokenProvider,
    SecurityOptions.SSLImplicit))
{

}

// Connecting to POP3 server
using (Pop3Client client = new Pop3Client(
   "outlook.office365.com",
   995,
   "Test1@test.onmicrosoft.com",
   tokenProvider,
   SecurityOptions.Auto))
{

}

// Connecting to EWS server
const string mailboxUri = "https://outlook.office365.com/ews/exchange.asmx";
ICredentials credentials = new OAuthNetworkCredential(tokenProvider);
using (IEWSClient ewsClient = EWSClient.GetEWSClient(mailboxUri, credentials))
{

}

Net: Різниця між вбудованими та звичайними вкладеннями

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

Це поширений випадок, коли повідомлення електронної пошти може містити вбудовані зображення в тілі, а також звичайні вкладення, пов’язані з ним. Використовуючи MailMessage клас, вбудовані вкладення можна витягти з LinkedResourceCollection клас, тоді як звичайні вкладення можна отримати/витягти за допомогою AttachmentCollection класу повідомлення. Однак це відрізняється, коли повідомлення завантажується за допомогою класу Aspose.Email.Mapi.MapiMessage, оскільки всі вбудовані зображення та звичайні вкладення доступні користувачеві в одному класі MapiAttachmentCollection. Тому потрібно розробити метод, який би розрізняв вбудоване та звичайне вкладення при використанні MapiMessage.

Використання Aspose.Email для розрізнення вбудованих та звичайних вкладень

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

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

Тіло HTML: У випадку повідомлення з типом тіла HTML, вкладення повинно містити не лише властивість PR_ATTACH_FLAGS (0x37140003), а її значення має бути 0x00000004 для вбудованих вкладень. Якщо ця умова виконана, далі залежить від тегів PR_ATTACH_CONTENT_LOCATION та PR_ATTACH_CONTENT_ID для визначення характеру вкладення. Однак за відсутності тегу PR_ATTACH_FLAGS Mapi, вкладення перевіряється за властивістю PR_ATTACH_DISPOSITION (0x3716001F або 0x3716001E) для визначення типу вкладення.

Тіло RTF: Якщо тіло у форматі RTF, тоді всі OLE‑вкладення є вбудованими. Значення PR_ATTACH_METHOD для всіх OLE‑вкладень дорівнює 0x00000006.

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

Net: Надсилання листа за допомогою DNS

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

Іноді надсилання електронних листів через SMTP‑сервер не відповідає вимогам проєкту. Ми можемо захотіти використовувати MX‑запис домену отримувача. Наведений нижче фрагмент коду показує, як надсилати листи, використовуючи поштові сервери домену отримувача.

Net: Видобування даних вбудованих об’єктів

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

Іноді вбудовані OLE-дані представляються у вигляді вкладення "oleData.mso" за MapiAttachment і потребує ручного видобутку. Ці файли oleData.mso мають формат Microsoft Computer Document File (MCDF), і підтримка таких файлів виходить за межі можливостей Aspose.Email. Однак Aspose.Email можна використовувати в комбінації з іншими open-source бібліотеками, такими як OpenMCDF, для читання вмісту таких файлів і збереження їх на диск. Aspose.Email надає InlineAttachmentExtractor клас для перелічення MSO‑пакетів з бінарних даних oledata.mso, які потім можна використовувати для видобування вмісту за допомогою бібліотек читання Compound Files.

Якщо тип тіла листа — HTML (не RTF), і в листі є OLE‑об’єкти, властивість MapiPropertyTag.PR_ATTACH_DATA_OBJ відсутня. У такому випадку інформація про OLE‑об’єкти міститься у файлі oldedata.mso.

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

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

Перелічіть пакети MSO у бінарних даних вкладення oledata.mso
для кожних OLE‑даних прочитайте CompoundFile
Прочитайте потік за допомогою CONTENTS
Збережіть вміст у FileStream

Net: Збереження електронного листа у формат PDF

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

У цій статті показано, як конвертувати електронний лист у PDF за допомогою Aspose.Email. Aspose.Email для .NET працює з мережевими протоколами та функціями Microsoft Outlook і не може виконати пряме перетворення у PDF. Щоб подолати це, у прикладах статті використовується Aspose.Email для перетворення електронного листа у потік MHTML, а потім Aspose.Words для .NET завантажує цей потік MHTML і зберігає його у PDF. Електронний лист може містити також вкладення. Оскільки кожне вкладення може мати різний медіа‑тип, Aspose.Email ігнорує ці вкладення під час конвертації у MHTML, тобто лише вбудовані зображення в повідомленні будуть частиною MHTML, а всі звичайні вкладення будуть проігноровані.

Конвертація електронного листа у PDF

Нижче наведено код, який демонструє конвертацію електронних листів у PDF за допомогою Aspose.Email у поєднанні з Aspose.Words для .NET. Це включає такі кроки:

Завантажте електронний лист за допомогою MailMessage
Зберегти лист у MemoryStream у форматі MHTML
Завантажити потік за допомогою Aspose.Words
Зберегти лист у PDF

Вихідний лист можна бачити наступним чином:

Отриманий PDF виглядає так, як на наведеному зображенні:

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

string dataDir = RunExamples.GetDataDir_KnowledgeBase();
MailMessage mailMsg = MailMessage.Load(dataDir + "message3.msg");
MemoryStream ms = new MemoryStream();
mailMsg.Save(ms, Aspose.Email.SaveOptions.DefaultMhtml);

// create an instance of LoadOptions and set the LoadFormat to Mhtml
var loadOptions = new Aspose.Words.Loading.LoadOptions();
loadOptions.LoadFormat = LoadFormat.Mhtml;

// create an instance of Document and load the MTHML from MemoryStream
var document = new Aspose.Words.Document(ms, loadOptions);

// create an instance of HtmlSaveOptions and set the SaveFormat to Html
var saveOptions = new Aspose.Words.Saving.PdfSaveOptions();
document.Save(dataDir + "SaveEmailAsPDF_out.pdf", saveOptions);

Net: Надсилання запиту на зустріч з повторенням

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

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

Створення запиту на зустріч з повторенням

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

Надіслати запит оновлення призначення

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

Net: Підтримка багатопотоковості в поштових клієнтах

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

Поштові клієнти, такі як ImapClient і Pop3Client, дозволяють використовувати їх у багатопоточному середовищі. Поштові клієнти можуть мати одне або кілька підключень до сервера. Для керування набором підключень в середині клієнтів використовується пул підключень. Кількість підключень, які можуть бути створені та використані одночасно, обмежується властивістю CredentialsByHostClient.MaxConnectionsPerServer. Це значення можна встановити рівним 1 або більшому. За замовчуванням воно дорівнює 10. Для підключення реалізовано чергу команд, щоб підтримувати багатопоточні операції. Команди реалізують прості операції, визначені протоколом, такі як Noop, Authenticate тощо. Користувач може ініціювати виконання більшої кількості команд, ніж доступних підключень. Однак вони будуть виконані лише тоді, коли клієнт зможе створити підключення для операції.

Методи використання поштових клієнтів у багатопоточному середовищі

Поштові клієнти мають таку поведінку:

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

2. Якщо MaxConnectionsPerServer > 1, клієнт створює необхідну кількість з’єднань, виконує автентифікацію та авторизацію для кожного з’єднання. Одне з’єднання зарезервовано як головне з’єднання. Це з’єднання підтримується у робочому стані до моменту, коли клієнт буде звільнений. Інші з’єднання створюються та звільняються за потребою. Максимальна кількість таких з’єднань визначається властивістю MaxConnectionsPerServer, наприклад, якщо MaxConnectionsPerServer = 2, то одне зарезервовано як головне з’єднання, а друге використовується як додаткове для операцій, які виконуються в інших потоках. Аналогічно, якщо MaxConnectionsPerServer = 3, то перше з’єднання зарезервовано як головне, а два інші використовуються як додаткові для операцій в інших потоках. У випадку надходження запиту на з’єднання від нового потоку, і коли всі з’єднання вже зайняті, клієнт чекає, доки кількість використаних з’єднань не зменшиться. Це дуже важливий момент, який пояснює, чому правильне звільнення з’єднань є таким важливим.

Приклади

Користувач може виконувати операції в різних потоках кількома способами. Їх можна розділити на два типи:

1. Користувач використовує асинхронні (Begin/End) методи, визначені в клієнті. У цьому випадку поштовий клієнт запускає нові потоки за потреби. У клієнті реалізована черга задач (будь ласка, не плутайте її з чергою команд у з’єднанні). Задача може бути виконана, якщо з’єднання доступне. Коли кількість використаних з’єднань стає меншою за межеве значення, клієнт створює нове з’єднання, створює потік для поточної задачі і виконує її. Приклад використання асинхронних операцій:

2. Користувач може створювати потоки, використовуючи такі об’єкти, як Thread, ThreadPool, Task або будь‑які інші призначені для цього об’єкти. Також користувач може використовувати потоки, створені в сторонньому коді. При цьому клієнт має два моделі поведінки

a. Якщо користувач не створює додаткових з’єднань для операцій у потоці, всі операції для цього потоку будуть відправлені в чергу команд головного з’єднання. Приклад операцій у додатковому потоці без створення нового з’єднання, всі транзакції виконуються через головне з’єднання:

b. Коли користувач виконує метод створення нового з’єднання для додаткового потоку, цей потік блокується, поки значення квоти для нових з’єднань не буде змінено, щоб дозволити нове з’єднання. Потім нове з’єднання створюється. Це з’єднання встановлюється як дефолтне з’єднання для всіх операцій у цьому потоці. Після завершення всіх операцій у цьому потоці з’єднання має бути звільнене. Для створення нових з’єднань використовуйте метод CredentialsByHostClient.CreateConnection. Цей метод повертає об’єкт, який реалізує інтерфейс IDisposable. Для звільнення з’єднання треба викликати метод Dispose. Створення та звільнення з’єднання повинні виконуватись всередині потоку, у якому виконуються поштові операції. Спроба створити нове з’єднання у потоці, в якому був створений поштовий клієнт, призводить до помилки, оскільки цей потік у даний момент не може бути використаний для створення нового з’єднання. Також створення нового з’єднання неможливе, коли MaxConnectionsPerServer = 1. Приклад коду створення нового з’єднання в додатковому потоці:

Net: Вступ та приклади застосувань

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

Сценарії використання Aspose.Email.Mail

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

Програмне забезпечення для розсилки новин

The Aspose.Email.Mail API можна використовувати для створення надійного застосунку розсилки новин. Використовуючи підтримку Aspose.Email щодо додавання вбудованих об’єктів (наприклад, зображень, звуків тощо), можна створити багаті HTML‑розсилки новин з зображеннями (та іншими вбудованими об’єктами). За допомогою функції масової розсилки API Aspose.Email.Mail також можливо надсилати величезні масові листи за обмежений час. Aspose.Email.Mail також надає можливість створення шаблонів листа‑злиття, що може бути використана для створення шаблону розсилки новин. Шаблон розсилки можна застосовувати для виконання листа‑злиття під час надсилання масових розсилок новин. Існує багато інших можливих завдань, які Aspose.Email.Mail може виконувати у застосунку e‑mail маркетингу.

Інші інструменти маркетингу

Подібно до застосунків розсилки новин, багато інших типів програмного забезпечення можна створити за допомогою Aspose.Email.Mail. Використовуйте його для створення e‑mail маркетингу, масових розсилок та e‑campaign, і багато іншого.

Ділові додатки

Aspose.Email.Mail можна використовувати майже у всіх типах бізнес‑застосунків для виконання утилітних завдань:

Сповіщення електронною поштою: Надсилайте сповіщення, щоб інформувати користувачів про події.
Запити на зустрічі: надсилайте бізнес‑запити на зустрічі, використовуючи підтримку iCalendar в Aspose.Email.Mail.
Електронна розсилка запланованих звітів: звіти є невід’ємною частиною більшості бізнес‑застосунків. Багато бізнес‑звіту генерується періодично. Використовуйте Aspose.Email.Mail для розсилки запланованих звітів електронною поштою.

Поштові клієнти

Aspose.Email.Mail також можна використовувати в поштових клієнтах для надсилання звичайних листів. Він підтримує вкладення, вбудовані об’єкти, події iCalendar, злиття листів, розсилку масових листів тощо, тому Aspose.Email.Mail є найкращим варіантом для створення Windows‑ або веб‑застосунків поштових клієнтів.

Зразок застосунку Aspose.Email.Mail

Щоб продемонструвати використання Aspose.Email.Mail, ми створимо застосунок під назвою ‘My First Email’, що демонструє, як сформувати електронне повідомлення за допомогою Клас MailMessage а потім надішліть його за допомогою класу SmtpClient.

Mail : Кроки створення зразкового додатку

Будь ласка, дотримуйтесь наведених нижче кроків, щоб створити застосунок ‘My First Mail’ за допомогою Aspose.Email.

Відкрийте Visual Studio.
У меню File виберіть New, потім Project. (Виберіть створення Windows‑застосунку на C# або VB.NET).
Якщо у вас є ліцензія, застосуйте її, щоб користуватися повною версією Aspose.Email.
Імпортуйте DLL Aspose.Email у застосунок, клацнувши правою кнопкою миші Reference у Solution Explorer.
Розробіть ваш Windows‑застосунок: створіть інтерфейс, що приймає три поля: From, To та Message.
Двічі клацніть кнопку Send у режимі дизайну та напишіть код у редакторі.
Створіть екземпляр класу MailMessage і використайте його властивості для формування електронного листа. (Екземпляри класу MailMessage використовуються для створення листів, які передаються SMTP‑серверу для доставки за допомогою класу SmtpClient).
Створіть екземпляр класу SmtpClient та використайте його властивості для надсилання електронного листа.
Протестуйте ваш Windows‑застосунок, натиснувши F5.
Введіть адреси у поля From та To.
Введіть повідомлення у поле Message Body.
Клацніть Send.

Вищенаведені кроки описані нижче: двічі клацніть кнопку Send у режимі дизайну та додайте наведений код:

При підключенні до сервера з увімкненим SSL потрібно встановити наступні властивості об’єкта SMTPClient

Висновок

Aspose.Email.Mail це дуже потужний компонент, за допомогою якого розробники можуть виконувати майже всі завдання, пов’язані з електронною поштою, такі як надсилання багатопотокових масових листів, використання листа‑злиття, додавання вкладень, вбудовування зображень та звуків у листи, додавання подій iCalendar до листів, отримання листів та багато іншого.

Aspose.Email.Pop3

Aspose.Email.Pop3 реалізує протокол Post Office Protocol v3 (POP3) у .NET framework. Дозволяє .NET‑розробникам додавати функції запиту та отримання листів у свої застосунки без занурення у деталі протоколу та складність роботи з електронною поштою та мережею. Aspose.Email.Pop3 підтримує всі команди, визначені у стандартному протоколі POP3, і надає прості у використанні інтерфейси разом з компактною та інтуїтивною моделлю об’єктів. Це значно знижує типову криву навчання для .NET‑розробників.

Pop3 : Основні можливості

Як частина Aspose.Email, Aspose.Email.Pop3 розроблений спеціально для .NET і написаний на керованому C# коді. Він дозволяє:

Підключення та вхід до POP3‑серверів.
Підтримка APOP.
Запит повідомлень.
Отримання повідомлень.
Повна підтримка асинхронного стилю програмування.
Підтримка SSL.

Сценарії Aspose.Email.Pop3

Aspose.Email.Pop3 може бути використаний розробниками в різних сценаріях. Нижче наведено кілька прикладів.

Автоматизація ділової електронної пошти

Aspose.Email.Pop3 можна використовувати для запиту поштових скриньок та отримання електронних листів. Він плавно працює з компонентом відправки листів Aspose.Email.Mail. Aspose.Email повністю підтримує автоматизацію електронної пошти. Надсилайте листи за допомогою Aspose.Email.Mail і отримуйте їх за допомогою Aspose.Email.Pop3. Завантажені листи потім можна аналізувати за допомогою Aspose.Email.Mime.

Поштові клієнти

Aspose.Email.Pop3 можна використовувати у поштових клієнтах для отримання листів.

Pop3 : Зразковий додаток

Тут ми продемонструємо, як користуватися Aspose.Email.Pop3. Цей клас має багато функцій, але ми зосередимося на підключенні до сервера POP3 та отриманні листів. Приклад показує, як створити застосунок у Visual Studio, а також приклади коду, що забезпечують роботу застосунку. Дотримуйтесь наведених нижче кроків, щоб створити зразковий застосунок за допомогою Aspose.Email.Pop3.

Відкрийте Visual Studio.
У меню File виберіть New, а потім Project.
Виберіть Windows‑застосунок на C# або VB.NET.
Імпортуйте Aspose.Email.dll у застосунок, клацнувши правою кнопкою миші Reference у Solution Explorer.
Тепер спроектуйте Windows‑застосунок, як показано нижче.
Створіть екземпляр класу Pop3Client.
Встановіть у цьому екземплярі ім’я хоста POP3, логін та пароль.
Викличте функції Connect() та Login() у Pop3Client.
Створіть екземпляр MailMessage і отримайте перший лист у вашому обліковому записі, викликавши функцію FetchMessage(). Це переносить перший лист з вашого облікового запису у екземпляр MailMessage.
Використовуйте властивості From, Subject та HtmlBody екземпляра MailMessage, щоб побачити відправника, тему та тіло повідомлення.

Вищенаведені кроки продемонстровані у наведених нижче прикладах коду. Використовуйте наступний код за будь‑якою кнопкою або у події OnLoad форми.

Для серверів з увімкненим SSL потрібно змінити наступні властивості об’єкта Pop3Client:

Aspose.Email.Imap

Aspose.Email.Imap реалізує протокол Internet Message Access Protocol (IMAP) у .NET‑framework’ах. Aspose.Email.Imap дозволяє .NET‑розробникам швидко додавати можливості IMAP до своїх застосунків, не розбираючись у деталях протоколу. Компонент підтримує отримання та завантаження листів, перевірку статусу листів (новий/прочитаний/непрочитаний) тощо.

Imap : Основні можливості

Aspose.Email.Imap дозволяє:

Отримати листи.
Завантажуйте листи.
Перелічуйте листи у різних папках.
Перевірте статус листів.
Працюйте з MailMessage.
Працюйте з підтримкою SSL.

Використання Aspose.Email.Imap

Aspose.Email.Imap реалізує протокол Internet Message Access Protocol у .NET‑framework’ах. За його допомогою розробники можуть легко запитувати та керувати листами на IMAP‑сервері, а також створювати, видаляти або перейменовувати поштові папки. Використовуючи Aspose.Email.Imap, розробники можуть скористатися можливостями протоколу IMAP за допомогою простих у використанні API. Вони можуть отримувати доступ до листів з будь‑якого ПК, оскільки листи залишаються збереженими на сервері. За допомогою Aspose.Email.Imap розробники можуть створювати веб‑ або десктоп‑застосунки, які отримують і маніпулюють листами з IMAP‑серверів. Aspose реалізував протокол IMAP відповідно до інтернет‑аутентифікації та стандартів RFC. Тому Aspose.Email.Imap — це безпечна та повнофункціональна реалізація протоколу IMAP з легко зрозумілою моделлю об’єктів та інтерфейсами.

Imap : Приклад застосунку

У цій статті пояснюється, як використовувати Aspose.Email.Imap. Ми створюємо невеликий застосунок, який отримує кількість електронних листів у вашому IMAP‑акаунті. Дотримуйтесь наведених нижче кроків, щоб створити зразковий застосунок за допомогою Aspose.Email.Imap.

Відкрийте Visual Studio.
У меню File виберіть New, а потім Project.
Виберіть Windows‑застосунок на C# або VB.NET.
Імпортуйте Aspose.Email.dll у цей застосунок, клацнувши правою кнопкою миші Reference у Solution Explorer.
Створіть екземпляр ImapClient, передавши назву сервера IMAP, логін та пароль.
Викличте функцію Connect() у екземплярі ImapClient, щоб підключитися до серва.
Викличте функцію SelectFolder() у екземплярі ImapClient, щоб обрати папку, в якій потрібно підрахувати кількість повідомлень.
Тепер викличте властивість CurrentFolder.TotalMessageCount екземпляра ImapClient, щоб отримати кількість листів.

Imap : Приклади коду

Нижченаведені приклади коду розміщуються за кнопкою або у події OnLoad форми. Вони показують, як реалізувати вищенаведені кроки за допомогою Aspose.Email.

Для серверів пошти з увімкненим SSL встановіть наступні властивості об’єкта ImapClient:

Aspose.Email.Exchange

Aspose.Email.Exchange дозволяє розробникам керувати листами на Microsoft Exchange Server. Використовуючи цей компонент, ви можете підключатися, перелікати повідомлення та завантажувати листи з поштової скриньки Exchange Server без необхідності розуміти деталі протоколу. Компонент підтримує перелік повідомлень, надсилання листів, завантаження повідомлень та збереження їх у форматах eml або msg на локальному диску тощо.

Exchange : Основні можливості

Aspose.Email.Exchange дозволяє вам:

Підключатися до Microsoft Exchange Server.
Перераховувати листи у скриньках Exchange.
Перераховувати електронні листи з різних папок, наприклад Inbox, Sent, Deleted або Drafts.
Видаляти повідомлення в будь‑якій папці на Exchange Server.

Використання Aspose.Email.Exchange

За допомогою Aspose.Email.Exchange розробники можуть отримати доступ до поштових скриньок Exchange Server з їхніх .NET застосунків. Він надає простий у використанні API для керування електронною поштою на серверах Exchange. Розробники можуть створювати консольні, настільні чи веб-застосунки, які керують електронною поштою у скриньках Exchange.

Aspose.Email.Exchange Приклад застосунку

У цій статті показано, як використовувати Aspose.Email.Exchange. Ми створюємо простий десктопний застосунок, який підключається до поштової скриньки Exchange Server, отримує список повідомлень у папці Inbox та відображає їх у формі Windows.

Exchange : Кроки прикладу застосунку

Відкрийте Microsoft Visual Studio.
Створіть новий проєкт. (Виберіть мову за вашим вибором C# або VB.NET)
Додайте посилання на Aspose.Email.dll у ваш проект, клацнувши правою кнопкою миші по проєкту та вибравши Add Reference у меню.
Створіть форму Windows, схожу на наведену нижче:

Щоб успішно запустити застосунок, потрібні правильні облікові дані для доступу до Exchange Server. Тут ми отримуємо інформацію про облікові дані — URI Exchange Server, ім’я користувача, пароль та домен — з форми Windows. Це дуже проста демонстрація, тому властивості повідомлень — тема, відправник і отримувач — просто відображаються у listbox.

Exchange : Приклади коду

Додайте наступний код у обробник події click кнопки List Messages.

Exchange : Вивід

Цей скриншот показує повідомлення, отримані з Exchange Server. Метод ListMessages() повертає базову інформацію, таку як тема, від, до та ID повідомлення. Щоб отримати повне повідомлення, викличте метод ExchangeClient.SaveMessage(). (Використання ExchangeClient.SaveMessage() описано у статті Збереження повідомлень з поштової скриньки Exchange Server у форматах EML та MSG.)

Aspose.Email.Mime

Multipurpose Internet Mail Extensions (MIME) — це інтернет-стандарт, який розширює формат електронної пошти, щоб підтримувати текст у наборі символів, відмінному від US-ASCII, не‑текстові вкладення, багаточастинні тіла повідомлень та заголовкову інформацію у не‑ASCII наборах символів. Aspose.Email.Mime реалізує протокол MIME у .NET‑фреймворках. Він діє як транслятор, оскільки може читати електронну пошту з файлу (.eml тощо) або з пам’яті (рядок). Потім він розбирає файл або рядок електронної пошти на змістовні частини. Якщо ви хочете обробляти файл електронної пошти без занурення у деталі протоколу MIME, наприклад, щоб витягнути вкладення, використовуйте Aspose.Email.Mime.

Основні функції

Aspose.Email.Mime відмінно працює з Aspose.Email.Pop3 та Aspose.Email.Mail.

Aspose.Email.Pop3 отримує повідомлення електронної пошти з вказаної скриньки.
Aspose.Email.Mail надсилає повідомлення електронної пошти у вказану скриньку.
Aspose.Email.Mime є зв’язком між двома вищезгаданими і аналізує повідомлення електронної пошти.

Net: Скасування запитів на зустріч за допомогою календаря

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

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

Надсилання запитів на зустріч

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

Спочатку створіть екземпляр типу SmtpClient для надсилання повідомлення.
Для збору інформації про учасників ми створили таблицю даних, щоб користувачі могли вводити імена та адреси людей, яким слід надіслати запрошення.
Після виконання циклу for-each по колекції Rows у таблиці, збережіть всю інформацію про учасників у колекції MailAddressCollection.
Створіть екземпляр класу MailMessage та необхідні властивості, такі як From, To і Subject.
Створіть екземпляр типу Appointment і вкажіть місце, час початку, час закінчення, організаторів та учасників.
Збережіть всю інформацію у базі даних SQL Server. Робота з БД виконується у методі SaveIntoDB.

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

Скасування запиту на зустріч

Щоб скасувати запит на зустріч, спочатку отримайте ID повідомлення електронної пошти. Оскільки ми зберегли цю інформацію у базі даних для цього прикладу, її можна легко отримати знову. Ми використали таблицю для завантаження всіх надісланих повідомлень. Скріншот форми наведено нижче:

Вибір рядка, для якого слід надіслати запит на скасування.
Натисніть Send Cancel Request, щоб відправити запит.
Код отримує ID з обраного рядка таблиці та запитує базу даних, щоб отримати інформацію про учасника, повідомлення та календар.
Створіть екземпляри класу Calendar та MailMessage класи, які використовують інформацію, отриману з бази даних.
Використайте метод Appointment.CancelAppointment() для надсилання запиту на скасування.
Надішліть лист за допомогою SMTP.

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

Net: Перша програма з Aspose.Email.Outlook

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

У цьому розділі демонстровано, як використовувати Aspose.Email.Mapi. Ми створюємо невеликий застосунок, який завантажує файл Outlook‑повідомлення (TestMessage.msg) і відображає тему, адреси відправника та одержувача, а також вміст тіла у формі Windows. Дотримуйтесь цих кроків, щоб створити свою першу програму з використанням Aspose.Email.Outlook.

У Visual Studio у меню File виберіть New, потім Project.
Оберіть створення Windows‑застосунку на C# або VB.NET.
Імпортуйте бібліотеку Aspose.Email DLL у застосунок, клацнувши правою кнопкою миші Reference у вікні Solution Explorer. Це буде Windows‑застосунок, який лише показуватиме інформацію, що міститься у файлі повідомлення.
Створіть екземпляр MapiMessage клас, задаючи шлях до файлу листа.
Використайте публічні властивості для відображення теми, відправника, одержувача та вмісту у елементах Windows.

Реалізація наведених вище кроків продемонстрована нижче у наступному фрагменті коду. Використайте цей код за кнопкою Load Msg File або у події OnLoad форми.

Net: Пул з'єднань реформований

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

З випуском Aspose.Email 19.3 пул з’єднань був реформований. Нові EmailClient введено клас, який зрештою замінить CredentialsByHostClient клас. The EmailClient клас забезпечує ConnectionAsgmtMode властивості, яка визначає режим розподілу з’єднань у багатопотоковому середовищі. EmailClient.ConnectionAsgmtMode встановлюється за допомогою ConnectionAsgmtType перелічуваний.

Типи з’єднань

Існують наступні три типи з’єднань:

Основне з’єднання: це з’єднання створюється та знищується разом з поштовим клієнтом. Його не можна створювати або знищувати вручну.
З’єднання за замовчуванням: користувач може створювати з’єднання за замовчуванням для потоків за допомогою CreateConnection метод. Якщо існує з’єднання за замовчуванням, всі методи клієнта, виконані в потоці, будуть неявно використовувати це з’єднання. На один потік може існувати лише одне з’єднання за замовчуванням. Воно може бути створене вручну або автоматично. Це залежить від властивості EmailClient.ConnectionAsgmtMode. Ці з’єднання можна створити вручну за допомогою EmailClient.CreateConnection(createAsDefaultConnection = true) метод. Якщо з’єднання за замовчуванням не використовується (залежно від режиму розподілу з’єднань), замість нього неявно використовується основне з’єднання.
Незалежні з’єднання: це з’єднання, які не прив’язані до потоків. Їх можна створювати вручну і їх необхідно явно передавати як параметр методу. Ці з’єднання можна створити вручну за допомогою EmailClient.CreateConnection() метод або EmailClient.CreateConnection(createAsDefaultConnection = false) метод.

Типи розподілу з’єднань

Щоб налаштувати EmailClient.ConnectionAsgmtMode властивості, ConnectionAsgmtType перелічуваний тип використовується. Типи розподілу, надані ConnectionAsgmtType перераховані нижче.

ConnectionAsgmtType.UseMainOrDefault Цей режим використовується за замовчуванням у клієнтах електронної пошти. Клієнт електронної пошти використовує основне з’єднання для всіх операцій з кількох потоків, якщо з’єднання за замовчуванням не створене, або якщо з’єднання не передано явно як параметр методу. Основне з’єднання — це з’єднання, створене одночасно з клієнтом електронної пошти. Користувач може створювати з’єднання за замовчуванням для потоків з CreateConnection метод. Якщо для потоку створено з’єднання за замовчуванням, воно використовується неявно для всіх методів клієнта електронної пошти, які викликаються в цьому потоці. Якщо з’єднання за замовчуванням для потоку не створено, використовується основне з’єднання для всіх методів клієнта, які викликаються в цьому потоці. Користувач також може створювати з’єднання, не прив’язані до потоків (не за замовчуванням), за допомогою CreateConnection метод. Якщо користувач хоче використовувати інші з’єднання (не основне і не за замовчуванням), він має передати це з’єднання явно як параметр методу, який він бажає використати. Користувач може додатково створювати будь-яку кількість з’єднань. З’єднання за замовчуванням може бути лише одне на потік. Зверніть увагу, що з’єднання за замовчуванням працюють коректно, якщо користувач використовує об’єкти Thread для багатозадачності. Якщо користувач використовує ConnectionPool або об’єкти Task для багатозадачності, цей режим може призвести до неправильного поводження програми. Щоб уникнути цієї проблеми, користувач повинен вручну звільнити з’єднання за замовчуванням (якщо він його використовує) в кінці виконання коду.
ConnectionAsgmtType.UseMain Клієнт електронної пошти використовує основне з’єднання для всіх операцій з кількох потоків. Основне з’єднання — це з’єднання, створене одночасно з клієнтом електронної пошти. Користувач не може створювати з’єднання за замовчуванням. Користувач може створювати з’єднання, не пов’язані з потоками (не за замовчуванням), за допомогою CreateConnection метод. Якщо користувач хоче використовувати інші з’єднання (не основне і не за замовчуванням), він повинен передати це з’єднання явно як параметр методу, який він збирається використовувати.
ConnectionAsgmtType.UseDefault Клієнт електронної пошти неявно використовує лише з’єднання за замовчуванням для всіх операцій з кількох потоків. Основне з’єднання в цьому режимі не використовується. Якщо з’єднання за замовчуванням не було створене для певного потоку (перший виклик методу клієнта електронної пошти), клієнт створює з’єднання за замовчуванням неявно для потоку перед виконанням першої операції. Користувач не може створювати з’єднання за замовчуванням для потоків з CreateConnectionметод, оскільки вони створюються автоматично. Коли для потоку створюється з’єднання за замовчуванням, воно використовується неявно для всіх методів клієнта електронної пошти, які викликаються в цьому потоці. Користувач також може створювати з’єднання, які не прив’язані до потоків (не з’єднання за замовчуванням), за допомогою CreateConnectionметод. Якщо користувач хоче використовувати інші з’єднання (не основне і не за замовчуванням), він повинен передати це з’єднання явно як параметр методу, який він збирається використовувати. Користувач може додатково створювати будь-яку кількість з’єднань. На один потік може бути використане лише одне з’єднання за замовчуванням. Зверніть увагу, що з’єднання за замовчуванням працюють коректно, якщо користувач використовує об’єкти Thread для багатозадачності. Якщо користувач використовує ConnectionPool або об’єкти Task для багатозадачності, цей режим може призвести до неправильного поводження програми. Щоб уникнути цієї проблеми, користувач повинен вручну звільнити з’єднання за замовчуванням в кінці виконання коду.

Documentation – Технічні статті

Net: Чому Aspose.Email

Net: Порівняння Aspose.Email.Mail з API Microsoft

Порівняння Aspose Email Mail з API Microsoft

Особливості SmtpMail

Матриця порівняння

Net: Різниця між POP3 та IMAP

Різниця між POP3 та IMAP

POP3 та IMAP

POP3

Обліковий запис IMAP

Залишити листи на сервері vs. Видалити листи з сервера

Net: Доступ до Gmail через SSL

SMTP

Підключення до SMTP‑сервера Gmail

Надсилання електронного листа

IMAP

Підключення до поштового сервера

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

Збереження повідомлень на локальний жорсткий диск

Створення нової папки

Створення нового повідомлення у папці

POP3

Підключення до поштового сервера

Перевірка статусу скриньки

Перевірка інформації про повідомлення

Отримання повідомлень

Net: Введення шаблонів повторень

Про модель об’єктів Aspose.iCalendar

Зразки шаблонів

Останній день місяця

Останній робочий день кожного місяця

Останній понеділок року

П’ятниця першого тижня ISO 8601 року

Перша п’ятниця року

Net: Важливі деталі iCalendar RFC 2445

Про модель об’єктів Aspose.iCalendar

Важливі деталі iCalendar RFC 2445

Формати дати та часу

DATE

DATE‑TIME з локальним часом

DATE‑TIME з часом UTC

DATE‑TIME з локальним часом та часовим поясом

BYWEEKNO забезпечує відповідність ISO 8601

Net: Парсинг файлів повідомлень Microsoft Outlook

Net: Отримання сповіщень про успішно надіслані та невдалі повідомлення

Net: Виявлення нових електронних листів на POP3 сервері

Виявлення нових повідомлень

Net: Читання повідомлень електронної пошти з бібліотеки документів Microsoft SharePoint

Читання повідомлень електронної пошти з SharePoint

Net: Встановлення кодування тексту за замовчуванням у листі

Встановлення кодування тексту за замовчуванням

Net: Перетворення файлу повідомлення Outlook (MSG) у зображення TIFF

Net: Використання документа Microsoft Word як тіла повідомлення та надсилання електронної пошти

Використання документів Microsoft Word як тіла електронного листа

Net: Функції друку Aspose.Email

Функції друку

Друк тіла повідомлення

Друк заголовків та тіла повідомлення

Друк повідомлення з HTML‑тілом

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

Автоматичне підганяння TIFF

Налаштування цільового DPI для вихідного TIFF

Net: Використання робочого листа Microsoft Excel як тіла повідомлення та надсилання електронної пошти

Net: Обгортковий клас для асинхронного завантаження електронних повідомлень за допомогою Aspose.Email

Обгортковий клас для завантаження електронних повідомлень

Зразок програмування з .NET 3.5 і вище

Зразок програмування з .NET 2.0

Приклад використання

Net: Генерувати випадки за шаблоном повторення

Обчислити наступну подію або n наступних подій

Отримати дружній для користувача текст для повторення

Net: Доступ до поштових сервісів за допомогою OAuth

Налаштування облікового запису на відповідному сервері

Доступ до поштових сервісів за допомогою токенів доступу

Доступ до поштових сервісів за допомогою постачальників токенів

Реалізація користувацького ITokenProvider для Office 365

Net: Різниця між вбудованими та звичайними вкладеннями

Використання Aspose.Email для розрізнення вбудованих та звичайних вкладень

Net: Надсилання листа за допомогою DNS

П’ятниця першого тижня ISO 8601 року

Зразок програмування з .NET 3.5 і вище

Зразок програмування з .NET 2.0