Documentation – Работа с MIME съобщения, използвайки C++ Email Parser API

Cpp: Създаване и персонализиране на имейл съобщения с помощта на Aspose.Email за C++

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

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

Създаване на ново имейл съобщение

Следният примерен код демонстрира как да създадете и конфигурирате ново имейл съобщение, използвайки Aspose.Email за C++.

Създайте инстанция на MailMessage клас.
Задайте свойства на съобщението като From, To, Cc, Subject и HtmlBody.
По желание, запазете съобщението в множество формати (EML, MSG, MHTML и др.).

Използване на приятелски имена за имейл адреси

Приятелско име прави имейл адреса по‑четим. Например, John Smith <jsmith@domain.com> вместо просто jsmith@domain.com.

Можете да свържете приятелски имена с адреси, когато създавате имейл, като използвате MailMessage клас.

Кодът по-долу демонстрира как да добавите приятелски имена:

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

Задаване на съдържание на тялото на имейла

Този MailMessage класът ви позволява да дефинирате тялото на имейла във HTML формат. Също така можете да предоставите алтернативни изгледи за различни имейл клиенти, използвайки AlternateView клас.

Задаване на HTML тяло

Следният пример с код показва как да зададете HTML съдържанието на имейл съобщението, като присвоите HTML низ на set_HtmlBody свойство. Използването на този низ като тяло на съобщението указва, че имейлът ще бъде изпратен с HTML форматиране вместо обикновен текст.

Задаване на алтернативен текст

Някои имейл клиенти не могат да показват HTML съдържание. За да осигурите, че съобщението ви е четливо за всички получатели, можете да добавите алтернативна обикновена текстова версия, използвайки AlternateView клас. Той ви позволява да включите множество версии на имейл съобщение в различни формати. Например, ако основното ви тяло е HTML, можете също така да добавите обикновена текстова версия като алтернатива.

Примерът с код по-долу показва как да създадете имейл съобщение и да добавите алтернативен изглед, съдържащ обикновен текст, към него.

Този 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 в колекцията и се разрешават.
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 клас.
Заредете имейл съобщение в MailMessage екземпляр.
Покажете желаните свойства (например From, To, Subject и Body) в конзолата.

Забележка: За пълни примери и файлове с данни, посетете Aspose.Email за C++ GitHub репозитория.

Извличане на имейл хедъри

Имейл заглавка е набор от метаданни, които описват съобщението, включително информация за маршрутизация, тип на съдържанието, кодиране и данни за подател/получател.

Aspose.Email за C++ ви позволява да извличате и работите с тези заглавки, използвайки MailMessage клас.

Най-често срещаните типове заглавки са достъпни чрез HeaderType клас, който предоставя именовани константи за стандартните полета на заглавките.

Следният кодов откъс показва как да извлечете имейл заглавки:

Създайте инстанция на MailMessage клас.
Заредете имейл файл в инстанцията.
Извлечете колекцията от заглавки, като използвате get_Headers() метод.
Итерирайте през колекцията, за да прочетете или покажете имена и стойности на заглавките.

Получаване на декодирани стойности на заглавието

Някои имейл заглавки могат да съдържат кодиран текст (например, теми или потребителски заглавки, използващи кодиран текст). Можете лесно да извлечете декодирана стойност, като използвате GetDecodedValue() метод на HeaderCollection клас.

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

Cpp: Зареждане и запазване на имейл съобщения с Aspose.Email за C++

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

Aspose.Email за C++ предоставя гъвкави възможности за зареждане, запазване и конвертиране на имейл съобщения в множество формати, включително EML, MSG, MHTML и HTML. Можете също така да персонализирате опциите за зареждане и запазване, за да се справите с изискванията за кодиране, прикачени файлове и форматиране.

Зареждане на съобщение с персонализирани опции за зареждане

Този MailMessage класът може да зарежда съобщения от различни формати като EML, MSG, MHTML и HTML, използвайки специализирани опции за зареждане. Тези опции позволяват на разработчиците да задават предпочитания за кодиране, да запазват прикачени файлове и да управляват вградени ресурси.

Следният пример на C++ показва как да заредите имейл съобщения, използвайки различни опции за зареждане.

Запазване на имейл съобщения в различни формати

Aspose.Email за C++ позволява конвертиране на съобщения между формати като EML, MSG, MHTML и HTML. Разработчиците могат да използват SaveOptions йерархия на класовете за задаване на разширени параметри за запазване, включително кодиране, TNEF прикачени файлове и запазване на граници.

Наличните опции за запазване включват:

EmlSaveOptions
MsgSaveOptions
MhtSaveOptions
HtmlSaveOptions

Запазване на имейл като EML

Следният кодов фрагмент показва как да заредите EML съобщение и да го запишете на диск в същия формат.

Запазване на оригиналните EML граници

Може да запазите оригиналните MIME граници при запазване на EML файл.

Запазване на TNEF прикачени файлове в EML

Следният пример с код показва как да запазите имейл, като запазите TNEF (Transport Neutral Encapsulation Format) прикачени файлове.

Convert EML to MSG

Лесно можете да конвертирате EML файл в Outlook MSG формат. Следният кодов фрагмент показва как да заредите EML съобщение и да го конвертирате в MSG, използвайки подходящата опция от SaveOptions клас.

