Aspose.Email for .NET 23.10 Release Notes

All Changes

New Features

Split Mbox Storage into Smaller Parts

With this new feature, you have more control over Mbox storage processing, allowing you to split large files into manageable parts and implement custom actions during the process.

Below are the key additions to the API:

• MboxStorageReader.SplitInto(long chunkSize, string outputPath) This method allows you to split Mbox storage into smaller parts, making it easier to manage and process large Mbox files.

• MboxStorageReader.SplitInto(long chunkSize, string outputPath, string partFileNamePrefix) A variation of the previous method, this one also lets you specify a custom prefix for the split Mbox file names.

• MboxStorageReader.EmlCopying Event This event occurs before an email is copying to a new Mbox file. You can customize actions before emails are processed.

• MboxStorageReader.EmlCopied Event This event occurs after an email is copied to a new Mbox file. You can perform post-processing actions on emails.

• MboxStorageReader.MboxFileCreated Event This event occurs when a new Mbox file is created. You can handle this event to react to file creation.

• MboxStorageReader.MboxFileFilled Event This event occurs when a new Mbox file is filled with emails. You can respond to the file being populated with emails.

• NewStorageEventHandler(object sender, NewStorageEventArgs e) Represents a delegate for handling events that occur after a new storage file is created or processed.

• MimeItemCopyEventHandler(object sender, MimeItemCopyEventArgs e) Represents a delegate for handling events related to the copying of Mime items, typically used in scenarios where a MailMessage object is copied from one storage to another.

• NewStorageEventArgs Represents arguments used in events that are raised after a new storage file is created or after it is processed.

• MimeItemCopyEventArgs Represents event arguments related to a copying of a MailMessage object from one storage to another, either before the copy begins or after it is complete.

Code sample:

messageCount = 0;
partCount = 0;      

// Create an instance of MboxrdStorageReader
var mbox = new MboxrdStorageReader("my.mbox", new MboxLoadOptions { LeaveOpen = false });

// Subscribe to events
mbox.MboxFileCreated += (sender, e) =>
{
    Console.WriteLine($"New Mbox file created: {e.FileName}");
    partCount++;
};

mbox.MboxFileFilled += (sender, e) =>
{
    Console.WriteLine($"Mbox file filled with messages: {e.FileName}");
};

mbox.EmlCopied += (sender, e) =>
{
    Console.WriteLine($"Message added to new Mbox file. Subject: {e.Item.Subject}");
    messageCount++;
};

// Split the Mbox storage into smaller parts
mbox.SplitInto(10000000, fixtureHelper.GetTestOutPath(), "Prefix");

// Output the final messageCount and partCount
Console.WriteLine($"Total messages added: {messageCount}");
Console.WriteLine($"Total parts created: {partCount}");

Get AlternateView Content by MediaType

With this enhancement, you can now retrieve the content as a string from a specific AlternateView within an email message. The method MailMessage.GetAlternateViewContent(string mediaType) allows you to access the content from an AlternateView that matches the specified media type.

• If an AlternateView with the specified media type exists, the method returns the content as a string.
• If there is no AlternateView with the specified media type, the method returns null.

Code sample:

// Load an email message from a file
var msg = MailMessage.Load(fileName);

// Get the content from an AlternateView with media type "text/plain"
var textBody = msg.GetAlternateViewContent("text/plain");

// Handle the content or null value as needed
if (textBody != null)
{
    // Process the textBody
}
else
{
    // Handle the scenario where no "text/plain" AlternateView is found
}