Documentation – איך לקרוא ולהמיר קבצי MBOX של Thunderbird ב‑.NET

Net: קריאת קבצי MBOX עם Aspose.Email ב‑C#

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

יכולות קריאת Aspose.Email

Mozilla Thunderbird הוא לקוח דוא"ל בקוד פתוח, חוצה פלטפורמות, שפותח על ידי קרן Mozilla. הוא מאחסן אימיילים במבנה קבצים משלו, מנהל אינדקסי הודעות ותתי תיקיות באמצעות פורמטים קבצים קניינים. Thunderbird יוצר קובץ .mbox אחד לכל תיקיית דוא"ל (למשל, Inbox, Sent, Trash), ושומר קבצים אלו בספריית הפרופיל של המשתמש. כל קובץ מכיל את כל ההודעות מאותה תיקייה בצורה משולבת.

Aspose.Email for .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 for .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

ה 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 תאריך - מקבל את תאריך ההודעה
MailAddress מאת - מקבל את כתובת השולח
string נושא - מקבל את נושא ההודעה
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 class מספקת את 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() - משמש להפרעה לתהליך הפיצול באמצע.

דוגמאות קוד לפיצול מבוקר עם ביטול

דוגמאות הקוד שלהלן מדגימות כיצד לפצל ארכיון עד ל-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 מספקת את ה‑asynchronous 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);
}