Запис като MHTML

Следният пример демонстрира как да заредите EML съобщение и да го запишете като MHTML файл.

Експортиране към MHT с персонализиран часови пояс

Можете да зададете персонализиран или системен часови пояс за полетата на датата на съобщението преди експортиране към MHT формат. MailMessage клас предоставя TimeZoneOffset свойство за задаване на персонализиран часови пояс. Следният кодов фрагмент показва как да експортирате имейл към MHT с персонализиран часови пояс.

Експортиране на имейл към EML

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

Cpp: Помощни функции - MailMessage

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

Имейл съобщения, съдържащи TNEF прикачени файлове

Transport Neutral Encapsulation Format (TNEF) е собственически формат за имейл прикачени файлове, използван от Microsoft Outlook и Microsoft Exchange Server. Aspose.Email API позволява да четете имейл съобщения с TNEF прикачени файлове и да променяте съдържанието им. Имейлът може след това да се запише като обикновен имейл или в същия формат, като се запазват TNEF прикачени файлове. Тази статия показва различни примерни кодове за работа със съобщения, съдържащи TNEF прикачени файлове. Тя също демонстрира създаването на TNEF EML файлове от Outlook MSG файлове.

Четене на съобщение с запазване на TNEF прикачени файлове

Следният кодов фрагмент показва как да прочетете съобщение, запазвайки TNEF прикачени файлове.

Проверка на отскочени съобщения

Много често съобщение, изпратено до получател, може да се откаже по каквато и да е причина, като например невалиден адрес на получателя. Aspose.Email API има възможност да обработва такова съобщение, за да провери дали е отскочил имейл или редовно имейл съобщение. Методът CheckBounced на MailMessage връща валиден резултат, ако имейлът е отскочил. Тази статия показва употребата на класа BounceResult, който предоставя възможност за проверка дали съобщението е отскочил имейл. Той също така дава подробна информация за получателите, предприетото действие и причината за известието. Следният кодов фрагмент показва как да обработите отскочени съобщения.

Cpp: Работа с прикачени файлове и вградени обекти с помощта на C++ API

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

Работа с прикачени файлове

Имейл прикачени файлове са файлове, изпратени заедно с имейл съобщение. Тези файлове могат да включват документи, изображения, архиви и други.

В Aspose.Email за C++ прикачени файлове се управляват чрез Attachment клас, който работи заедно с MailMessage клас. Можете да добавяте, премахвате, извличате или показвате прикачени файлове програмно.

Забележка: Максималният размер на прикачения файл зависи от пощенския сървър (например, Gmail ограничава прикачените файлове до 10 MB).

Try it out!

Добавяйте или премахвайте имейл прикачени файлове с безплатния 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 MB.

Извличане на вградени обекти от имейл

Можете също така да извлечете вградени обекти, като изображения или файлове, от съществуващо имейл съобщение. Процесът е подобен на извличането на прикачени файлове:

Създайте инстанция на MailMessage клас.
Заредете имейл файла в MailMessage екземпляр.
Итерирайте през колекцията от прикачени файлове.
Запазете всеки вграден обект на диск.
По желание, покажете имената на файловете в конзолата.

|Извлечени вградени обекти в имейл| | :- | ||

Cpp: Работа с TNEF прикачени файлове в Aspose.Email за C++

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

Transport Neutral Encapsulation Format (TNEF) е собствен proprietарен формат за имейл прикачени файлове, използван от Microsoft Outlook и Exchange Server. Тези прикачени файлове често съдържат богати данни като форматиран текст, вградени изображения или покани за срещи.

Aspose.Email за C++ предоставя пълна поддръжка за четене и запазване на TNEF прикачени файлове при зареждане на имейл съобщения. Можете да достъпвате и променяте съдържанието на TNEF прикачените файлове и след това да запишете съобщението в оригиналния му или в друг формат, като запазвате всички вградени данни.

Четене на имейли с запазени TNEF прикачени файлове

За да заредите имейл съобщение и запазите неговите TNEF прикачени файлове, използвайте MsgLoadOptions клас и задайте PreserveTnefAttachments свойство за true.

Следният пример демонстрира как да заредите и покажете имената на прикачените файлове от съобщение, съдържащо TNEF данни.

Cpp: Откриване и обработка на отскочени имейли с Aspose.Email за C++

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

При изпращане на имейли, някои съобщения може да не достигнат до получателите си, например поради невалиден адрес на получателя или пълен пощенски кутия. Тези недоставени съобщения се наричат отскочени имейли.

Aspose.Email за C++ предоставя удобен начин за откриване и анализиране на отскочени съобщения, използвайки MailMessage и BounceResult класове. The MailMessage::CheckBounced() методът определя дали съобщението е отскок и връща BounceResult обект, който съдържа подробна информация като:

Дали съобщението е отскочено
Адресът на получателя
Типът на действието при отскок
Причината и статус кодът на отскока

Това позволява на разработчиците автоматично да идентифицират провали при доставката и да предприемат подходящи действия, като почистване на невалидни адреси от списъците за разпращане.

Следният пример с код показва как да проверите дали имейл съобщението е отскочило и да извлечете подробна информация за него: