Aspose.Email for .NET 22.11 Release Notes

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.


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:
        // An email message. Conversion isn't required.
        case MapiItemType.Message:
        // A contact item. Can be converted to MapiContact.
        case MapiItemType.Contact:
            var contact = (MapiContact)msg.ToMapiMessageItem();
        // A calendar item. Can be converted to MapiCalendar.
        case MapiItemType.Calendar:
            var calendar = (MapiCalendar)msg.ToMapiMessageItem();
        // A distribution list. Can be converted to MapiDistributionList.
        case MapiItemType.DistList:
            var dl = (MapiDistributionList)msg.ToMapiMessageItem();
        // A Journal entry. Can be converted to MapiJournal.
        case MapiItemType.Journal:
            var journal = (MapiJournal)msg.ToMapiMessageItem();
        // A StickyNote. Can be converted to MapiNote.
        case MapiItemType.Note:
            var note = (MapiNote)msg.ToMapiMessageItem();
        // A Task item. Can be converted to MapiTask.
        case MapiItemType.Task:
            var task = (MapiTask)msg.ToMapiMessageItem();

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

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



Checking whether attachment is a TNEF formatted message

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


var eml = MailMessage.Load(fileName);

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