Documentation – Cách đọc và chuyển đổi tệp MBOX của Thunderbird trong .NET

Net: Đọc tệp MBOX với Aspose.Email trong C#

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

Khả Năng Đọc của Aspose.Email

Mozilla Thunderbird là một ứng dụng khách email mã nguồn mở, đa nền tảng, được phát triển bởi Mozilla Foundation. Nó lưu trữ email trong cấu trúc tệp riêng, quản lý các chỉ mục tin nhắn và thư mục con thông qua các định dạng tệp độc quyền. Thunderbird tạo một tệp .mbox cho mỗi thư mục email (ví dụ: Inbox, Sent, Trash), và lưu các tệp này trong thư mục hồ sơ của người dùng. Mỗi tệp chứa tất cả các tin nhắn của thư mục đó dưới dạng nối tiếp.

Aspose.Email cho .NET cung cấp API để đọc tin nhắn từ các tệp .mbox của Thunderbird bằng cách sử dụng MboxrdStorageReader lớp cho phép các nhà phát triển:

Mở và đọc các tin nhắn tuần tự, từng cái một
Lấy siêu dữ liệu như Chủ đề, Người gửi, Người nhận, Ngày, v.v., mà không tải toàn bộ nội dung
Trích xuất từng tin nhắn bằng cách sử dụng bộ định danh duy nhất (EntryId)
Bảo tồn mã hoá, tệp đính kèm TNEF và định dạng
Đọc tệp một cách bất đồng bộ để hiệu năng tốt hơn trên các kho lưu trữ lớn

Đọc Tệp MBOX Đồng Bộ

đọc tin nhắn từ tệp lưu trữ thư của Mozilla Thunderbird. Bài viết này chỉ cách đọc các tin nhắn từ lưu trữ email Thunderbird:

Mở tệp lưu trữ Thunderbird trong FileStream.
Tạo một đối tượng của MboxrdStorageReader lớp và truyền luồng trên vào hàm khởi tạo.
Gọi ReadNextMessage() để lấy tin nhắn đầu tiên.
Sử dụng cùng ReadNextMessage() trong vòng lặp while để đọc tất cả các tin nhắn.
Đóng tất cả các luồng.

Đoạn mã dưới đây cho bạn thấy cách đọc tất cả các tin nhắn từ bộ lưu trữ thư của 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();

Đọc Tệp MBOX Bất Đồng Bộ

Để nâng cao hiệu năng và khả năng đáp ứng khi xử lý các tệp MBOX lớn, Aspose.Email cho .NET cung cấp việc đọc MBOX bất đồng bộ thông qua CreateReaderAsync phương thức. Tính năng này đặc biệt hữu ích trong các ứng dụng xử lý kho thư điện tử lớn hoặc thực hiện các thao tác I/O trong các luồng nền hoặc dịch vụ web. Mẫu mã sau minh họa cách đọc tin nhắn email từ tệp MBOX một cách bất đồng bộ bằng cách sử dụng trình đọc lưu trữ 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}");
        }
    }

Đọc Tin Nhắn Email Theo Lô Với Hỗ Trợ Phân Trang

Lấy quyền truy cập phân trang vào các tin nhắn được lưu trong các tệp hộp thư. Tính năng này cho phép các nhà phát triển xử lý các kho thư điện tử lớn hiệu quả hơn bằng cách nhận các tin nhắn thành các phần nhỏ hơn - cải thiện hiệu suất và giảm tải bộ nhớ. Sử dụng các phương thức sau của MboxStorageReader lớp:

EnumerateMessages(int startIndex, int count) - Trả về một tập hợp có thể lặp lại các đối tượng MailMessage, bắt đầu từ chỉ mục được chỉ định và giới hạn bởi số lượng đã cho.
EnumerateMessageInfo(int startIndex, int count) - Trả về một tập hợp có thể lặp lại các đối tượng MboxMessageInfo chỉ chứa siêu dữ liệu, cũng được phân trang theo chỉ mục và số lượng.

Mẫu mã dưới đây minh họa cách đọc một dải tin nhắn cụ thể từ kho thư bằng cách xác định chỉ mục bắt đầu và kích thước lô. Trong ví dụ, phương thức lấy 10 tin nhắn bắt đầu từ chỉ mục 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);
}

Đặt Mã Hoá Văn Bản Ưu Tiên Khi Tải Tệp MBOX Để Đọc

Tùy chọn mã hoá khả dụng cho MboxrdStorageReader class. Điều này cung cấp các tùy chọn bổ sung để tải tệp mbox và đảm bảo rằng các tin nhắn có nội dung được mã hoá sẽ được đọc và xử lý chính xác. Đoạn mã sau cho thấy cách bạn có thể đặt mã hoá văn bản đáp ứng nhu cầu của mình:

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

Lấy tổng số tin nhắn từ tệp MBOX

Cái MboxrdStorageReader lớp cung cấp khả năng đọc số lượng mục có trong tệp MBox. Điều này có thể được sử dụng để phát triển các ứng dụng hiển thị tiến độ hoạt động khi xử lý tệp như vậy.

// 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());
}

