Documentation – Конвертування файлів електронної пошти за допомогою C# API

Net: Конвертувати EML у HTML

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

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

Для інтеграції вмісту електронної пошти у веб‑застосунки конвертація EML у HTML — правильний вибір, що забезпечує візуально привабливу презентацію листів.

Для конвертації EML у HTML вам знадобляться наступні класи:

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

У наведеному нижче прикладі коду ці класи працюють разом, щоб завантажити існуючий EML‑файл і зазначити формат повідомлення як EML. Після цього вони зберігають завантажений лист у HTML‑файл, використовуючи зазначені параметри збереження HTML за замовчуванням:

Використайте MailMessage.Load() метод для завантаження існуючого файлу у об’єкт MailMessage, вказуючи формат повідомлення.
Збережіть завантажений об’єкт MailMessage у HTML‑файл, використовуючи зберегти метод. Використайте SaveOptions.DefaultHtml() для зазначення параметрів збереження у форматі HTML.

// Initialize and Load an existing EML file by specifying the MessageFormat
var message = MailMessage.Load("myMessage.eml");
message.Save("output.html", SaveOptions.DefaultHtml);

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

Aspose.Email надає ResourceRenderingMode перерахування, яке дозволяє розробникам маніпулювати ресурсами у HTML‑файлі. У наведеному нижче прикладі коду цей enum використовується для збереження ресурсів у файл та вставки у HTML тегу ’src’ з шляхом до цього файлу:

Завантажте повідомлення електронної пошти з вихідного файлу, використовуючи MapiMessage.Load метод.
Створіть екземпляр HtmlSaveOptions з вказаними параметрами рендерингу та ресурсів.
Збережіть завантажене повідомлення електронної пошти у HTML‑файл у цільове розташування, використовуючи Зберегти метод з параметром HtmlSaveOptions.

var msg = MapiMessage.Load(sourceFileName);
var htmlSaveOptions = new HtmlSaveOptions
{
ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
UseRelativePathToResources = true
};
msg.Save(Path.Combine("target.html"), htmlSaveOptions);

Вбудувати ресурси у HTML‑файл

У деяких випадках потрібно вбудовувати ресурси, наприклад зображення, безпосередньо в HTML‑файл для безперешкодного розповсюдження та презентації. За допомогою Aspose.Email for .NET ви можете легко це зробити, використовуючи ResourceRenderingMode перерахування:

Завантажте повідомлення електронної пошти з вихідного файлу, використовуючи MapiMessage.Load метод.
Створити новий HtmlSaveOptions об’єкту та встановіть властивість ResourceRenderingMode у значення EmbedIntoHtml.
Збережіть завантажене повідомлення електронної пошти у HTML‑файл за допомогою Зберегти метод, вказуючи шлях до цільового файлу та передаючи об’єкт HtmlSaveOptions як параметр для вбудовування ресурсів у HTML‑файл.

var msg = MapiMessage.Load(sourceFileName);
var htmlSaveOptions = new HtmlSaveOptions
{
ResourceRenderingMode = ResourceRenderingMode.EmbedIntoHtml
};
msg.Save(Path.Combine("target.html"), htmlSaveOptions);

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

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

// Load the EML file
var eml = MailMessage.Load("message.eml");
// Find the alternate view with MediaType "text/calendar" (ICS)
var icsView = eml.GetAlternateViewContent("text/calendar");
// If an ICS view is found, save it to a file
if (icsView != null)
{
    File.WriteAllText("appointment.ics", icsView);
}

Налаштування

Aspose.Email for .NET надає інструменти для налаштування вмісту ICS (iCalendar), витягнутого з EML (електронної пошти) файлів.

Налаштувати деталі події

Наступний приклад коду демонструє, як задати різні деталі зустрічі, такі як підсумок, місце та опис. Код використовує Appointment клас, що представляє календарні події або зустрічі у форматі ICS (iCalendar). Клас надає властивості та методи для створення, зміни та керування календарними подіями програмно.

// Load the EML file
var eml = MailMessage.Load("message.eml");
// Find the alternate view with MediaType "text/calendar" (ICS)
var icsView = eml.GetAlternateViewContent("text/calendar");
// If an ICS view is found, load it to Appointment class object
var appointment = Appointment.Load(new MemoryStream(Encoding.UTF8.GetBytes(icsView)));

// Customize the event details
appointment.Summary = "Customized Event Summary";
appointment.Location = "Customized Location";
appointment.Description = "Customized Event Description";

// Add or modify attendees as needed
appointment.Attendees.Clear();
appointment.Attendees.Add("custom@example.com");

// Save the customized ICS content to a file
appointment.Save("customized_appointment.ics");

Створити шаблон повторення

Наступний приклад коду демонструє, як створити щотижневий шаблон повторення для зустрічі, де зустріч відбувається кожні 5 тижнів у суботу. Код використовує Recurrence властивість Appointment клас, який отримує або задає шаблон повторення.

var pattern = new  WeeklyRecurrencePattern(5, 7);
pattern. EndDate = new DateTime(2023, 8, 7);

appointment.Recurrence = pattern;

Додати EML до MBOX

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

using (var message = MailMessage.Load("inputFile.eml")){
	using (var writer = new MboxrdStorageWriter("output.mbox", false)){
			writer.WriteMessage(message);
	}
}

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

За допомогою Aspose.Email for .NET ви можете легко конвертувати EML‑файли у формат MHTML для різних цілей, таких як архівування, сумісність, офлайн‑перегляд тощо. Завантажте повідомлення електронної пошти, використовуючи MailMessage.Load, потім використайте MhtSaveOptions клас як параметр до MailMessage.Save метод для зазначення формату вихідного файлу під час збереження повідомлення як окремого файлу:

// Initialize and Load an existing EML file by specifying the MessageFormat
var message = MailMessage.Load("myMessage.eml");
var mhtSaveOptions = new MhtSaveOptions;
message.Save("output.mhtml", mhtSaveOptions);

The MhtSaveOptions клас надає різні варіанти налаштування вихідних MHTML‑файлів відповідно до ваших специфічних вимог:

Зберегти оригінальне форматування дати. Ви можете вибрати збереження оригінального форматування повідомлень електронної пошти під час процесу конвертації:
```
saveOptions.PreserveOriginalDate = true;
```
Встановити кодування виходу. Ви можете вказати кодування, яке буде використано під час запису вихідних MHTML‑файлів:
```
saveOptions.OutputEncoding = Encoding.UTF8; 
```
Включити вкладення. Це може бути корисно, якщо ви хочете зберегти вкладення під час конвертації листів у формат MHTML:
```
saveOptions.SaveAttachments = true;
```

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

Якщо вам потрібно мігрувати дані електронної пошти, архівувати повідомлення чи інтегруватися з Microsoft Outlook, Aspose.Email пропонує рішення для досягнення цілей. Файли MSG широко використовуються Microsoft Outlook. Для конвертації EML у MSG використовуйте MailMessage.Load метод для завантаження існуючого EML‑файлу, вказуючи, як його завантажувати за допомогою EmlLoadOptions.

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

// Load mail message
using (var message = MailMessage.Load("sourceFile.eml", new EmlLoadOptions())){
// Save as MSG
var msgSaveOptions = new MsgSaveOptions;
message.Save("output.msg", MsgSaveOptions);
}

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

Щоб конвертувати EML‑файли у формат Outlook Template (OFT), завантажте існуюче електронне повідомлення за допомогою MailMessage.Load метод і зберегти його за допомогою MailMessage.Save вказуючи параметри за замовчуванням для збереження повідомлення у форматі OFT:

// load the EML file to be converted
var message = MailMessage.Load("My File.eml"); 
// save EML as a OFT 
message.Save("Saved File.oft", SaveOptions.DefaultOft);

Додати EML до PST

Щоб конвертувати EML‑файли у формат Personal Storage Table (PST), завантажте повідомлення за допомогою MapiMessage.Load метод, створити вихідний файл за допомогою PersonalStorage.Create і додати лист до створеної папки Inbox у файлі сховища, використовуючи AddMessage:

using (var msg = MapiMessage.Load("sourceFile.eml", new EmlLoadOptions()))
{
    using (var personalStorage = PersonalStorage.Create("outputFile.pst", FileFormatVersion.Unicode))
  {
        var inbox = personalStorage.RootFolder.AddSubFolder("Inbox");
        inbox.AddMessage(msg);
  }
}

Додати EML до OST

Розробники можуть легко конвертувати EML‑файли у формат Outlook Offline Storage Table (OST), забезпечуючи інтеграцію з Microsoft Outlook. Наступний приклад коду демонструє, як додати повідомлення EML до файлу OST:

using (var ost = PersonalStorage.FromFile("storage.ost"))
{
    // Load the EML file
    var msg = MapiMessage.Load("message.eml", new EmlLoadOptions());

    // Add the EML message to the OST file
    var folderInfo = ost.RootFolder.GetSubFolder("Inbox");
    folderInfo.AddMessage(msg);
}

The EmlLoadOptions параметр вказує додаткові опції при завантаженні EML‑файлів, такі як збереження вбудованих форматів повідомлень, видалення підписів тощо.

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

Aspose.Email for .NET пропонує функціональність конвертації EML‑файлів у формат vCard (VCF), дозволяючи розробникам витягати контактну інформацію з електронних листів. Для цього бібліотека пропонує GetAlternateViewContent метод MailMessage клас, що дозволяє розробникам отримувати доступ до альтернативних подань у електронних листах та витягувати VCF‑вміст, вбудований у EML‑файли, для подальшого використання:

// Load the EML file
var eml = MailMessage.Load("message.eml");
// Find the alternate view with MediaType "text/vcard" (VCF)
var vcfView = eml.GetAlternateViewContent("text/vcard");
// If an VCF view is found, save it to a file
if (vcfView != null)
{
    File.WriteAllText("contact.vcf", vcfView);
}

Net: Конвертування файлів MSG у різні формати в C#

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

MSG — це формат файлів, який використовується Microsoft Outlook та Exchange для зберігання окремих електронних листів. Файл MSG містить дані листа, включаючи заголовки, тіло, вкладення та метадані. Ці файли зазвичай створюються, коли лист зберігається на диск з клієнта Outlook. Однак існують випадки, коли потрібно конвертувати файли MSG у інші формати для сумісності, архівації або обміну.

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

MapiMessage клас - представляє файл MSG, надаючи властивості та методи, специфічні для формату MSG. Використовується для завантаження та маніпуляції файлами MSG перед конвертацією.
MailMessage клас - представляє електронний лист. Використовується для зберігання вмісту листа після його конвертації з формату MSG і подальшого збереження у потрібному форматі.
Параметри збереження - визначає параметри збереження та цільові формати для об’єкта MailMessage. Використовується для вказання формату, у якому має бути збережений MailMessage. Приклади включають SaveOptions.DefaultEml, SaveOptions.DefaultHtml, SaveOptions.DefaultMhtml тощо.

Методи

MapiMessage.Load: Завантажує файл MSG з вказаного шляху у об’єкт MapiMessage. Цей статичний метод читає файл MSG і готує його до конвертації.
MapiMessage.ToMailMessage(Email.MailConversionOptions options = null): Перетворює об’єкт MapiMessage у об’єкт MailMessage. Викликається на об’єкті MapiMessage для трансформації його у MailMessage для подальшої обробки та збереження.
MailMessage.Save(string fileName, SaveOptions options): Зберігає об’єкт MailMessage у вказаний шлях у потрібному форматі. Використовується для збереження конвертованого листа у різних форматах. Різні SaveOptions застосовуються залежно від цільового формату.

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

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

