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

Net: Четене на MBOX файлове с Aspose.Email в C#

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

Възможности за четене с Aspose.Email

Mozilla Thunderbird е отворен код, крос‑платформен имейл клиент, разработен от Mozilla Foundation. Той съхранява имейлите в собствена файлова структура, управлявайки индекси на съобщенията и подпапките чрез патентовани файлови формати. Thunderbird създава един .mbox файл за всяка имейл папка (например Inbox, Sent, Trash) и съхранява тези файлове в директорията на потребителския профил. Всеки файл съдържа всички съобщения от съответната папка в конкатенирана форма.

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 метод. Тази функция е особено полезна в приложения, които работят с големи имейл архиви или изпълняват I/O‑спрямо операции в фонови нишки или уеб услуги. Следният примерен код демонстрира как да четете имейл съобщения от 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 файлове

Този 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

Този MboxStorageReader класът включва EnumerateMessageInfo() метод, който ви позволява да итерирате през всяко съобщение в MBOX файл. Чрез използване на този метод е възможно да се извлекат отделни съобщения без необходимостта да се обхожда цялото хранилище многократно. Това подобрява производителността и намалява времето за обработка.

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

Този 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 for .NET предоставя възможност за филтриране или търсене на съобщения в пощенски архиви въз основа на персонализирани заявки. Това позволява на разработчиците да извличат само съобщения, отговарящи на конкретни критерии, подобрявайки производителността и удобството при работа с големи файлове от имейл архиви.

Следният примерен код демонстрира как да приложите критерии за търсене към файл за съхранение на поща с MailQuery API. В този пример съобщенията се избират, ако темата им съдържа фразата „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 for .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 for .NET предоставя асинхронния SplitIntoAsync метод, който ви позволява да разделяте големи файлове на по‑малки части - без блокиране на главния нишка. Следният примерен код показва как да се използва MboxStorageReader.CreateReaderAsync за отваряне на голям MBOX файл асинхронно и след това извикване на SplitIntoAsync за да се раздели на по‑малки файлове, всеки с максимален размер от 10 MB. Получените части се записват в указаната изходна директория с представка „chunk_“.

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