Documentation – چگونه فایل‌های MBOX Thunderbird را در .NET بخوانیم و تبدیل کنیم

Net: خواندن فایل‌های MBOX با Aspose.Email در C#

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

قابلیت‌های خواندن Aspose.Email

Mozilla Thunderbird یک کلاینت ایمیل متن باز و چند پلتفرمی است که توسط بنیاد Mozilla توسعه یافته است. این برنامه ایمیل‌ها را در ساختار فایل خود ذخیره می‌کند، ایندکس‌های پیام‌ها و زیرپوشه‌ها را از طریق فرمت‌های فایل مالکیتی مدیریت می‌کند. Thunderbird برای هر پوشه ایمیل (مثلاً Inbox، Sent، Trash) یک فایل .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 متد. این ویژگی مخصوصاً در برنامه‌هایی که آرشیوهای بزرگ ایمیل را مدیریت می‌کنند یا عملیات‌های وابسته به I/O را در رشته‌های پس‌زمینه یا سرویس‌های وب اجرا می‌کنند مفید است. نمونه کد زیر نشان می‌دهد چگونه می‌توانید پیام‌های ایمیل را به‌صورت ناهمزمان از یک فایل MBOX با استفاده از یک Aspose.Email storage reader بخوانید:

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 را فقط با متاداده‌ها برمی‌گرداند، همچنین بر اساس شاخص و تعداد صفحه‌بندی می‌شود.

نمونه کد زیر نشان می‌دهد چگونه می‌توان یک بازه مشخص از پیام‌ها را از آرشیو ایمیل با تعریف یک شاخص شروع و اندازه‌ی دسته‌ای خواند. در این مثال، متد ۱۰ پیام را از شاخص ۰ شروع می‌کند.

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 class. این گزینه‌های اضافی برای بارگذاری فایل 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 برای .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() - برای قطع فرآیند تقسیم در میانه استفاده می‌شود.

نمونه‌های کد برای تقسیم کنترل‌شده با لغو

نمونه‌های کد زیر نشان می‌دهند چگونه یک آرشیو را به حداکثر ۵ بخش تقسیم کنید و پس از آن به‌صورت خودکار عملیات را لغو کنید:

.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 به‌منظور تقسیم آن به فایل‌های کوچکتر، هر کدام با حداکثر حجم ۱۰ مگابایت. تکه‌های حاصل در پوشه خروجی مشخص شده با پیشوند "chunk_" ذخیره می‌شوند.

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