Файли EML широко підтримуються різними поштовими клієнтами, що полегшує обмін та доступ до листів на різних платформах. Конвертація у формат EML дозволяє простіше маніпулювати та обробляти дані листа, особливо при інтеграції з іншими системами чи застосунками. Aspose.Email для .NET надає простий та ефективний спосіб виконання цієї конвертації. Наведений нижче приклад коду показує, як завантажити файл MSG і зберегти його у файл EML:

Завантажте файл MSG за допомогою MailMessage.Load метод. Цей метод читає вміст файлу MSG і готує його до подальшої обробки.
Збережіть завантажене повідомлення у файл EML, використовуючи Зберегти метод MailMessage клас. Вкажіть ім’я вихідного файлу та параметри збереження.

// Initialize and Load an existing MSG file by specifying the MessageFormat
var message = MailMessage.Load("myMessage.msg");
message.Save("output.eml", SaveOptions.DefaultEml);

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

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

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

Конвертація файлів MSG у формат EMLX є важливою у випадках, коли листи повинні бути сумісними з Apple Mail та іншими поштовими клієнтами, що підтримують формат EMLX. Aspose.Email для .NET забезпечує простий та ефективний спосіб виконання цієї конвертації.

Завантажте файл MSG за допомогою MailMessage.Load метод. Цей метод читає вміст файлу MSG і конвертує його у об’єкт MailMessage.
Використайте Зберегти метод MailMessage клас для збереження файлу MSG у форматі EMLX. Вкажіть ім’я вихідного файлу та параметри збереження.

// load the MSG file to be converted
var message = MailMessage.Load("My File.msg");
// save MSG as a EMLX 
message.Save("Saved File.emlx", SaveOptions.CreateSaveOptions(MailMessageSaveType.EmlxFormat));

Aspose.Email для .NET пропонує кілька спеціальних функцій, які можна застосовувати під час конвертації MSG у EMLX. Ці функції покращують процес конвертації, надаючи додатковий контроль, налаштування та обробку різних аспектів електронних листів. Наведений нижче приклад коду демонструє реалізацію деяких з них:

// Load the MSG file to be converted
var message = MailMessage.Load("My File.msg");

// Preserving original formatting and metadata
var saveOptions = SaveOptions.CreateSaveOptions(MailMessageSaveType.EmlxFormat);
saveOptions.PreserveOriginalHeaders = true;

// Handling attachments
if (message.Attachments.Count > 0)
    {
        Console.WriteLine("The email contains attachments which will be preserved.");
    }

// Customizing email headers
message.Headers.Add("X-Custom-Header", "CustomHeaderValue");

// Saving the MSG file as EMLX with the specified options
message.Save("Saved File.emlx", saveOptions);

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

Конвертація файлів MSG у формат HTML може бути корисною для відображення листів у веб‑застосунках або для архівування. Aspose.Email для .NET — надійне рішення для цього завдання. Наведений нижче код демонструє, як завантажити файл MSG і зберегти його у форматі HTML:

Ініціалізуйте MailMessage об’єкт і завантажте MSG‑файл, розташований у "myMessage.msg". The Load метод автоматично визначає формат на основі розширення файлу.
Збережіть завантажене повідомлення у форматі HTML у файл "output.html", використовуючи Зберегти метод. SaveOptions.DefaultHtml параметр гарантує правильне збереження файлу у форматі HTML.

// Initialize and Load an existing MHTML file by specifying the MessageFormat
var message = MailMessage.Load("myMessage.mhtml");
message.Save("output.html", SaveOptions.DefaultHtml);

Розширені можливості конвертації MSG у HTML

Збереження форматування листа:

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

Обробка вкладень:

Процес конвертації може включати вкладення, які можна вбудовувати безпосередньо в HTML або посилатися на них зовні.

Налаштування HTML‑виводу:

Ви можете налаштувати HTML‑вивід, змінюючи структуру документа, додаючи власні стилі або включаючи додаткові HTML‑елементи.

Перетворення вбудованих зображень та вбудованих об’єктів:

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

Параметри кодування:

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

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

Конвертування файлів MSG, які містять календарні події, у формат ICS — це поширена задача для забезпечення сумісності з різними календарними додатками. Aspose.Email для .NET має набір потужних функцій для виконання цього перетворення. Вони використовуються для завантаження файлу MSG, перевірки, чи містить він календарний елемент, та збереження його у файл ICS. Нижче наведений приклад коду, який демонструє, як конвертувати файл MSG у формат ICS:

Ініціалізуйте MapiMessage об’єкт і завантажте файл MSG, розташований у "appointment.msg", використовуючи Load метод. Метод Load автоматично визначає формат за розширенням файлу.
Перевірте, чи завантажений файл MSG є типом Calendar, використовуючи MapiItemType. Це важливо, щоб переконатися, що файл містить календарну подію перед спробою конвертації.
Конвертуйте об’єкт MapiMessage у MapiCalendar об’єкт, який необхідний для збереження події у форматі ICS.
Зберегти елемент календаря у форматі ICS у файл "appointment.ics" за допомогою Зберегти метод.

var msg = MapiMessage.Load("appointment.msg");
            
if (msg.SupportedType == MapiItemType.Calendar)
{
    var calendar = (MapiCalendar)msg.ToMapiMessageItem();
    calendar.Save("appointment.ics", AppointmentSaveFormat.Ics);
}

Розширені функції конвертації MSG у ICS

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

Збереження деталей події: дата, час, місце, учасники та шаблони повторення.
Обробка повторюваних подій: усі шаблони повторення точно конвертуються та відображаються у файлі ICS.
Налаштування властивостей події: ви можете налаштувати різні властивості події, такі як встановлення нагадувань, додавання категорій та зміну користувацьких полів перед збереженням у форматі ICS.
Керування вкладеннями: усі відповідні документи та файли включені у файл ICS.
Налаштування часових поясів: встановити та налаштувати часові пояси для події, щоб дані про час були точними та послідовними у різних регіонах.

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

Конвертування файлів MSG у формат MBOX може бути необхідним для управління та архівування листів на різних платформах. Aspose.Email для .NET пропонує простий та ефективний метод для виконання цього перетворення. Нижче ми пройдемо кроки конвертації файлу MSG у формат MBOX за допомогою простого прикладу коду.

Формат MBOX широко використовується для зберігання колекцій електронних листів, а конвертація файлів MHTML у формат MBOX може бути особливо корисною для архівування або міграції електронних даних. Aspose.Email для .NET надає WriteMessage метод MboxrdStorageWriter класу для запису повідомлення у файл MBOX. Нижче наведено приклад коду, який демонструє, як використати ці можливості у конвертації MHTML у MBOX:

Завантажте файл MSG за допомогою MailMessage.Load вказуючи MsgLoadOptions.
Створіть MboxrdStorageWriter об’єкт для запису повідомлень у файл MBOX з назвою "output.mbox". Другий параметр вказує, чи додавати до існуючого файлу (false означає створити новий файл або перезаписати існуючий).
Записати завантажене повідомлення у файл MBOX за допомогою WriteMessage метод.

using (var message = MailMessage.Load("inputFile.msg", new MsgLoadOptions())){
    using (var writer = new MboxrdStorageWriter("output.mbox", false)){
        writer.WriteMessage(message);
    }
}

Особливі функції конвертації MSG у MBOX

Розширені функції, які надає Aspose.Email для .NET, щоб покращити процес конвертації файлів MSG у формат MBOX, включають:

Збереження властивостей листа
Обробка вкладень
Налаштування заголовків електронної пошти
Конвертація кількох файлів MSG
Налаштування параметрів збереження електронної пошти

Конвертувати MSG у MHT/MHTML

Конвертування файлів MSG у формат MHT корисне для створення веб-архіву електронних листів, які можна легко поширювати або зберігати. Aspose.Email для .NET пропонує просте рішення для виконання цього перетворення. Нижче наведено код, який демонструє, як завантажити файл MSG та зберегти його у форматі MHT:

Використати MapiMessage.Load метод для завантаження файлу MSG.
Використайте Зберегти метод з відповідними параметрами збереження, щоб зберегти повідомлення у форматі MHT.

var msg = MapiMessage.Load("file.msg");
msg.Save("file.mht", SaveOptions.DefaultMhtml);

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

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

Конвертування файлів MSG у OFT (шаблон Outlook) може бути необхідним для створення багаторазових шаблонів електронної пошти у Microsoft Outlook. Aspose.Email для .NET надає спосіб виконати це перетворення з мінімальним кодом. Використовуючи MapiMessage клас, ви можете конвертувати файл MSG у формат OFT. Ось фрагмент коду, який демонструє, як це зробити:

Створити новий MapiMessage об’єкт з електронною адресою відправника, адресою отримувача, темою та тілом шаблону електронного листа.
Використайте SaveAsTemplate метод для збереження MapiMessage у файл OFT (шаблон OFT).

