Aspose.Email for .NET 22.11 Release Notes

This page contains release notes information for Aspose.Email for .NET 22.11

All Changes

Key	Summary	Category
EMAILNET-40856	Add DecodeSignedContent method to MapiMessage	Feature
EMAILNET-40783	Provide API to check subfolder is from StandardIpmFolder	Feature
EMAILNET-40808	Add features for TNEF	Feature
EMAILNET-40814	Working with StickyNote, DistList and IPM.Document	Enhancement
EMAILNET-40839	Issues while reading distribution List	Bug
EMAILNET-40826	Storage.ItemMoved event does not work	Bug
EMAILNET-40825	InvalidOperationException is thrown while merging PST	Bug
EMAILNET-40828	Unable to access read only storage file	Bug
EMAILNET-40793	Headers From/To are lost after MSG to EML conversion	Bug
EMAILNET-40854	Image attachments are not rendered in the attachments list after MSG to PDF conversion	Bug
EMAILNET-40840	Aspose.Email.AsposeArgumentOutOfRangeException is thrown while loading VCS	Bug
EMAILNET-40813	MSG to MHTML: Images not converted	Bug
EMAILNET-40833	Email address with quotes	Bug

New Features

Getting a MAPI item type

We have added the MapiItemType enum that represented an item type. It can be used for message conversion into an object of a corresponding class derived from the IMapiMessageItem interface. This avoids users from checking the MessageClass property value before message conversion.

Usage:

foreach (var messageInfo in folder.EnumerateMessages())
{
    var msg = pst.ExtractMessage(messageInfo);

    switch (msg.SupportedType)
    {
        // Non-supported type. MapiMessage cannot be converted to an appropriate item type.
        // Just use in MSG format.
        case MapiItemType.None:
            break;
        // An email message. Conversion isn't required.
        case MapiItemType.Message:
            break;
        // A contact item. Can be converted to MapiContact.
        case MapiItemType.Contact:
            var contact = (MapiContact)msg.ToMapiMessageItem();
            break;
        // A calendar item. Can be converted to MapiCalendar.
        case MapiItemType.Calendar:
            var calendar = (MapiCalendar)msg.ToMapiMessageItem();
            break;
        // A distribution list. Can be converted to MapiDistributionList.
        case MapiItemType.DistList:
            var dl = (MapiDistributionList)msg.ToMapiMessageItem();
            break;
        // A Journal entry. Can be converted to MapiJournal.
        case MapiItemType.Journal:
            var journal = (MapiJournal)msg.ToMapiMessageItem();
            break;
        // A StickyNote. Can be converted to MapiNote.
        case MapiItemType.Note:
            var note = (MapiNote)msg.ToMapiMessageItem();
            break;
        // A Task item. Can be converted to MapiTask.
        case MapiItemType.Task:
            var task = (MapiTask)msg.ToMapiMessageItem();
            break;
    }
}

Removing a Signature from a MapiMessage

For better compatibility, the MapiMessage.RemoveSignature method and MapiMessage.IsSigned property were added.

Code example:

var msg = MapiMessage.Load(fileName);

if (msg.IsSigned)
{
    var unsignedMsg = msg.RemoveSignature();
}

Checking whether the folder is in a predefined folder

Added FolderInfo.GetPredefinedType(bool getForTopLevelParent) method, to check folder is from StandardIpmFolder.

If getForTopLevelParent param is true, method returns a StandardIpmFolder enum value for the top-level parent folder. This determines whether the current folder is a subfolder of a predefined folder. If getForTopLevelParent param is false, it returns a StandardIpmFolder enum value for the current folder.

string fileName = "my.pst");

using (var pst = PersonalStorage.FromFile(fileName))
{
    CheckFolders(pst.RootFolder.GetSubFolders());
}

private void CheckFolders(FolderInfoCollection folders)
{
    foreach (var folder in folders)
    {
        Console.WriteLine($"Display Name: {folder.DisplayName}");

        // Determines whether the current folder is a predefined folder
        var folderType = folder.GetPredefinedType(false);
        var answer = folderType == StandardIpmFolder.Unspecified ? "No" : $"Yes, {folderType}"; 
        Console.WriteLine($"Is StandardIpmFolder?: {answer}");

        // Determines whether the current folder is a subfolder of a predefined folder
        if (folderType == StandardIpmFolder.Unspecified)
        {
            folderType = folder.GetPredefinedType(true);
            answer = folderType == StandardIpmFolder.Unspecified ? "No" : $"Yes, {folderType}";
            Console.WriteLine($"Is subfolder from StandardIpmFolder parent?: {answer}");
        }

        Console.WriteLine();

        CheckFolders(folder.GetSubFolders());
    }
}

Checking whether attachment is a TNEF formatted message

The Attachment.IsTnef property indicates whether the message attachment is TNEF formatted message.

Usage:

var eml = MailMessage.Load(fileName);

foreach (attachment in eml.Attachments)
{
    Console.WriteLine($"Is Attachment TNEF?: {attachment.IsTnef}");
}