Documentation – Як читати та конвертувати MBOX файли Thunderbird у .NET

Net: Читання файлів MBOX за допомогою Aspose.Email у C#

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

Можливості читання Aspose.Email

Mozilla Thunderbird це відкритий, крос‑платформений клієнт електронної пошти, розроблений Mozilla Foundation. Він зберігає листи у власній файловій структурі, керуючи індексами повідомлень та підпапками за допомогою пропрієтарних форматів файлів. Thunderbird створює один .mbox файл для кожної папки електронної пошти (наприклад, Вхідні, Надіслані, Видалені) і зберігає ці файли в каталозі профілю користувача. Кожен файл містить усі повідомлення з цієї папки у злитій формі.

Aspose.Email для .NET надає API для читання повідомлень з .mbox файлів Thunderbird, використовуючи MboxrdStorageReader клас, який дозволяє розробникам:

Відкривати та читати повідомлення послідовно, по одному
Отримати метадані, такі як Тема, Від, Кому, Дата тощо, без завантаження повного вмісту
Витягнути окремі повідомлення, використовуючи унікальні ідентифікатори (EntryId)
Зберігати кодування, вкладення TNEF та форматування
Читати файли асинхронно для кращої продуктивності на великих архівах

Синхронне читання MBOX файлів

читати повідомлення з файлу сховища пошти Mozilla Thunderbird. У цій статті показано, як читати повідомлення зі сховища електронної пошти Thunderbird:

Відкрийте файл сховища Thunderbird у FileStream.
Створіть екземпляр MboxrdStorageReader класу і передайте вищезгаданий потік у конструктор.
Викличте ReadNextMessage() щоб отримати перше повідомлення.
Використайте той самий ReadNextMessage() у циклі while, щоб прочитати всі повідомлення.
Закрийте всі потоки.

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

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read);
// Create an instance of the MboxrdStorageReader class and pass the stream
var reader = new MboxrdStorageReader(stream, false);
// Start reading messages
var message = reader.ReadNextMessage();

// Read all messages in a loop
while (message != null)
{
    // Manipulate message - show contents
    Console.WriteLine("Subject: " + message.Subject);
    // Save this message in EML or MSG format
    message.Save(message.Subject + ".eml", SaveOptions.DefaultEml);
    message.Save(message.Subject + ".msg", SaveOptions.DefaultMsgUnicode);

    // Get the next message
    message = reader.ReadNextMessage();
}

// Close the streams
reader.Dispose();
stream.Close();

Асинхронне читання MBOX файлів

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

string mboxFilePath = "emails.mbox";

    // Create a reader for the MBOX file asynchronously
    using (var reader = await MboxrdStorageReader.CreateReaderAsync(mboxFilePath, CancellationToken.None))
    {
    Console.WriteLine("MBOX reader initialized.");

    // Read messages from the MBOX file
        while (reader.ReadNextMessage() is var message && message != null)
        {
            Console.WriteLine($"Subject: {message.Subject}");
        }
    }

Читати електронні повідомлення пакетами з підтримкою пагінації

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

EnumerateMessages(int startIndex, int count) - Повертає перелічувану колекцію екземплярів MailMessage, починаючи з вказаного індексу та обмежену заданою кількістю.
EnumerateMessageInfo(int startIndex, int count) - Повертає перелічувану колекцію об’єктів MboxMessageInfo лише з метаданими, також посторінково за індексом та кількістю.

Нижченаведений приклад коду демонструє, як читати певний діапазон повідомлень із поштового архіву, визначивши початковий індекс і розмір пакету. У прикладі метод отримує 10 повідомлень, починаючи з індексу 0.

using Aspose.Email.Storage.Mbox;
using Aspose.Email;

var reader = MboxStorageReader.CreateReader("input.mbox", new MboxLoadOptions());
int startIndex = 0;
int count = 10; // Retrieve messages in batches of 10

foreach (var message in reader.EnumerateMessages(startIndex, count))
{
    Console.WriteLine("Subject: " + message.Subject);
}

Встановити бажане кодування тексту при завантаженні MBOX файлів для читання

Опція кодування доступна для MboxrdStorageReader клас. Це забезпечує додаткові параметри завантаження файлу mbox і гарантує, що повідомлення з закодованим вмістом будуть правильно прочитані та оброблені. Наведений нижче фрагмент коду показує, як можна встановити кодування тексту, що відповідає вашим потребам:

var reader = new MboxrdStorageReader("sample.mbox", new MboxLoadOptions() { PreferredTextEncoding = Encoding.UTF8});
var message = reader.ReadNextMessage();

Отримати загальну кількість повідомлень у файлах MBOX

The MboxrdStorageReader клас забезпечує можливість читати кількість елементів, доступних у файлі MBox. Це можна використати для розробки застосунків, які показують прогрес дії під час обробки такого файлу.

// The path to the File directory.
var dataDir = RunExamples.GetDataDir_Thunderbird();

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    Console.WriteLine("Total number of messages in Mbox file: " + reader.GetTotalItemsCount());
}

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

using (var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Read))
using (var reader = new MboxrdStorageReader(stream, false))
{
    MailMessage msg;
    while ((msg = reader.ReadNextMessage()) != null)
    {
        long currentDataSize = reader.CurrentDataSize;

        msg.Dispose();
    }
}

Net: Фільтрація та екстракція повідомлень MBOX за допомогою Aspose.Email у C#

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

Роль фільтрації повідомлень

При роботі з великими архівами MBOX завантаження кожного повідомлення в пам’ять може бути неефективним та зайвим. У більшості випадків розробникам достатньо просканувати базові метадані, такі як тема, відправник, отримувач або мітка часу, щоб:

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

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

Доступ до метаданих повідомлення

Aspose.Email надає MboxMessageInfo клас, розроблений для доступу до базових метаданих повідомлення без читання повного вмісту MailMessage. Він діє як об’єкт‑резюме і повертається під час виклику MboxStorageReader.EnumerateMessageInfo().

Ключові властивості, що надаються MboxMessageInfo для отримання інформації про повідомлення включає:

DateTime Date - Повертає дату повідомлення
MailAddress From - Повертає адресу відправника
string Subject - Повертає тему повідомлення
MailAddressCollection До - Повертає колекцію адрес, що містить одержувачів повідомлення
MailAddressCollection CC - Повертає колекцію адрес, що містить CC одержувачів
MailAddressCollection Bcc - Повертає колекцію адрес, що містить BCC одержувачів повідомлення

MboxStorageReader reader = MboxStorageReader.CreateReader(fileName, new MboxLoadOptions());

foreach (var mboxMessageInfo in reader.EnumerateMessageInfo())
{
    Console.Writeline($"Subject: {mboxMessageInfo.Subject}");
    Console.Writeline($"Date: {mboxMessageInfo.Date}");
    Console.Writeline($"From: {mboxMessageInfo.From}");
    Console.Writeline($"To: {mboxMessageInfo.To}");
    Console.Writeline($"CC: {mboxMessageInfo.CC}");
    Console.Writeline($"Bcc: {mboxMessageInfo.Bcc}");
}

Видобуток повідомлень за EntryId

The MboxStorageReader клас включає EnumerateMessageInfo() метод, який дозволяє перебирати кожне повідомлення у MBOX файлі. Використовуючи цей метод, можна витягнути окремі повідомлення без необхідності багаторазово проходити весь файл. Це підвищує продуктивність і зменшує час обробки.

The MboxMessageInfo class надає EntryId властивість, яка забезпечує доступ до унікальних ідентифікаторів кожного повідомлення у MBOX файлі. Цей ідентифікатор можна зберігати в базі даних або використовувати як посилання для швидкого пошуку та витягування потрібних повідомлень.

The ExtractMessage(string id) метод у MboxStorageReader клас дозволяє розробникам витягувати повідомлення за їх унікальним EntryId. За допомогою ExtractMessage(string id) метод, ви можете використати збережений EntryId для отримання відповідного повідомлення та виконати додаткові операції з ним.

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