Lấy kích thước tin nhắn hiện tại

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: Lọc và Trích xuất tin nhắn MBOX với Aspose.Email trong C#

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

Vai trò của việc lọc tin nhắn

Khi làm việc với các kho lưu trữ MBOX lớn, tải mọi tin nhắn vào bộ nhớ có thể không hiệu quả và không cần thiết. Trong hầu hết các trường hợp, nhà phát triển chỉ cần quét siêu dữ liệu cơ bản như tiêu đề, người gửi, người nhận hoặc thời gian để:

Hiển thị danh sách tin nhắn trong giao diện người dùng
Áp dụng bộ lọc tùy chỉnh trước khi trích xuất
Tạo báo cáo hoặc tóm tắt
Lập chỉ mục tin nhắn để tìm kiếm

Lọc tránh được chi phí phân tích toàn bộ nội dung tin nhắn hoặc tệp đính kèm, làm cho ứng dụng nhanh hơn và mở rộng tốt hơn.

Truy cập siêu dữ liệu tin nhắn

Aspose.Email cung cấp MboxMessageInfo lớp được thiết kế để truy cập siêu dữ liệu tin nhắn cơ bản mà không cần đọc toàn bộ nội dung MailMessage. Nó hoạt động như một đối tượng tóm tắt và được trả về khi gọi MboxStorageReader.EnumerateMessageInfo().

Các thuộc tính chính được cung cấp bởi MboxMessageInfo để truy xuất thông tin về một tin nhắn bao gồm:

DateTime Ngày - Lấy ngày của tin nhắn
MailAddress Từ - Lấy địa chỉ người gửi
string Tiêu đề - Lấy tiêu đề tin nhắn
MailAddressCollection Đến - Lấy tập hợp địa chỉ chứa người nhận của tin nhắn
MailAddressCollection CC - Lấy tập hợp địa chỉ chứa người nhận CC
MailAddressCollection Bcc - Lấy tập hợp địa chỉ chứa người nhận BCC của tin nhắn

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}");
}

Trích xuất tin nhắn theo EntryId

Cái MboxStorageReader lớp bao gồm EnumerateMessageInfo() phương thức, cho phép bạn duyệt qua từng tin nhắn trong tệp MBOX. Khi sử dụng phương thức này, bạn có thể trích xuất các tin nhắn riêng lẻ mà không cần phải quét toàn bộ lưu trữ nhiều lần. Điều này cải thiện hiệu suất và giảm thời gian xử lý.

Cái MboxMessageInfo class cung cấp EntryId thuộc tính, cung cấp quyền truy cập vào các định danh duy nhất cho mỗi tin nhắn trong tệp MBOX. Định danh này có thể được lưu trong cơ sở dữ liệu hoặc sử dụng làm tham chiếu để nhanh chóng tìm và trích xuất các tin nhắn cụ thể khi cần.

Cái ExtractMessage(string id) phương thức trong MboxStorageReader lớp cho phép các nhà phát triển trích xuất tin nhắn dựa trên EntryId duy nhất của chúng. Với ExtractMessage(string id) phương thức, bạn có thể sử dụng EntryId đã lưu để lấy tin nhắn tương ứng và thực hiện các thao tác bổ sung với nó.

Mẫu mã sau đây minh họa cách trích xuất tin nhắn từ tệp MBOX bằng cách sử dụng các định danh:

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

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

Lọc và Tìm kiếm email MBOX bằng MailQuery

Aspose.Email cho .NET cung cấp khả năng lọc hoặc tìm kiếm tin nhắn trong các kho lưu trữ hộp thư dựa trên các truy vấn tùy chỉnh. Điều này cho phép nhà phát triển chỉ truy xuất những tin nhắn khớp với tiêu chí cụ thể, cải thiện hiệu suất và khả năng sử dụng khi làm việc với các tệp lưu trữ email lớn.

Đoạn mã mẫu sau đây minh họa cách áp dụng tiêu chí tìm kiếm vào tệp lưu trữ thư bằng MailQuery API. Trong ví dụ này, các tin nhắn được chọn nếu tiêu đề của chúng chứa cụm từ "Project Update" và được gửi trước ngày hôm nay.

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);
}

Cấu hình tùy chọn tải khi đọc tin nhắn từ MBOX

Các tính năng sau sẽ cho phép bạn chỉ định các tùy chọn khác nhau liên quan tới việc tải và xử lý tin nhắn:

Thuộc tính MailStorageConverter.MboxMessageOptions - Lấy hoặc đặt các tùy chọn tải email khi phân tích lưu trữ Mbox.
Phương thức MboxrdStorageReader.ReadNextMessage(EmlLoadOptions options) - Tham số EmlLoadOptions chỉ định các tùy chọn khi đọc tin nhắn từ lưu trữ 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: Ghi Tệp MBOX với Aspose.Email trong C#

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

Ghi Tệp MBOX

Nếu bạn cần tạo hoặc cập nhật tệp MBOX một cách lập trình, hãy sử dụng Aspose.Email MboxrdStorageWriter lớp cho phép bạn ghi các tin nhắn mới vào tệp lưu trữ thư của Thunderbird.