using (MapiMessage mapi = new MapiMessage("test@from.to", "test@to.to", "template subject", "Template body"))
{
    string oftMapiFileName = "mapiToOft.msg";
    mapi.Save(oftMapiFileName, new MsgSaveOptions(MailMessageSaveType.OutlookTemplateFormat);
}

Net: Конвертувати HTML у інші формати

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

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

Aspose.Email for .NET надає метод для конвертації HTML‑файлів у формат EML за допомогою MailMessage.Load і MailMessage.Save методи для завантаження існуючого HTML‑файлу та збереження його у форматі EML відповідно:

var eml = MailMessage.Load("myContent.html", new HtmlLoadOptions());
eml.Save("output.eml", SaveOptions.DefaultEml);

У прикладі коду HtmlLoadOptions клас дозволяє вказати додаткові параметри під час завантаження MailMessage у форматі HTML. Наступний приклад коду демонструє використання цього класу. У прикладі вказано текстове представлення тіла повідомлення:

// Create an instance of HtmlLoadOptions
var loadOptions = new HtmlLoadOptions();

// Set the ShouldAddPlainTextView property to true to generate a plain text view along with HTML
loadOptions.ShouldAddPlainTextView = true;

// Load an HTML file
var mailMessage = MailMessage.Load("input.html", loadOptions);

// Access the plain text view of the email message
var plainTextView = mailMessage.GetAlternateViewContent("text/plain");

// Print or further process the plain text view
Console.WriteLine("Plain Text View:");
Console.WriteLine(plainTextView);

Конвертувати HTML у EMLX

Ви можете легко конвертувати HTML‑файли у EMLX. Усі властивості та класи, надані API для конвертації HTML у EML, доступні й для цього типу конвертації:

var eml = MailMessage.Load("myContent.html", new HtmlLoadOptions());
eml.Save("output.emlx", SaveOptions.DefaultEmlx);

Для додаткових налаштувань перегляньте Конвертувати HTML у EML абзац.

Конвертувати HTML у ICS

Для виконання завдання бібліотека пропонує Appointment клас для представлення та керування календарними подіями. Наступний приклад коду демонструє, як створити форму зустрічі у HTML‑вмісті та зберегти її у форматі файлу ICS (iCalendar):

// Sample HTML content
var htmlContent = File.ReadAllText("content.html");

// Create and initialize an instance of the Appointment class
var appointment = new Appointment(
    "Meeting Room 3 at Office Headquarters",// Location
    "Monthly Meeting",                      // Summary
    "Please confirm your availability.",    // Description
    new DateTime(2015, 2, 8, 13, 0, 0),     // Start date
    new DateTime(2015, 2, 8, 14, 0, 0),     // End date
    "from@domain.com",                      // Organizer
    "attendees@domain.com")
{
    HtmlDescription = htmlContent
};

// Save the event to an ICS file
appointment.Save("output.ics", AppointmentSaveFormat.Ics);

Створити MBOX з HTML‑вмісту

Щоб виконати конвертацію HTML у MBOX, використайте Load метод MailMessage клас, вказуючи шлях до файлу HTML‑вмісту та екземпляр HtmlLoadOptions. Цей метод аналізує HTML‑вміст і створює відповідний об’єкт MailMessage, зберігаючи структуру та форматування оригінального HTML. Після завантаження HTML‑вмісту у об’єкт MailMessage запишіть повідомлення у файл MBOX, використовуючи MboxrdStorageWriter клас:

using (var eml = MailMessage.Load("content.html", new HtmlLoadOptions())){
    using (var writer = new MboxrdStorageWriter("output.mbox", false)){
        writer.WriteMessage(eml);
    }
}

Конвертувати HTML у MHTML

Використайте Load метод MailMessage клас, щоб завантажити існуючий файл, вказавши шлях до нього та екземпляр HtmlLoadOptions. Цей метод аналізує HTML‑вміст і створює відповідний об’єкт MailMessage, зберігаючи структуру та форматування оригінального HTML. Після завантаження HTML‑вмісту у об’єкт MailMessage розробники можуть зберегти його у файл MHTML, використовуючи Зберегти метод, вказуючи бажаний шлях до вихідного файлу та використовуючи SaveOptions.DefaultMhtml опція:

var eml = MailMessage.Load("content.html", new HtmlLoadOptions());
eml.Save("output.mhtml", SaveOptions.DefaultMhtml);

The MhtSaveOptions клас надає різноманітні параметри для налаштування поведінки та властивостей вихідного файлу MHTML замість SaveOptions.DefaultMhtml. За його допомогою властивості, ви можете вказати додаткові параметри під час збереження MailMessage у форматі MHTML. Найпопулярніші з них:

MhtFormatOptions - Дозволяє налаштувати спосіб збереження електронного листа у форматі MHT відповідно до ваших потреб.
SaveAttachments - Отримує або задає значення, що вказує, чи зберігати вкладення.
SaveAllHeaders - Визначає, чи потрібно зберігати всі заголовки у вихідному mhtml, чи ні. Значення за замовчуванням – false.
PreserveOriginalDate - Визначає, чи потрібно зберігати оригінальну дату в повідомленні пошти під час збереження чи ні. Значення за замовчуванням – true.

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

var mhtSaveOprtions = new MhtSaveOptions
{
    MhtFormatOptions = MhtFormatOptions.WriteHeader,
    SaveAttachments = true,
    SaveAllHeaders = true,
    PreserveOriginalDate = true
}

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

Після завантаження HTML‑вмісту у об’єкт MailMessage, збережіть його у файл MSG, використовуючи Зберегти метод, вказуючи бажаний шлях до вихідного файлу та використовуючи SaveOptions.DefaultMsgUnicode опція. Ця опція забезпечує збереження вихідного файлу у форматі MSG з кодуванням Unicode.

var eml = MailMessage.Load("content.html", new HtmlLoadOptions());
eml.Save("output.msg", SaveOptions.DefaultMsgUnicode);

Крім того, Aspose.Email для .NET пропонує ряд розширених функцій та параметрів для конвертації HTML у MSG:

Конвертувати HTML у OFT

Після завантаження HTML‑вмісту у об’єкт MailMessage, збережіть його у файл OFT, використовуючи Зберегти метод, вказуючи бажаний шлях до вихідного файлу та використовуючи SaveOptions.DefaultOft опція:

var eml = MailMessage.Load("content.html", new HtmlLoadOptions());
eml.Save("template.oft", SaveOptions.DefaultOft);

Додати повідомлення з HTML‑вмістом до PST

Конвертація HTML у PST включає створення нового файлу PST (Personal Storage Table) з новою папкою, завантаження HTML‑файлу та додавання його до нової папки:

Створіть екземпляр об’єкта PersonalStorage, що представляє новий файл PST, використовуючи Create метод PersonalStorage клас.
Отримайте доступ до кореневої папки файлу PST і додайте до неї підпапку, використовуючи AddSubFolder метод FolderInfo клас.
Завантажте вміст HTML‑файлу у MapiMessage об’єкт за допомогою Load метод з екземпляром HtmlLoadOptions щоб вказати, що вміст у форматі HTML.
Додайте завантажений об’єкт MapiMessage (що представляє HTML‑вміст) до папки у файлі PST, використовуючи AddMessage метод.

using (var pst = PersonalStorage.Create("outputFile.pst", FileFormatVersion.Unicode))
{ 
    var inbox = pst.RootFolder.AddSubFolder("Inbox");
    var msg = MapiMessage.Load("content.html", new HtmlLoadOptions());
    inbox.AddMessage(msg);
}

Додати повідомлення з HTML‑вмістом до OST

Наступний приклад коду з кроками покаже, як ці компоненти працюють разом, щоб додати HTML‑вміст до файлу OST:

Завантажте існуючий файл OST за допомогою FromFile метод PersonalStorage клас, який використовується для представлення файлу сховища, що буде зберігати електронні листи.
Завантажте HTML‑файл, використовуючи Load метод MapiMessage клас, що представляє повідомлення електронної пошти у форматі Microsoft Outlook.
Вкажіть HtmlLoadOptions для включення додаткових параметрів під час завантаження MailMessage у форматі HTML.
Отримайте кореневу папку файлу OST, використовуючи RootFolder властивість PersonalStorage об’єкт.
Отримайте папку Inbox у файлі OST, використовуючи GetSubFolder метод у кореневій папці.
Додайте завантажений об’єкт MapiMessage (що представляє HTML‑вміст) до папки Inbox, використовуючи AddMessage метод у папці.

using (var ost = PersonalStorage.FromFile("storage.ost"))
{
    var msg = MapiMessage.Load("content.html", new HtmlLoadOptions());
    var folderInfo = ost.RootFolder.GetSubFolder("Inbox");
    folderInfo.AddMessage(msg);
}

Конвертувати HTML у VCF

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

Прочитайте вміст HTML‑файлу у рядкову змінну за допомогою методу File.ReadAllText.
Створіть новий об’єкт MapiContact, створивши екземпляр MapiContact клас.
Встановіть властивості контакту: ім’я для відображення, email‑адресу.
Встановіть вміст тіла контакту у форматі HTML, використовуючи SetBodyContent.
Збережіть контакт як файл VCF, використовуючи Зберегти метод.

var content = File.ReadAllText("content.html");
            
// Create a new MapiContact
var contact = new MapiContact();
contact.NameInfo.DisplayName = "John Doe";
contact.ElectronicAddresses.Email1.EmailAddress = "john.doe@example.com";
contact.SetBodyContent(content, BodyContentType.Html);

// Save the contact to a VCF file
contact.Save("contact.vcf", ContactSaveFormat.VCard)

Net: Конвертація файлів OFT у різні формати на C#

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

Однією з важливих можливостей є здатність конвертувати файли OFT (Outlook File Template) у різні інші формати, такі як EML, EMLX, MSG, MHTML тощо. У цьому розділі ми проведемо вас через процес конвертації файлів OFT у ці формати, підкреслюючи прості та ефективні методи, що надає Aspose.Email для .NET.

При конвертації файлів OFT у інші формати за допомогою Aspose.Email для .NET у процесі залучено кілька ключових компонентів. Нижче наведено докладний опис цих компонентів:

MapiMessage клас - Представляє повідомлення Microsoft Outlook у пам’яті. Використовується для завантаження та маніпуляції файлами OFT. Надає методи для читання OFT‑файлів та їх конвертації у інші формати.
Load метод - Завантажує OFT‑файл у об’єкт MapiMessage. Це статичний метод класу MapiMessage, який читає OFT‑файл за вказаним шляхом.
Зберегти метод - Зберігає об’єкт MapiMessage у вказаний формат. Використовується для конвертації та збереження завантаженого OFT‑файлу у потрібний формат, такий як EML, MSG або MHTML, у вказаний шлях, куди буде збережено конвертований файл.
SaveOptions клас - Надає параметри збереження листа у різних форматах. Містить попередньо визначені параметри для різних форматів, таких як EML, MSG та MHTML, і забезпечує збереження листа з правильними налаштуваннями формату.

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

Конвертація файлів OFT у формат EML часто необхідна для міграції даних листів, архівації або забезпечення сумісності з різними поштовими клієнтами. Формат EML широко підтримується і може бути відкритий у багатьох поштових програмах. Для виконання конвертації розгляньте наведений нижче приклад коду з кроками:

Завантажте OFT‑файл у об’єкт MapiMessage за допомогою MapiMessage.Load.
Збережіть завантажений файл, використовуючи Зберегти метод, який вказує цільове ім’я файлу та параметри збереження.

var oft = MapiMessage.Load("template.oft");
oft.Save("message.eml", SaveOptions.DefaultEml);

Aspose.Email для .NET пропонує кілька параметрів налаштування при конвертації файлів OFT у формат EML. Ці параметри дозволяють контролювати різні аспекти процесу конвертації. Нижче наведено деякі можливості налаштування разом із прикладами коду:

Змінити тему або тіло листа

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

using Aspose.Email;
using Aspose.Email.Mapi;

// Load the OFT file
var oft = MapiMessage.Load("template.oft");

// Modify the email subject
oft.Subject = "Updated Subject";

// Modify the email body
oft.Body = "This is the updated body content of the email.";

// Save the modified email as EML
oft.Save("updated_message.eml", SaveOptions.DefaultEml);

Обробка вкладень

Ви можете додавати або видаляти вкладення в листі перед конвертацією.

using Aspose.Email;
using Aspose.Email.Mapi;

// Load the OFT file
var oft = MapiMessage.Load("template.oft");

// Add a new attachment
var attachment = new MapiAttachment("new_attachment.txt", System.IO.File.ReadAllBytes("new_attachment.txt"));
oft.Attachments.Add(attachment);

// Remove an existing attachment (if any)
if (oft.Attachments.Count > 0)
{
    oft.Attachments.RemoveAt(0);
}

// Save the modified email as EML
oft.Save("message_with_attachments.eml", SaveOptions.DefaultEml);

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

Конвертація OFT у EMLX

Використайте MapiMessage.Load метод для завантаження OFT‑файлу у об’єкт MapiMessage. Цей метод читає OFT‑файл за вказаним шляхом.
Після завантаження OFT‑файлу використайте Зберегти метод об’єкта MapiMessage для збереження його у форматі EMLX. Вкажіть цільове ім’я файлу та відповідні параметри збереження.

var oft = MapiMessage.Load("template.oft");
oft.Save("message.emlx", SaveOptions.DefaultEmlx);

Налаштування властивостей листа

Aspose.Email надає різні параметри налаштування під час конвертації файлів OFT у формат EMLX. Ви можете змінювати властивості, такі як тема, тіло, вкладення тощо.

using Aspose.Email;
using Aspose.Email.Mapi;

public class Program
{
    public static void Main()
    {
        // Load the OFT file
        var mapiMessage = MapiMessage.FromFile("input.oft");

        // Customize message properties
        mapiMessage.Subject = "Customized Subject";
        mapiMessage.Body = "This is the customized body of the email.";

        // Add an attachment
        mapiMessage.Attachments.Add("attachment.txt", System.Text.Encoding.UTF8.GetBytes("Attachment content"));

        // Convert and save the customized message to EMLX format
        var emlMessage = mapiMessage.ToMailMessage(new MailConversionOptions());
        emlMessage.Save("output.emlx", SaveOptions.DefaultEmlx);
    }
}

Конвертація OFT у HTML

Конвертація файлів OFT у формат HTML дозволяє легко відображати вміст листа у веб‑браузерах та інтегрувати його у веб‑застосунки. Aspose.Email для .NET спрощує цей процес, забезпечуючи збереження оригінального форматування та структури файлу OFT у конвертованому HTML.

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

Використайте MapiMessage.Load метод для завантаження OFT‑файлу у об’єкт MapiMessage.
Збережіть завантажене повідомлення у HTML‑файл, використовуючи Зберегти метод і вибір SaveOptions.DefaultHtml як параметри збереження.

var oft = MapiMessage.Load("template.oft");
oft.Save("message.html", SaveOptions.DefaultHtml);

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

Вбудовування ресурсів

Щоб забезпечити вбудовування зображень та інших ресурсів у HTML‑файл, можна використати HtmlSaveOptions клас для встановлення властивості ‘EmbedResources’.

var oft = MapiMessage.Load("template.oft");

// Create HTML save options with embedded resources
HtmlSaveOptions options = SaveOptions.DefaultHtml;
options.EmbedResources = true;

// Save as HTML with embedded resources
oft.Save("message_embedded.html", options);

Вказування кодування символів

Ви можете вказати кодування символів для HTML‑файлу, встановивши властивість Encoding у HtmlSaveOptions клас.

var oft = MapiMessage.Load("template.oft");

// Create HTML save options with specified encoding
HtmlSaveOptions options = SaveOptions.DefaultHtml;
options.Encoding = System.Text.Encoding.UTF8;

// Save as HTML with specified encoding
oft.Save("message_utf8.html", options);

Вбудовані зображення

Щоб включити зображення як вбудовані base64‑закодовані рядки у HTML‑файл, можна встановити властивість HtmlFormatOptions у WriteInlineImages.

Net: Конвертувати файли MHTML у різні формати на C#

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

Конвертація файлів MHTML у різні формати є поширеною вимогою у багатьох додатках, особливо тих, що працюють з архівуванням електронної пошти, управлінням документами та обміном даних. MHTML, або MIME HTML, — це формат веб‑архіву, який використовується для поєднання HTML‑коду та його ресурсів, таких як зображення, в один файл. Однак для забезпечення сумісності та зручності використання може знадобитися конвертація файлів MHTML у інші формати, такі як MSG, EML або OST. У цій статті ми розглянемо, як це зробити за допомогою Aspose.Email for .NET, потужної та універсальної бібліотеки, призначеної для обробки та управління електронною поштою в .NET‑додатках.

Aspose.Email for .NET спрощує процес конвертації завдяки своїм багатим функціям та методам. Основні компоненти, що беруть участь у процесі конвертації MHTML, включають:

MhtmlLoadOptions: Цей компонент визначає параметри завантаження файлів MHTML. Він дозволяє налаштування того, як інтерпретувати та обробляти вміст MHTML.
MailMessage: Цей клас представляє електронне повідомлення та слугує містом для завантаження вмісту MHTML. Він полегшує витяг і розбір даних листа у файлі MHTML.
Параметри збереження: Залежно від цільового формату, Aspose.Email for .NET надає різні параметри збереження, такі як EmlSaveOptions, MsgSaveOptions тощо. Ці параметри визначають параметри та налаштування для збереження конвертованого файлу у потрібному форматі.

Методи конвертації форматів файлів також використовуються для спрощення процесу конвертації, дозволяючи безперешкодну трансформацію з MHTML у формати, такі як EML, MSG, PST та інші.

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

Конвертація MHTML у EML — один із поширених завдань при роботі з файлами електронної пошти. Формат EML широко використовується для збереження окремих листів, що робить його придатним форматом для архівування та обміну. Нижче наведений фрагмент коду продемонструє, як Aspose.Email може бути використаний для конвертації файлу MHTML у формат EML:

Завантажте файл MHTML за допомогою MailMessage.Load методу. Цей метод читає вміст файлу MHTML і готує його до подальшої обробки.
Збережіть завантажене повідомлення у файл EML, використовуючи Зберегти метод MailMessage клас. Вкажіть ім’я вихідного файлу та параметри збереження.

// Initialize and Load an existing MHTML file by specifying the MessageFormat
var message = MailMessage.Load("myMessage.mhtml");
message.Save("output.eml", SaveOptions.DefaultEml);

Конвертувати MHTML у EMLX

Формат EMLX зазвичай використовується в застосунку Mail від Apple і корисний для користувачів, яким потрібна сумісність з macOS. Aspose.Email for .NET забезпечує можливість конвертувати файли MHTML у формат EMLX. Нижче наведено приклад коду, який демонструє його роботу, забезпечуючи сумісність із застосунком Mail від Apple та іншими клієнтами електронної пошти на macOS.

Завантажте файл MHTML за допомогою MailMessage.Load метод.
Використайте Зберегти метод MailMessage клас для збереження вмісту MHTML у файл EMLX. Вкажіть ім’я вихідного файлу та параметри збереження.

// load the MHTML file to be converted
var message = MailMessage.Load("My File.mhtml");
// save MHTML as a EMLX 
message.Save("Saved File.emlx", SaveOptions.CreateSaveOptions(MailMessageSaveType.EmlxFormat));

Конвертувати MHTML у HTML

Конвертація файлів MHTML у формат HTML часто потрібна для відображення вмісту листа у веб‑браузерах або для подальшої обробки у веб‑застосунках. Aspose.Email for .NET пропонує простий спосіб виконати цю конвертацію. Нижче наведено приклад коду, який показує, як конвертувати файли MHTML у формат HTML за допомогою Aspose.Email for .NET:

Використайте MailMessage.Load метод для завантаження файлу MHTML. Цей метод читає вміст файлу MHTML і готує його до подальшої обробки.
Використайте Зберегти метод MailMessage клас для збереження вмісту MHTML у файл HTML. Вкажіть ім’я вихідного файлу та параметри збереження.

// Initialize and Load an existing MHTML file by specifying the MessageFormat
var message = MailMessage.Load("myMessage.mhtml");
message.Save("output.html", SaveOptions.DefaultHtml);

Бібліотека також дозволяє змінювати або додавати користувацькі властивості до HTML‑виводу, такі як власні заголовки, тема чи вміст тіла. Ви також можете вбудовувати вкладення в HTML‑вміст за потреби. Щоб забезпечити правильне відображення вмісту листа у веб‑браузерах або поштових клієнтах, налаштуйте HTML‑форматування: вбудовані стилі, зовнішні CSS та HTML‑теги.

Конвертувати MHTML у ICS

Конвертація файлів MHTML у формат ICS є необхідною для керування подіями календаря та зустрічами. Формат ICS широко використовується для обміну календарними даними, забезпечуючи взаємодію між різними календарними застосунками. Aspose.Email for .NET забезпечує безперебійну конвертацію. Використайте GetAlternateViewContent метод для витягнення вмісту ICS з файлу MHTML. Цей метод отримує календарну інформацію у форматі "text/calendar". Нижче наведено приклад коду, що демонструє, як конвертувати файл MHTML у формат ICS за допомогою Aspose.Email for .NET:

Завантажте файл MHTML за допомогою MailMessage.Load методу. Цей метод читає вміст файлу MHTML і готує його до подальшої обробки.
Витягніть вміст ICS за допомогою GetAlternateViewContent.
Якщо вміст ICS не є null, збережіть його у файл за допомогою File.WriteAllText.

var eml = MailMessage.Load("message.mhtml", new MhtmlLoadOptions());

var icsView = eml.GetAlternateViewContent("text/calendar");

if (icsView != null)
{
  File.WriteAllText("appointment.ics", icsView);
}

Опції налаштування

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

Власні формати дати та часу: Ви можете вказати власні формати дати та часу для вмісту ICS, щоб відповідати потрібному формату виводу.
Обробка часових поясів: Керуйте інформацією про часові пояси, щоб події календаря точно відображалися в різних часових поясах.
Опції кодування: Вкажіть параметри кодування, щоб забезпечити правильне кодування вмісту ICS, запобігаючи проблемам зі спеціальними символами.
Обробка вкладень: Витягайте та включайте вкладення з файлу MHTML у вміст ICS, за потреби.
Користувацькі властивості: Додайте користувацькі властивості до файлу ICS, такі як власні поля чи метадані.

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

// Load the MHTML file
        var eml = MailMessage.Load("message.mhtml", new MhtmlLoadOptions());
            
        // Extract the ICS content
        var icsView = eml.GetAlternateViewContent("text/calendar");

        if (icsView != null)
        {
            // Create a new Appointment object from the ICS content
            var appointment = Appointment.Load(new MemoryStream(Encoding.UTF8.GetBytes(icsView)));

            // Customize the ICS properties
            appointment.StartDate  = new DateTime (2024, 12, 10);
            appointment.EndDate = new DateTime (2014, 12, 11);

            // Add a custom property
            appointment.Summary = "Custom Event Summary";

            // Save the customized ICS content to a file
            var icsContent = appointment.SaveToString();
            File.WriteAllText("custom_appointment.ics", icsContent);
        }

Налаштування у цьому випадку досягаються за допомогою Appointment клас, що представляє календар до електронної пошти та його широкі методи та властивості.

Конвертувати MHTML у MBOX

Завантажте файл MHTML за допомогою MailMessage.Load.
Ініціалізуйте MboxrdStorageWriter для запису завантаженого повідомлення у файл MBOX. Вкажіть ім’я вихідного файла та чи слід додавати до існуючого файлу MBOX.
Записати повідомлення у файл MBOX.

using (var message = MailMessage.Load("inputFile.mhtml", new MhtmlLoadOptions())){
using (var writer = new MboxrdStorageWriter("output.mbox", false)){
        writer.WriteMessage(message);
    }
}

Додаткові параметри

Додавання до існуючих файлів MBOX: Ви можете додавати повідомлення до існуючого файлу MBOX замість створення нового. Це корисно для підтримки одного файлу MBOX, що консолідує кілька листів.
Користувацькі заголовки повідомлень: Модифікуйте або додайте користувацькі заголовки до повідомлень перед їх збереженням у файл MBOX.
Обробка вкладень: Забезпечте правильне збереження вкладень та їх включення у конвертований файл MBOX.
Опції кодування: Вкажіть параметри кодування, щоб забезпечити правильне кодування вмісту повідомлення, особливо при роботі зі спеціальними символами або різними мовами.

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

// Load the MHTML file
using (var message = MailMessage.Load("inputFile.mhtml", new MhtmlLoadOptions()))
{
// Customize message headers
message.Subject = "Customized Subject";
message.Headers.Add("X-Custom-Header", "CustomHeaderValue");

// Create an MboxrdStorageWriter to append the message to an existing MBOX file
using (var writer = new MboxrdStorageWriter("output.mbox", true)) // true to append
{
// Write the message to the MBOX file
writer.WriteMessage(message);
}
}

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

Конвертація файлів MHTML у формат MSG корисна в сценаріях, коли потрібно керувати або поширювати повідомлення електронної пошти в Microsoft Outlook. Aspose.Email забезпечує цю конвертацію, гарантуючи, що лист зберігає оригінальне форматування та вміст. Нижче наведено приклад коду, що демонструє, як конвертувати файл MHTML у формат MSG за допомогою Aspose.Email for .NET:

Завантажте файл MHTML за допомогою MailMessage.Load.
Використайте Зберегти метод MailMessage клас для збереження завантаженого повідомлення у файл MSG. Вкажіть ім’я вихідного файлу та використайте DefaultMsgUnicode параметр збереження, щоб забезпечити збереження файлу у правильному форматі.

var eml = MailMessage.Load("message.mhtml", new MhtmlLoadOptions());

eml.Save("message.msg", SaveOptions.DefaultMsgUnicode);

Додаткові функції

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

Користувацькі властивості повідомлення: Модифікуйте або додайте користувацькі властивості до файлу MSG, такі як власні заголовки, тема чи вміст тіла.
Обробка вкладень: Забезпечте правильне збереження вкладень та їх включення у конвертований файл MSG. Ви також можете додавати нові вкладення або змінювати існуючі.
Встановлення прапорців повідомлення: Встановіть прапорці повідомлення, такі як статус прочитано/непрочитано або рівень важливості.
Опції кодування: Вкажіть параметри кодування, щоб забезпечити правильне кодування вмісту повідомлення, особливо при роботі зі спеціальними символами або різними мовами.
HTML‑форматування: Забезпечте правильне форматування та збереження HTML‑вмісту листа у файлі MSG.

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

 // Load the MHTML file
var eml = MailMessage.Load("message.mhtml", new MhtmlLoadOptions());

// Customize message properties
eml.Subject = "Customized Subject";
eml.Headers.Add("X-Custom-Header", "CustomHeaderValue");

// Add an attachment
var attachment = new Attachment("path/to/attachment.txt");
eml.Attachments.Add(attachment);

// Set message flags
eml.IsRead = true; // Mark as read
eml.Priority = MailPriority.High; // Set high priority

// Save the loaded message as an MSG file with default Unicode options
eml.Save("message.msg", SaveOptions.DefaultMsgUnicode);

Конвертувати MHTML у OFT

Конвертація файлів MHTML у формат OFT корисна в сценаріях, коли потрібно створювати шаблони листів для Microsoft Outlook. Aspose.Email for .NET є надійним рішенням для виконання цієї конвертації. Нижче наведено приклад коду, що показує, як конвертувати файл MHTML у формат OFT за допомогою Aspose.Email for .NET:

Завантажте файл MHTML за допомогою MailMessage.Load.
Збережіть завантажене повідомлення у файл OFT за допомогою Зберегти метод MailMessage клас. Вкажіть ім’я вихідного файлу та використайте DefaultOft параметр збереження, щоб забезпечити збереження файлу у правильному форматі.

var eml = MailMessage.Load("message.mhtml", new MhtmlLoadOptions());

eml.Save("message.oft", SaveOptions.DefaultOft);

Спеціальні функції

Aspose.Email for .NET пропонує кілька спеціальних функцій, які можуть бути реалізовані у процесі конвертації MHTML у OFT, таких як налаштування властивостей повідомлення, обробка вкладень, встановлення прапорців повідомлення, параметри кодування та HTML‑форматування. Нижче наведено приклади коду, що демонструють реалізацію деяких із цих функцій:

eml.Subject = "Customized Subject";
eml.Headers.Add("X-Custom-Header", "CustomHeaderValue");

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

var attachment = new Attachment("path/to/attachment.txt");
eml.Attachments.Add(attachment);

Цей код додає нове вкладення до повідомлення електронної пошти.

eml.IsRead = true; // Mark as read
eml.Priority = MailPriority.High; // Set high priority

Ці рядки встановлюють повідомлення як прочитане та присвоюють йому високий пріоритет.

Конвертувати MHTML у OST

Якщо вам потрібно зберігати та керувати повідомленнями електронної пошти в Microsoft Outlook без підключення до мережі, конвертація у формат OST (Offline Storage Table) може бути корисною. Для конвертації MHTML у OST Aspose.Email for .NET надає простий метод. У кілька рядків коду ви можете завантажити існуючий файл OST, потім файл MHTML і додати його до цільової папки. Нижче наведено приклад коду, що показує, як виконати цю конвертацію:

Використайте PersonalStorage.FromFile метод для завантаження існуючого файлу OST.
Використайте MapiMessage.Load метод для завантаження файлу MHTML. Цей метод читає вміст файлу MHTML і конвертує його в об’єкт MapiMessage.
Знайдіть цільову папку у OST файлі (наприклад, "Inbox") і використайте AddMessage метод для додавання конвертованого повідомлення MHTML у цю папку.

using (var ost = PersonalStorage.FromFile("storage.ost"))
{
    // Load the EML file
    var msg = MapiMessage.Load("message.mhtml", new MhtmlLoadOptions());

    // Add the EML message to the OST file
    var folderInfo = ost.RootFolder.GetSubFolder("Inbox");
    folderInfo.AddMessage(msg);
}

Окрім можливості змінювати або додавати користувацькі властивості, такі як власні заголовки, тема чи вміст тіла, до файлу MHTML перед його збереженням як повідомлення OST, Aspose.Email також дозволяє додавати нові вкладення або змінювати існуючі, встановлювати прапори класифікації, такі як статус прочитано/непрочитано, рівень важливості або прапори подальших дій; зберігати багатий HTML‑формат листа, включаючи стилі, зображення та вбудовані ресурси; створювати нові папки або організовувати повідомлення у існуючих папках OST файлу для підтримки впорядкованої структури.

// Load the OST file
using (var ost = PersonalStorage.FromFile("storage.ost"))
    {
    // Load the MHTML file
    var msg = MapiMessage.Load("message.mhtml", new MhtmlLoadOptions());

    // Customize message properties
    msg.Subject = "Customized Subject";
    msg.Headers.Add("X-Custom-Header", "CustomHeaderValue");

    // Add an attachment
    var attachment = new MapiAttachment("path/to/attachment.txt", "attachment.txt");
    msg.Attachments.Add(attachment);

    // Set message flags
    msg.SetMessageFlags(MapiMessageFlags.MSGFLAG_READ); // Mark as read
    msg.Importance = MapiImportance.High; // Set high importance

    // Get the target folder
    var folderInfo = ost.RootFolder.GetSubFolder("Inbox");

    // Add the customized message to the OST file
    folderInfo.AddMessage(msg);
    }

Конвертувати MHTML у PST

Конвертація файлів MHTML у формат PST (Personal Storage Table) корисна в сценаріях, коли потрібно зберігати та керувати повідомленнями електронної пошти в Microsoft Outlook. Aspose.Email for .NET пропонує рішення у чотири кроки для виконання цієї конвертації:

Створіть новий PST файл за допомогою PersonalStorage.Create методу. Цей метод ініціалізує новий PST файл з вказаною назвою та версією формату файлу.
Створіть підпапку у PST файлі (наприклад, "Inbox") за допомогою методу AddSubFolder.
Завантажте файл MHTML за допомогою MapiMessage.Load методу. Цей метод читає вміст файлу MHTML і конвертує його в об’єкт MapiMessage.
Додайте повідомлення до PST файлу за допомогою AddMessage метод для додавання конвертованого повідомлення MHTML у вказану папку у файлі PST.

using (var pst = PersonalStorage.Create("outputFile.pst", FileFormatVersion.Unicode))
{ 
    var inbox = pst.RootFolder.AddSubFolder("Inbox");
    var msg = MapiMessage.Load("sourceFile.mhtml", new MhtmlLoadOptions());
    inbox.AddMessage(msg);
}

Більше параметрів, які можна використати під час конвертації файлів MHTML у формат PST, дивіться Конвертувати MHTML у OST.

Конвертувати MHTML у VCF

Конвертація файлів MHTML у формат VCF (vCard) є поширеним рішенням, якщо потрібно витягти та зберегти контактну інформацію з листів. Aspose.Email for .NET

Використайте MailMessage.Load метод для завантаження файлу MHTML. Цей метод читає вміст файлу MHTML і конвертує його в об’єкт MailMessage.
Використайте GetAlternateViewContent метод для пошуку альтернативного перегляду з типом медіа "text/vcard". Цей метод витягує вміст vCard з повідомлення електронної пошти.
Перевірте, чи знайдено вміст vCard, і якщо так, збережіть його у файл VCF за допомогою File.WriteAllText.

var eml = MailMessage.Load("message.mhtml", new MhtmlLoadOptions());

var vcfView = eml.GetAlternateViewContent("text/vcard");

if (vcfView != null)
{
    File.WriteAllText("contact.vcf", vcfView);
}

Спеціальні функції конвертації MHTML у VCF

Обробка користувацьких властивостей: Модифікуйте або додайте користувацькі властивості до vCard перед збереженням. Це може включати власні поля, додаткову контактну інформацію або персоналізовані дані.
Витяг декількох контактів: Витягайте кілька записів контактів, якщо файл MHTML містить кілька записів vCard, і зберігайте кожен контакт у окремий файл VCF.
Опції кодування: Забезпечте правильне кодування контактної інформації для підтримки різних наборів символів та інтернаціоналізації.
Версії vCard: Конвертуйте та зберігайте vCard у різних версіях (v2.1, v3.0, v4.0) залежно від вимог сумісності цільового застосунку.
Обробка вбудованих зображень: Витягайте та зберігайте вбудовані зображення або фотографії, пов’язані з контактами у vCard.
Об’єднання контактів: Поєднайте кілька записів vCard в один файл VCF для спрощеного керування контактами.

Нижче наведено приклад, що демонструє, як використовувати деякі з цих спеціальних функцій при конвертації MHTML у VCF:

// Load the MHTML file
var eml = MailMessage.Load("message.mhtml", new MhtmlLoadOptions());

// Find the alternate view with MediaType "text/vcard" (VCF)
var vcfView = eml.GetAlternateViewContent("text/vcard");

// If a VCF view is found, save it to a file
if (vcfView != null)
    {
    // Ensure proper encoding
    var encodedVcfView = Encoding.UTF8.GetString(Encoding.UTF8.GetBytes(vcfView));

    // Save the vCard to a file
    File.WriteAllText("contact.vcf", encodedVcfView);
    }

Net: Конвертація інших форматів ACS

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

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

Для представлення календарної події або зустрічі Aspose.Email має Appointment клас. Наведений приклад коду демонструє процес конвертації ICS у EML:

Завантажте файл ICS, що підлягає конвертації, використовуючи Calendar.Appointment.Load метод.
Створити новий MailMessage об’єкт для зберігання календарних даних.
Додайте зустріч з файлу ICS до EML як альтернативний вигляд, використовуючи RequestApointment() метод.
Збережіть файл EML з конвертованими даними, використовуючи Зберегти метод з EmlSaveOptions вказавши тип збереження як EmlFormat.

// load the ICS file to be converted
var ics = Calendar.Appointment.Load("My File.ics");
// create an EML
var eml = new MailMessage();
// add appointment to EML
eml.AlternateViews.Add(ics.RequestApointment());
// save the EML
eml.Save("Saved File.eml", new EmlSaveOptions(MailMessageSaveType.EmlFormat));

Конвертувати ICS у EMLX

Щоб конвертувати файл ICS у формат EMLx, дотримуйтесь інструкцій з Конвертувати ICS у EML статтю та збережіть файл .emlx, як показано у наступному рядку коду:

// save as a EMLX
eml.Save("Saved File.emlx", new EmlSaveOptions(MailMessageSaveType.EmlxFormat));

Конвертувати ICS у HTML

Наведений нижче приклад коду демонструє процес конвертації:

Завантажте файл ICS, що підлягає конвертації, використовуючи Calendar.Appointment.Load метод.
Створити новий MailMessage об’єкт для зберігання календарних даних.
Додайте зустріч з файлу ICS до EML як альтернативний вигляд, використовуючи RequestApointment() метод.
Збережіть файл EML з конвертованими даними, використовуючи Зберегти метод з HtmlSaveOptions для надання параметрів форматування збереженого HTML‑файлу. У цьому конкретному випадку, HtmlFormatOptions.WriteHeader використовується для включення HTML‑заголовка у вихідний файл, тоді як HtmlFormatOptions.RenderCalendarEvent використовується для відображення будь‑яких календарних подій, що містяться у повідомленні EML, у форматі, придатному для показу.

// load the ICS file to be converted
var ics = Aspose.Email.Calendar.Appointment.Load("My File.ics");
// create an EML
var eml = new MailMessage();
// add appointment to EML
eml.AlternateViews.Add(ics.RequestApointment());
// save EML as a HTML
eml.Save("Saved File.html", new HtmlSaveOptions { HtmlFormatOptions = HtmlFormatOptions.WriteHeader | HtmlFormatOptions.RenderCalendarEvent });

Використовуйте інші значення та властивості HtmlFormatOptions перерахування та HtmlSaveOptions клас для встановлення параметрів формату за потребою.

Конвертувати ICS у MBOX

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

Завантажте файл ICS, що підлягає конвертації, використовуючи Calendar.Appointment.Load метод.
Створити новий MailMessage об’єкт для зберігання календарних даних.
Додайте зустріч з файлу ICS до EML як альтернативний вигляд, використовуючи RequestApointment() метод.
Створіть новий об’єкт MboxrdStorageWriter.
Додайте повідомлення EML до сховища, записавши його вміст у форматі MBOX у вказаний файл MBOX.

// load the ICS file to be converted
var ics = Aspose.Email.Calendar.Appointment.Load("My File.ics");
// create an EML
var eml = new MailMessage();
// add appointment to EML
eml.AlternateViews.Add(ics.RequestApointment());
// create an MBOX storage
using var mboxStorage = new MboxrdStorageWriter("Saved File.mbox" , false);
// add EML to MBOX storage
mboxStorage.WriteMessage(eml);

Конвертувати ICS у MHTML

Наведений приклад коду демонструє представлення всіх цих кроків у процесі конвертації за допомогою бібліотеки Aspose.Email для .NET:

Завантажте файл ICS, що підлягає конвертації, використовуючи Calendar.Appointment.Load метод.
Створити новий MailMessage об’єкт для збергання конвертованих даних.
Додайте зустріч з файлу ICS до EML як альтернативний вигляд, використовуючи RequestApointment() метод.
Збережіть файл EML з конвертованими даними, використовуючи Зберегти метод з MhtSaveOptions для надання параметрів збереження файлу MHTML. У цьому конкретному випадку, MhtFormatOptions.WriteHeader використовується для включення заголовка електронного листа у вихідний файл, тоді як MhtFormatOptions.RenderCalendarEvent використовується для відображення будь‑яких календарних подій, що містяться у повідомленні EML, у форматі, придатному для показу.

// load the ICS file to be converted
var ics = Aspose.Email.Calendar.Appointment.Load("My File.ics");
// create an EML
var eml = new MailMessage();
// add appointment to EML
eml.AlternateViews.Add(ics.RequestApointment());
// save EML as a MHTML
eml.Save("Saved File.mht", new MhtSaveOptions{MhtFormatOptions = MhtFormatOptions.WriteHeader | MhtFormatOptions.RenderCalendarEvent});

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

Вільно використовуйте інші значення та властивості MhtFormatOptions перерахування та MhtSaveOptions клас для встановлення параметрів формату за потребою.

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

Конвертація файлів ICS (iCalendar) у формат MSG є доцільною для кращої сумісності з Microsoft Outlook, оскільки файли MSG зазвичай використовуються для збереження електронних листів, зустрічей та інших даних Outlook. Наведений приклад коду демонструє, як завантажити файл ICS, маніпулювати його вмістом і зберегти його у файл MSG без втрати даних або форматування:

Завантажте файл ICS, використовуючи Calendar.Appointment.Load() і створити Appointment об’єкт з календарними даними, збереженими у файлі.
Викличте Зберегти метод у об’єкті Appointment, який конвертує та зберігає завантажені дані про зустріч із файлуICS у файл MSG за вказаною адресою.

// load the ICS file to be converted
// save ICS as a MSG
Aspose.Email.Calendar.Appointment.Load("My File.ics").Save("Saved File.msg", AppointmentSaveFormat.Msg);

Конвертувати ICS у OFT

Процес включає завантаження файлів ICS та їх збереження у вигляді файлів MSG з подальшою конвертацією у формат OFT:

Створіть новий об’єкт потоку для збереження даних про зустріч у пам’яті.
Завантажте дані про зустріч з файлуICS. Збережіть дані про зустріч у об’єкт потоку у форматі MSG, використовуючи метод Save().
Завантажте дані про зустріч з потоку, створивши новий об’єкт MapiMessage за допомогою MapiMessage.Load() метод.
Збережіть завантажені дані MapiMessage у файл шаблону Outlook, використовуючи Save() метод із вказаними параметрами формату SaveOptions.DefaultOft.

// load the ICS file to be converted
// save ICS as a MSG
using var msgStream = new MemoryStream();
Aspose.Email.Calendar.Appointment.Load("My File.ics").Save(msgStream, AppointmentSaveFormat.Msg);
// save MSG as an OFT
MapiMessage.Load(ms).Save("Saved File.oft", SaveOptions.DefaultOft);

Конвертувати ICS у OST

Aspose.Email забезпечує можливість завантажити файл ICS, зберегти його як файл MSG, потім відкрити файл OST, отримати доступ до календарних папок у цьому файлі та легко додати файли MSG до календарної папки:

Створіть потік для збереження даних про зустріч.
Завантажте дані про зустріч з файлу ICS, використовуючи Appointment.Load() метод і збережіть його у потік у форматі MSG, використовуючи Appointment.Save метод.
Завантажте файл Personal Storage, використовуючи FromFile метод PersonalStorage клас.
Отримайте календарну папку з файлу персонального сховища, використовуючи PersoanlStorage.GetPredefinedFolder метод.
Використайте FolderInfo.AddMessage метод для додавання повідомлення про зустріч до календарної папки у файлі OST.

// load the ICS file to be converted
// save ICS as a MSG
using var msgStream = new MemoryStream();
Aspose.Email.Calendar.Appointment.Load("My File.ics").Save(msgStream, AppointmentSaveFormat.Msg);
// open an OST file
using var pst = PersonalStorage.FromFile("Saved File.ost");
// get a calendar folder
var calendarFolder = pst.GetPredefinedFolder(StandardIpmFolder.Appointments);
// add MSG to the calendar folder
calendarFolder.AddMessage(MapiMessage.Load(msgStream));

Конвертувати ICS у PST

Наведений нижче приклад коду демонструє процес конвертації:

Створіть потік для зберігання даних про зустріч.
Завантажте дані про зустріч з файлу ICS, використовуючи Appointment.Load() метод і збережіть його у потік у форматі MSG, використовуючи Appointment.Save метод.
Створіть новий файл PST з вказаним іменем, використовуючи PersonalStorage.Create метод.
Створіть календарну папку у файлі PST для збереження зустрічей, використовуючи CreatePredefinedFolder метод.
Додайте повідомлення про зустріч до календарної папки у файлі PST, використовуючи FolderInfo.AddMessage метод.

// load the ICS file to be converted
// save ICS as a MSG
using var msgStream = new MemoryStream();
Aspose.Email.Calendar.Appointment.Load("My File.ics").Save(msgStream, AppointmentSaveFormat.Msg);
// create a PST file
using var pst = PersonalStorage.Create("Saved File.pst", FileFormatVersion.Unicode);
// create a calendar folder
var calendarFolder = pst.CreatePredefinedFolder("Calendar", StandardIpmFolder.Appointments);
// add MSG to the calendar folder
calendarFolder.AddMessage(MapiMessage.Load(msgStream));

Net: Конвертувати файли MBOX у різні формати в C#

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

Aspose.Email для .NET надає потужні можливості конвертації електронних листів, збережених у форматі MBOX, у різні інші формати. Бібліотека підтримує конвертацію у формати такі як EML, EMLX, HTML, ICS, MHT, MHTML, MSG, OFT, OST, PST, TIFF, VCF та XPS. Нижче наведено докладні кроки та приклади коду для конвертації файлів MBOX у ці формати. Для цього Aspose.Email пропонує широкий набір функцій:

The MboxrdStorageReader клас, який використовується для читання листів з файлу MBOX та отримання загальної кількості повідомлень. Надає методи доступу до окремих листів, збережених у файлі.
The MailMessage клас, що представляє електронне повідомлення. Підтримує завантаження та збереження листів у різних форматах і надає багатий функціонал для маніпуляції їх властивостями.
The SaveOptions клас, який визначає параметри, що використовуються при збереженні листа. Він містить як попередньо визначені параметри, так і параметри налаштування для збереження листів у різних форматах.

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

Файли EML використовуються кількома клієнтами електронної пошти для зберігання листів у форматі простого тексту. Конвертація MBOX у EML спрощує передачу та читання листів.

Нижче наведено приклад коду, який демонструє конвертацію MBOX у EML:

Створіть екземпляр MboxrdStorageReader для вказаного файлу MBOX ("sourceFile.mbox").
Використайте reader.GetTotalItemsCount() метод для ітерації всіх листів у файлі, щоб отримати загальну кількість елементів, починаючи з 0.
Читайте кожне повідомлення, використовуючи reader.ReadNextMessage() метод.
Збережіть кожен лист як файл .eml з унікальним ім’ям ("outputMessage"+i+".eml") за допомогою SaveOptions.DefaultEml.

using (var reader = new MboxrdStorageReader("sourceFile.mbox", false)){
	for (int i = 0; i < reader.GetTotalItemsCount(); i++){
		using (var message = reader.ReadNextMessage()){
			message.Save("outputMessage"+i+".eml", SaveOptions.DefaultEml);
		}
	}
}

Конвертувати MBOX у EMLX

Для цього типу конвертації використайте той самий підхід, що наведений вище Конвертувати MBOX у EML. Однак, при збереженні листа у форматі EMLX, оберіть SaveOptions.DefaultEmlx.

using (var reader = new MboxrdStorageReader("sourceFile.mbox", false)){
	for (int i = 0; i < reader.GetTotalItemsCount(); i++){
		using (var message = reader.ReadNextMessage()){
			message.Save("outputMessage"+i+".emlx", SaveOptions.DefaultEmlx);
		}
	}
}

Конвертувати MBOX у HTML

Формат HTML широко використовується для відображення листів у веб‑браузерах. Конвертація MBOX у HTML дозволяє переглядати листи у веб‑дружньому форматі.

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

Використайте MboxStorageReader.CreateReader метод для завантаження файлу MBOX. Це ініціалізує читач із вказаним шляхом до файлу та параметрами завантаження.
Створіть вихідну директорію, якщо вона не існує.
Налаштуйте лічильник для створення унікальних імен файлів для кожного HTML‑файлу. Це забезпечує, що кожне повідомлення зберігається під різним ім’ям.
Ітерація по всім повідомленням у файлі MBOX. The EnumerateMessages метод MboxStorageReader повертає колекцію електронних листів у вигляді enumerable.
Визначте шлях до файлу для кожного HTML‑файлу, використовуючи лічильник. Поєднайте вихідну директорію та шаблон імен файлів для генерації унікальних шляхів.
Налаштуйте HtmlSaveOptions для контролю того, як ресурси (наприклад, зображення та вкладення) обробляються під час конвертації в HTML. У цьому випадку ресурси зберігаються у файлах, і використовується відносний шлях.
Збережіть кожне повідомлення електронної пошти як HTML‑файл за допомогою Зберегти метод MailMessage клас. Передайте шлях до файлу та параметри збереження як аргументи.

// Load mbox file
var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());
// Ensure the output directory exists
Directory.CreateDirectory(outputDirectory);
// Iterate through mbox messages and save them as .html files
int count = 1;
foreach (var eml in mbox.EnumerateMessages())
{
    // Save each message as .html file
    var htmlFilePath = Path.Combine(outputDirectory, $"Message{count}.html");
    var htmlSaveOptions = new HtmlSaveOptions
    {
        ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
        UseRelativePathToResources = true
    };
    eml.Save(htmlFilePath, htmlSaveOptions);

Спеціальні функції

Висока точність:
- Aspose.Email забезпечує, щоб конвертація з MBOX у HTML зберігала оригінальне форматування, розмітку та вбудовані елементи листів. Це включає збереження форматування тексту, зображень, гіперпосилань та вкладень, забезпечуючи, що HTML‑представлення максимально відповідає оригінальному вмісту листа.
Налаштування:
- Властивість SaveOptions.DefaultHtml повертає HtmlSaveOptions клас, який дозволяє налаштувати процес конвертації. Користувачі можуть вказувати різні налаштування для контролю того, як листи відображаються у форматі HTML. Це включає параметри вбудовування зображень безпосередньо у файл HTML або посилання на зовнішні ресурси.
Ефективність та масштабованість:
- Aspose.Email розроблений для ефективної роботи з великими файлами MBOX. Бібліотека може швидко та надійно обробляти тисячі листів, що робить її придатною для застосунків, які потребують конвертації великих обсягів даних електронної пошти.
Збереження метаданих:
- Aspose.Email забезпечує збереження важливих метаданих, таких як тема, відправник, одержувач, дата та заголовки під час конвертації. Це гарантує, що контекст і деталі кожного листа не будуть втрачені.

Конвертувати MBOX у ICS

Формат ICS (iCalendar) широко використовується для зберігання календарних подій і підтримується багатьма календарними додатками. Цей розділ охоплює функціональність та можливості Aspose.Email для .NET щодо конвертації файлів MBOX у формат ICS, забезпечуючи плавний перенос календарних подій, що зберігаються в електронних листах. Це досягається завдяки послідовним компонентам, згаданим у кроках коду.

Нижче наведено приклад коду, який демонструє, як конвертувати файли MBOX у ICS за допомогою Aspose.Email для .NET:

Ініціалізуйте читач MBOX для завантаження листів з вказаного шляху до файлу MBOX, використовуючи MboxStorageReader.CreateReader метод.
Переконайтеся, що існує вихідна директорія, куди будуть зберігатися файли ICS.
Ініціалізуйте лічильник, щоб відстежувати кількість повідомлень електронної пошти для іменування файлів ICS.
Переберіть кожне повідомлення електронної пошти у файлі MBOX, використовуючи EnumerateMessages метод MboxStorageReader клас.
Згенеруйте шлях до файлу для ICS.
Витягніть календарний вміст з листа у форматі ICS за допомогою GetAlternateViewContent.
Збережіть вміст ICS у файл.

var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

Directory.CreateDirectory(outputDirectory);

int count = 1;

foreach (var eml in mbox.EnumerateMessages())
{
    var icsFilePath = Path.Combine(outputDirectory, $"Message{count}.ics");

    var icsContent = eml.GetAlternateViewContent("text/calendar");

    if (icsContent != null)
    {
        File.WriteAllText(icsFilePath, icsContent);
    }
}

Можливості конвертації MBOX у ICS

Клас SaveOptions дозволяє розробникам налаштовувати спосіб збереження даних під час конвертації. Це включає параметри контролю форматування та структури отриманих файлів ICS.
Aspose.Email надає можливість витягати календарні події з електронних повідомлень. Використовуючи класи MailMessage та Appointment, події, вбудовані у листи, можна точно визначити та конвертувати у формат ICS.
Бібліотека розроблена для ефективної роботи з великими файлами MBOX. Вона може швидко обробляти велику кількість повідомлень електронної пошти, що робить її придатною для додатків, які потребують конвертації великих обсягів даних.
Aspose.Email забезпечує точну конвертацію всіх релевантних даних у файлі MBOX у формат ICS. Це включає збереження деталей події, таких як підсумок події, час початку і закінчення, шаблони повторення, учасники тощо.

Конвертувати MBOX у MHT/MHTML

Файли MHT (MHTML) використовуються для архівації веб-сторінок та електронних листів в один файл. Конвертація MBOX у MHT допомагає зберігати листи як веб-архівні файли. Aspose.Email для .NET надає потужні інструменти для полегшення цієї конвертації, забезпечуючи збереження цілісності та форматування оригінальних листів.

Нижче наведено приклад коду, що демонструє конвертацію MBOX у MHT:

Ініціалізуйте читач MBOX для завантаження листів з вказаного файлу MBOX, використовуючи MboxStorageReader.CreateReader метод.
Ітерувати кожне повідомлення електронної пошти у файлі MBOX за допомогою GetTotalItemsCount() метод MboxStorageReader клас. Прочитати наступне повідомлення електронної пошти під час ітерації, використовуючи ReadNextMessage() метод.
Зберегти повідомлення електронної пошти як файл MHTML за допомогою Зберегти метод, використовуючи індекс ітерації для імені файлу та SaveOptions.DefaultMhtml, попередньо визначений параметр для збереження повідомлень у форматі MHT.

using (var reader = new MboxrdStorageReader("sourcFile.mbox", false)){
  for (int i = 0; i < reader.GetTotalItemsCount(); i++){
    using (var message = reader.ReadNextMessage()){
      message.Save("outputMessage"+i+".mht", SaveOptions.DefaultMhtml);
    }
  }
}

Додаткові функції

Під час конвертації з MBOX у MHT/MHTML розробники також можуть скористатися іншими корисними функціями, які надає Aspose.Email для .NET:

Розробники можуть налаштовувати параметри збереження відповідно до своїх конкретних потреб. Наприклад, вони можуть вказати параметри для включення або виключення вкладень, inline‑зображень та інших ресурсів.
Aspose.Email може обробляти вбудовані та inline‑ресурси (наприклад, зображення та вкладення) у повідомленнях електронної пошти. Ці ресурси зберігаються та правильно посилаються у отриманих файлах MHT.
Під час процесу конвертації важливі метадані, такі як заголовки листа, тема, відправник, одержувач та дата, зберігаються, забезпечуючи, що жодна критична інформація не буде втрачена.
Розробники можуть програмно змінювати тему, тіло та інші властивості електронних повідомлень перед їх збереженням у потрібному форматі, використовуючи багатофункціональність MailMessage клас для маніпуляції властивостями електронної пошти.

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

MSG — це формат файлу, який використовується Microsoft Outlook для зберігання окремих електронних листів. Конвертація MBOX у MSG корисна для прямого доступу до листів MBOX в Outlook.

Aspose.Email для .NET пропонує широкий набір функцій та можливостей, які спрощують процес конвертації, забезпечуючи точне збереження всіх критичних атрибутів листа, таких як інформація про відправника та одержувача, тема, дата та тіло повідомлення, вкладення, вбудовані у листи MBOX, безперешкодно конвертуються та включаються у файли MSG, оригінальний формат листа зберігається, гарантуючи, що файл MSG відображає ту ж розмітку та форматування, що й оригінальний лист MBOX. Якщо листи MBOX містять користувацькі властивості або розширені властивості MAPI (Messaging Application Programming Interface), вони зберігаються та точно відображаються у файлах MSG.

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

Створіть екземпляр MboxrdStorageReader для читання файлу MBOX.
Перебирати кожен електронний лист у файлі MBOX від 0 до загальної кількості елементів у ньому, використовуючи reader.GetTotalItemsCount().
Прочитайте наступний електронний лист за допомогою ReadNextMessage() метод.
Використайте Зберегти метод для збереження електронного листа у форматі MSG з індексом i у якості вихідного шляху та імені файлу для MSG‑файлу, а SaveOptions.DefaultMsgUnicode вказує, що файл MSG має бути збережений у форматі Unicode, зберігаючи всі розширені символи та властивості.

using (var reader = new MboxrdStorageReader("sourcFile.mbox", false)){
	for (int i = 0; i < reader.GetTotalItemsCount(); i++){
		using (var message = reader.ReadNextMessage()){
			message.Save("outputMessage" + i + ".msg", SaveOptions.DefaultMsgUnicode);
		}
	}
}

Використання MboxrdStorageReader і MailMessage.Save забезпечує правильне читання кожного листа з файлу MBOX та точне збереження у потрібному форматі.

Конвертувати MBOX у OFT

OFT (Outlook File Template) — це формат файлу, який використовується Microsoft Outlook для зберігання шаблонів листів. Ці шаблони можна використовувати для створення попередньо сформованих електронних листів, що корисно для повторюваних завдань. Конвертація MBOX у OFT дозволяє користувачам використовувати існуючий вміст листів, збережений у файлах MBOX, для створення багаторазових шаблонів у Outlook.

Aspose.Email для .NET полегшує конвертацію MBOX у OFT‑файли через простий процес, що включає кілька ключових компонентів. По‑першу, MboxrdStorageReader клас використовується для створення екземпляра читача, який завантажує та читає MBOX‑файл, використовуючи CreateReader методу з вказаним шляхом до файлу та параметрами завантаження (MboxLoadOptions). Кожен електронний лист у файлі MBOX потім обробляється за допомогою EnumerateMessages методу, який ітерує листи. Кожен лист, представлений як MailMessage об’єкт зберігається у вигляді OFT‑файлу за допомогою Зберегти метод з SaveOptions.DefaultOft. Це забезпечує збереження оригінального форматування та деталей листа під час конвертації. Використовуючи ці компоненти, Aspose.Email для .NET забезпечує безшовний та ефективний процес конвертації з MBOX у OFT, задовольняючи різноманітні потреби застосунків у управлінні даними електронної пошти та їх міграції.

Нижче наведений фрагмент коду описує процес перетворення електронних листів з формату MBOX у файли Outlook Template (OFT) за допомогою Aspose.Email для .NET:

Ініціалізуйте читач для обробки MBOX‑файлів, передаючи mboxFilePath (шлях до MBOX‑файлу) та MboxLoadOptions (вказуючи будь‑які додаткові параметри завантаження).
Створіть каталог виводу, якщо його ще немає.
Ініціалізуйте лічильник листів.
Перебирайте кожен електронний лист (eml) у файлі MBOX за допомогою mbox.EnumerateMessages(). Цей метод повертає кожен лист як об’єкт MailMessage.
Використайте Зберегти метод для збереження кожного листа у вигляді OFT‑файлу за вказаним шляхом. The SaveOptions.DefaultOft забезпечує, що електронний лист конвертується та зберігається у форматі OFT з параметрами за замовчуванням.

var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

Directory.CreateDirectory(outputDirectory);

int count = 1;

foreach (var eml in mbox.EnumerateMessages())
{
    // Save each message as .oft file
    var oftFilePath = Path.Combine(outputDirectory, $"Message{count}.oft");
    eml.Save(oftFilePath, SaveOptions.DefaultOft);

Конвертувати MBOX у OST

Формат OST (Offline Storage Table) — це файл даних, який використовується Microsoft Outlook для зберігання копій елементів поштових скриньок з серверу Exchange, забезпечуючи автономний доступ і синхронізацію з сервером при підключенні. Конвертація файлів MBOX у формат OST дозволяє безперешкодно інтегрувати дані електронної пошти у екосистему Microsoft Outlook, забезпечуючи сумісність, можливості офлайн‑доступу та синхронізацію з серверами Exchange, що підвищує продуктивність та управління даними в корпоративному середовищі.

Процес конвертації MBOX у OST за допомогою Aspose.Email для .NET включає кілька ключових компонентів та кроків. Наведений нижче приклад коду демонструє процес імпорту електронних листів з файлу MBOX у файл Microsoft Outlook OST (Offline Storage Table).

По‑першу, MboxStorageReader використовується для читання MBOX‑файлу, зазначеного в mboxFilePath. Цей компонент, налаштований з MboxLoadOptions, розбирає MBOX‑файл і готується до витягнення листів.
Після витягнення листів, PersonalStorage екземпляр створено за допомогою FromFile метод, який орієнтується на OST‑файл, зазначений у ostFilePath.
У цьому OST‑файлі папка Inbox (отримана через GetPredefinedFolder) визначено як папку призначення для конвертованих листів.
Ітеративно, кожен лист у файлі MBOX обробляється за допомогою mbox.EnumerateMessages(). Для кожного листа він перетворюється у об’єкт MapiMessage за допомогою MapiMessage.FromMailMessage(eml), де eml представляє витягнутий лист у форматі MailMessage.
Нарешті, кожен MapiMessage додається у папку Inbox в OST‑файлі за допомогою folderInfo.AddMessage(msg).

var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

using (var ost = PersonalStorage.FromFile(ostFilePath))
{
    var folderInfo = ost.GetPredefinedFolder(StandardIpmFolder.Inbox);

    foreach (var eml in mbox.EnumerateMessages())
    {
        var msg = MapiMessage.FromMailMessage(eml);
        folderInfo.AddMessage(msg);
    }
}

Конвертувати MBOX у PST

Формат PST (Personal Storage Table) — це файл даних, який використовується Microsoft Outlook для зберігання локальних копій листів, подій календаря та інших елементів. Конвертація файлів MBOX у формат PST дозволяє безперешкодно інтегрувати дані електронної пошти у екосистему Microsoft Outlook, забезпечуючи сумісність та легкий доступ.

Процес конвертації MBOX у PST схожий на Конвертація MBOX у OST і включає наступні компоненти та кроки:

The MboxStorageReader використовується для читання MBOX‑файлу, зазначеного в mboxFilePath.
The PersonalStorage екземпляр створюється за допомогою PersonalStorage.Create методу, який орієнтується на PST‑файл, зазначений у pstFilePath, та вказує формат Unicode для кращої сумісності.
У цьому PST‑файлі папка "Inbox" створюється за допомогою CreatePredefinedFolder методу, встановлюючи його як пункт призначення для конвертованих листів.
Ітеративно, кожен лист у файлі MBOX обробляється за допомогою mbox.EnumerateMessages(). Для кожного листа він конвертується у об’єкт MapiMessage за допомогою MapiMessage.FromMailMessage(eml), де eml представляє витягнутий лист у форматі MailMessage.
Нарешті, кожен MapiMessage додається у папку "Inbox" у файлі PST за допомогою folderInfo.AddMessage(msg), завершує процес конвертації.

var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

using (var personalStorage = PersonalStorage.Create(pstFilePath, FileFormatVersion.Unicode))
{
    var folderInfo = personalStorage.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox);

    foreach (var eml in mbox.EnumerateMessages())
    {
        var msg = MapiMessage.FromMailMessage(eml);
        folderInfo.AddMessage(msg);
    }
}

Конвертувати MBOX у TIFF

TIFF (Tagged Image File Format) — це універсальний та широко використовуваний формат зображень, який підтримує графіку високої якості. Він часто використовується для зберігання растрових графік і цінується за можливість обробки детальних зображень без втрати якості завдяки безвтратному стисненню.

Aspose.Email для .NET пропонує потужне рішення для конвертації файлів MBOX у формат TIFF. Наведений фрагмент коду демонструє процес читання файлу MBOX та перетворення кожного електронного листа у зображення TIFF.

Ініціалізуйте читач MBOX, використовуючи CreateReader метод MboxStorageReader клас, який відповідає за читання файлу MBOX. Вкажіть шлях до файлу та параметри завантаження за допомогою MboxLoadOptions.
Створіть каталог виводу для TIFF‑файлу, якщо його ще немає.
Перебирайте кожен електронний лист у файлі MBOX за допомогою mbox.EnumerateMessages().
Сформуйте шлях до файлу для кожного TIFF‑файлу, називаючи їх послідовно як "Message1.tiff", "Message2.tiff", тощо.
Ініціалізуйте поштовий принтер для конвертації електронних листів у формат TIFF.
Встановіть властивості принтера:
- FormattingFlags забезпечує включення інформації про лист (наприклад, відправника, отримувача тощо) у вихідний файл.
- PageUnit встановлює одиницю виміру для налаштувань принтера в сантиметри.
- AutoFitWidth забезпечує, що ширина вмісту підлаштовується під розмір сторінки.
Використайте останній рядок для конвертації електронного листа у TIFF‑файл та збереження його за вказаним шляхом.

var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

Directory.CreateDirectory(outputDirectory);

int count = 1;

foreach (var eml in mbox.EnumerateMessages())
{
    var tiffFilePath = Path.Combine(outputDirectory, $"Message{count}.tiff");

    var printer = new Printing.MailPrinter();

    printer.FormattingFlags = Printing.MessageFormattingFlags.MailInfo;

    printer.PageUnit = Printing.PrinterUnit.Cm;

    printer.FormattingFlags = Aspose.Email.Printing.MessageFormattingFlags.AutoFitWidth;

    printer.Print(eml, tiffFilePath, Aspose.Email.Printing.PrintFormat.Tiff);

Спеціальні функції

Користувацьке форматування:

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

Налаштування сторінки:

Змінити PageUnit та інші властивості для відповідності конкретним вимогам макету сторінки (наприклад, дюйми, пікселі).

Багатосторінкові TIFF:

Aspose.Email дозволяє створювати багатосторінкові TIFF‑файли, що може бути корисним для листів з довгим тілом або декількома вкладеннями.

Конвертувати MBOX у VCF

VCF (vCard File) — це широко використаний формат для зберігання контактної інформації. Він часто використовується для обміну контактними даними між різними застосунками та пристроями завдяки простоті та сумісності.

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

Ініціалізуйте читач MBOX для читання файлу MBOX за допомогою CreateReader метод MboxStorageReader клас.
Переконайтеся, що каталог виводу існує, створивши його за потреби.
Налаштуйте лічильник для відстеження кількості оброблених листів.
Перебирайте кожен електронний лист у файлі MBOX за допомогою mbox.EnumerateMessages().
Сформуйте шлях до файлу для кожного VCF‑файлу, називаючи їх послідовно.
Отримайте вміст vCard (VCF) з електронного листа за допомогою GetAlternateViewContent.
Якщо вміст vCard існує, запишіть його у VCF‑файл за вказаним шляхом.

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

var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

Directory.CreateDirectory(outputDirectory);

int count = 1;

foreach (var eml in mbox.EnumerateMessages())
{
    var vcfFilePath = Path.Combine(outputDirectory, $"Message{count}.vcf");

    var vcfView = eml.GetAlternateViewContent("text/vcard");

    if (vcfView != null)
    {
        File.WriteAllText(vcfFilePath, vcfView);
    }

    Console.WriteLine($"Message {count} saved as: {vcfFilePath}");

}

Конвертувати MBOX у XPS

XPS (XML Paper Specification) — це формат документів з фіксованим макетом, який зберігає точність документу та підтримує графіку високої якості. Він широко використовується для спільного використання, друку та архівування документів завдяки здатності зберігати макет і дизайн на різних пристроях.

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

Використайте CreateReader метод MboxStorageReader клас для читання файлу MBOX, вказуючи шлях до файлу та параметри завантаження за допомогою MboxLoadOptions.
Переконайтеся, що каталог виводу для XPS‑файлів існує, створивши його за потреби.
Перебирайте кожен електронний лист у файлі MBOX за допомогою mbox.EnumerateMessages().
Сформуйте шлях до файлу для кожного XPS‑файлу, називаючи їх послідовно як "Message1.xps", "Message2.xps" тощо.
Ініціалізуйте поштовий принтер для обробки перетворення електронних листів у формат XPS.
Налаштуйте властивості принтера, щоб забезпечити правильне форматування вмісту електронного листа:
- FormattingFlags забезпечує включення інформації про лист (наприклад, відправника, отримувача тощо) у вихідний файл.
- PageUnit встановлює одиницю виміру для налаштувань принтера в сантиметри.
- AutoFitWidth забезпечує, що ширина вмісту підлаштовується під розмір сторінки.
Використайте останній рядок, щоб конвертувати повідомлення електронної пошти у файл XPS і зберегти його за вказаним шляхом.

var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

Directory.CreateDirectory(outputDirectory);

int count = 1;

foreach (var eml in mbox.EnumerateMessages())
{
    var xpsFilePath = Path.Combine(outputDirectory, $"Message{count}.xps");

    var printer = new Printing.MailPrinter();

    printer.FormattingFlags = Printing.MessageFormattingFlags.MailInfo;

    printer.PageUnit = Printing.PrinterUnit.Cm;

    printer.Print(eml, xpsFilePath, Printing.PrintFormat.XPS);

    Console.WriteLine($"Message {count} saved as: {xpsFilePath}");

    count++;
}