MboxStorageReader reader = MboxStorageReader.CreateReader("my.mbox", new MboxLoadOptions());

foreach (MboxMessageInfo msgInfo in reader.EnumerateMessageInfo())
{
    MailMessage eml = reader.ExtractMessage(msgInfo.EntryId, new EmlLoadOptions());
}

Фільтрація і пошук електронних листів MBOX за допомогою MailQuery

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

Нижче наведено приклад коду, який демонструє, як застосувати критерії пошуку до файлу сховища пошти за допомогою API MailQuery. У цьому прикладі повідомлення вибираються, якщо їхня тема містить фразу "Project Update" і вони були надіслані до сьогоднішньої дати.

using Aspose.Email.Storage.Mbox;
using Aspose.Email;

var reader = MboxStorageReader.CreateReader("input.mbox", new MboxLoadOptions());
var mqb = new MailQueryBuilder();
mqb.Subject.Contains("Project Update");
mqb.SentDate.Before(DateTime.Today);

foreach (var message in reader.EnumerateMessages(mqb.GetQuery()))
{
    Console.WriteLine("Subject: " + message.Subject);
}

Налаштування параметрів завантаження під час читання повідомлень з MBOX

Наступні функції дозволяють вказати різні параметри, пов’язані з завантаженням і обробкою повідомлень:

Власність MailStorageConverter.MboxMessageOptions — отримує або встановлює параметри завантаження електронної пошти при розборі сховища Mbox.
Метод MboxrdStorageReader.ReadNextMessage(EmlLoadOptions options) — параметр EmlLoadOptions вказує параметри під час читання повідомлення зі сховища Mbox.

var reader = new MboxrdStorageReader(fileName, new MboxLoadOptions());
// Read messages preserving tnef attachments.
var eml = reader.ReadNextMessage(new EmlLoadOptions {PreserveTnefAttachments = true});
MailStorageConverter.MboxMessageOptions(new EmlLoadOptions {PreserveTnefAttachments = true});
// Convert messages from mbox to pst preserving tnef attachments.
var pst = MailStorageConverter.mboxToPst("Input.mbox", "Output.pst");

Net: Запис MBOX файлів за допомогою Aspose.Email на C#

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

Запис MBOX файлів

Якщо вам потрібно програмно створювати або оновлювати MBOX файли, використовуйте Aspose.Email MboxrdStorageWriter клас, який дозволяє записувати нові повідомлення у файл сховища пошти Thunderbird.

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

Відкрийте файл сховища Thunderbird у FileStream.
Створіть екземпляр MboxrdStorageWriter класу і передайте вищезгаданий потік у конструктор.
Підготуйте нове повідомлення за допомогою MailMessage клас.
Викличте WriteMessage() метод і передайте вищезазначене MailMessage екземпляр для додавання повідомлення у сховище Thunderbird.
Закрийте всі потоки.

// Open the storage file with FileStream
var stream = new FileStream(dataDir + "ExampleMbox.mbox", FileMode.Open, FileAccess.Write);

// Initialize MboxStorageWriter and pass the above stream to it
var writer = new MboxrdStorageWriter(stream, false);
// Prepare a new message using the MailMessage class
var message = new MailMessage("from@domain.com", "to@domain.com", Guid.NewGuid().ToString(), "added from Aspose.Email");
message.IsDraft = false;
// Add this message to storage
writer.WriteMessage(message);
// Close all related streams
writer.Dispose();
stream.Close();

Net: Конвертація MBOX у PST за допомогою Aspose.Email у C#

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

Конвертація MBOX у PST. Базова конвертація

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

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

Ініціалізуйте MBOX‑читач за допомогою MboxStorageReader.CreateReader().
Створіть PST‑файл за допомогою PersonalStorage.Create().
Додайте поштову папку (наприклад, "Inbox") у сховище.
Пройдіться по кожному повідомленню, конвертуйте його у MapiMessage, і вставте його у папку.

// Load the source file
var mbox = MboxStorageReader.CreateReader(mboxFilePath, new MboxLoadOptions());