Đoạn mã sau cho bạn thấy cách ghi tin nhắn vào lưu trữ thư của Thunderbird:

Mở tệp lưu trữ Thunderbird trong FileStream.
Tạo một đối tượng của MboxrdStorageWriter lớp và truyền luồng trên vào hàm khởi tạo.
Chuẩn bị một tin nhắn mới bằng cách sử dụng MailMessage lớp.
Gọi WriteMessage() phương thức và truyền những giá trị ở trên MailMessage đối tượng để thêm tin nhắn vào bộ lưu trữ Thunderbird.
Đóng tất cả các luồng.

// 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: Chuyển đổi MBOX sang PST với Aspose.Email trong C#

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

Chuyển đổi MBOX sang PST. Chuyển đổi cơ bản

Khi di chuyển dữ liệu mail từ các khách hàng như Mozilla Thunderbird sang Microsoft Outlook, việc chuyển đổi các kho lưu trữ MBOX sang định dạng PST (Personal Storage Table) thường được yêu cầu. Định dạng PST là định dạng gốc của Outlook và Exchange và hỗ trợ các tính năng nâng cao như cấu trúc thư mục và xử lý tin nhắn dựa trên MAPI.

Aspose.Email cho .NET cho phép nhà phát triển chuyển thủ công các tin nhắn từ tệp MBOX vào bộ lưu trữ tương thích Outlook với quyền kiểm soát đầy đủ quá trình chuyển đổi. Dưới đây là một ví dụ minh họa cách tải tin nhắn từ kho lưu trữ MBOX và lưu chúng vào một tệp dữ liệu Outlook có cấu trúc:

Khởi tạo trình đọc MBOX bằng cách sử dụng MboxStorageReader.CreateReader().
Tạo tệp PST bằng cách sử dụng PersonalStorage.Create().
Thêm một thư mục mail (ví dụ, “Inbox”) vào bộ lưu trữ.
Lặp qua từng tin nhắn, chuyển đổi nó thành một MapiMessage, và chèn nó vào thư mục.

// 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);
    }
}

Xóa chữ ký số trong quá trình chuyển đổi

Trong một số trường hợp, chữ ký số nhúng trong tin nhắn không cần thiết trong tệp đích. Để loại bỏ chúng trong quá trình chuyển, đặt RemoveSignature thuộc tính trong MboxToPstConversionOptions đến true.

Mẫu mã sau đây cho thấy cách sử dụng thuộc tính này:

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: Chia tách các tệp MBOX với Aspose.Email trong C#

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

Chia lưu trữ MBOX/Hủy thao tác chia

Aspose.Email cung cấp các phương thức để chia các tệp hộp thư lớn thành các phần có thể quản lý được. Điều này giúp cải thiện hiệu suất và hiệu quả bộ nhớ, đặc biệt khi làm việc với các lưu trữ email lớn. Các tùy chọn chia sẵn có thay đổi tùy theo phiên bản .NET bạn đang sử dụng.

Các API được hỗ trợ theo phiên bản .NET

Đối với .NET Framework 4.5 và .NET Core

Bạn có thể chia đoạn dữ liệu MBOX bằng cách sử dụng SplitInto phương thức của MboxStorageReader lớp, với tùy chọn bao gồm token hủy hoặc tùy chỉnh tên tệp đầu ra:

Tham số:

chunkSize: Kích thước xấp xỉ của mỗi phần tính bằng byte.
outputPath: Đường dẫn thư mục nơi các phần sẽ được tạo.
partFileNamePrefix: Tiền tố sẽ được thêm vào tên tệp của mỗi phần.
token: Một CancellationToken cho phép hủy bỏ thao tác nếu cần.

Đối với các phiên bản .NET dưới 4.5

Các phiên bản trước hỗ trợ cùng SplitInto phương thức nhưng không có token hủy:

SplitInto(long chunkSize, string outputPath)
SplitInto(long chunkSize, string outputPath, string partFileNamePrefix)
Cancel() - Được dùng để ngắt quá trình chia ở giữa.

Mã mẫu cho việc chia có kiểm soát với hủy

Các mẫu mã sau đây minh họa cách chia một kho lưu trữ thành tối đa 5 phần, tự động hủy thao tác sau đó:

.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();

Dưới .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();
};

Chia tách các tệp MBOX lớn một cách bất đồng bộ

Làm việc với các lưu trữ email lớn có thể không hiệu quả và tiêu tốn nhiều bộ nhớ. Để cải thiện hiệu suất và khả năng quản lý, Aspose.Email cho .NET cung cấp khả năng bất đồng bộ SplitIntoAsync phương thức, cho phép bạn chia các tệp lớn thành các phần nhỏ hơn - mà không làm chặn luồng chính. Đoạn mã mẫu dưới đây cho thấy cách sử dụng MboxStorageReader.CreateReaderAsync để mở một tệp MBOX lớn một cách bất đồng bộ và sau đó gọi SplitIntoAsync để chia nó thành các tệp nhỏ hơn, mỗi tệp tối đa 10 MB. Các phần kết quả được lưu vào thư mục đầu ra đã chỉ định với tiền tố "chunk_".

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