// Create the destination Outlook data file
using (var personalStorage = PersonalStorage.Create(pstFilePath, FileFormatVersion.Unicode))
{
    // Add a folder to hold imported messages
    var folderInfo = personalStorage.CreatePredefinedFolder("Inbox", StandardIpmFolder.Inbox);

    // Process each message from the source file
    foreach (var eml in mbox.EnumerateMessages())
    {
        var msg = MapiMessage.FromMailMessage(eml);
        folderInfo.AddMessage(msg);
    }
}

Видалити цифрові підписи під час конвертації

У деяких випадках цифрові підписи, вбудовані в повідомлення, не потрібні у цільовому файлі. Щоб виключити їх під час передачі, встановіть RemoveSignature властивість у MboxToPstConversionOptions на true.

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

var pstDataStream = new MemoryStream();
var personalStorage = PersonalStorage.Create(pstDataStream, FileFormatVersion.Unicode);
MailStorageConverter.MboxToPst(new MboxrdStorageReader(new FileStream(fileName, FileMode.Open, FileAccess.Read), new MboxLoadOptions()),
personalStorage,
    "Inbox",
new MboxToPstConversionOptions() { RemoveSignature = true });

Net: Розділення файлів MBOX за допомогою Aspose.Email у C#

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

Розділити сховище MBOX/Скасувати операцію розділення

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

Підтримувані API згідно версії .NET

Для .NET Framework 4.5 та .NET Core

Ви можете сегментувати дані MBOX за допомогою SplitInto метод MboxStorageReader клас, з можливістю включити токен скасування або налаштувати назву вихідного файлу:

Параметри:

chunkSize: Приблизний розмір кожної частини в байтах.
outputPath: Шлях до папки, в якій будуть створені частини.
partFileNamePrefix: Префікс, який додається до імені файлу кожної частини.
token: Об’єкт CancellationToken, який дозволяє при необхідності скасувати операцію.

Для версій .NET нижче 4.5

Попередні версії підтримують те саме SplitInto метод, але без токенів скасування:

SplitInto(long chunkSize, string outputPath)
SplitInto(long chunkSize, string outputPath, string partFileNamePrefix)
Cancel() — використовується для переривання процесу розділення посередині.

Зразки коду для контрольованого розділення з відміною

Нижче наведено зразки коду, які демонструють, як розбити архів на до 5 частин, автоматично скасувавши операцію після цього:

.NET 4.5 / .NET Core

int partCount = 0;

var tokenSource = new CancellationTokenSource();

var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });

// Subscribe to events
mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        tokenSource.Cancel();
};

System.Threading.Tasks.Task task = mbox.SplitInto(10000000, outputPath, tokenSource.Token);
task.Wait();

Нижче .NET 4.5

int partCount = 0;
var mbox = new MboxrdStorageReader(fileName, new MboxLoadOptions { LeaveOpen = false });
mbox.SplitInto(10000000, outputPath);

mbox.MboxFileCreated += (sender, e) =>
{
    partCount++;
    if (partCount >= 5)
        mbox.Cancel();
};

Асинхронне розділення великих файлів MBOX

Робота з великими архівами електронної пошти може бути неефективною та витрачати багато пам’яті. Для підвищення продуктивності та зручності керування Aspose.Email для .NET пропонує асинхронний SplitIntoAsync метод, який дозволяє розбивати великі файли на менші частини — без блокування головного потоку. Наведений нижче приклад коду показує, як використовувати MboxStorageReader.CreateReaderAsync для асинхронного відкриття великого файлу MBOX, а потім викликати SplitIntoAsync для поділу його на менші файли, кожен розміром максимум 10 МБ. Отримані частини зберігаються у вказаній вихідній теці з префіксом "chunk_".

using (var reader = await MboxStorageReader.CreateReaderAsync("input.mbox", new MboxLoadOptions()))
{
    await reader.SplitIntoAsync(10 * 1024 * 1024, "outputDirectory", "chunk_", CancellationToken.None);
}