What's New in Aspose.Email for .NET

Aspose.Email for .NET 24.3

• Support for Contacts and Calendar in MS Graph - IGraphClient interface methods allow you to access, manage, and interact with users’ contacts and calendar events:
  • Retrieve a collection of MAPI contacts.
  • Retrieve a specific contact.
  • Create a new contact.
  • Update an existing contact.
  • Retrieve a collection of calendar information.
  • Retrieve a collection of calendar items.
  • Retrieve a specific calendar item.
  • Create a new calendar item.
  • Updates an existing calendar item.

Aspose.Email for .NET 24.2

• Manipulate Outlook Item Categories - Aspose.Email makes it possible to retrieve and utilize category colors associated with Outlook item categories stored in OLM files.

• Container Class Matching - a new EnforceContainerClassMatching property was added to the FolderCreationOptions class which, when adding a folder to a PST file, allows you to ensure that the class of the folder matches the expected type or category of folders within the PST file.

Aspose.Email for .NET 23.12

• Setting Relative Path to Resources when Saving Email Message as HTML - Aspose.Email introduces the ability to save email resources with relative paths when exporting messages to HTML format, offering enhanced flexibility for resource linking. Users can choose between absolute and relative paths, and define custom paths using the ResourceHtmlRendering event, streamlining the sharing and display of emails across different systems.

Aspose.Email for .NET 23.11

• Validate Email Messages - A set of components was added to enable users validate message files, supporting formats such as eml, emlx, mht, msg, and oft. By utilizing this functionality, users can validate messages and retrieve insights into the validation process, including format type and encountered errors.

• Attach Digital Signatures to Email Messages - The AttachSignature method in the SecureEmailManager class was designed to easily add a digital signature to an email.

Once the signature is attached, users can verify the results through properties like ‘IsSigned’, ‘MessageClass’, and attachment details.

To customize the signature attachment process, users can utilize the SignatureOptions class.

Aspose.Email for .NET 23.10

• Split Mbox Storage into Smaller Parts - split large files into manageable parts and implement custom actions during the process:

  • Specify a custom prefix for the split Mbox file names.
  • Customize actions before and after an email is copied to a new Mbox file.
  • React when a new Mbox file is created.
  • Respond when a new Mbox file is filled with emails.

• Get AlternateView Content by MediaType - retrieve the content as a string from a specific AlternateView within an email message. The MailMessage.GetAlternateViewContent(string mediaType) method allows you to access the content from an AlternateView that matches the specified media type.

Aspose.Email for .NET 23.8

• Send Emails via Graph Client - added the support for overloaded methods to the GraphClient class that accept a MailMessage object for sending emails:

  • CreateMessage(string folderId, MailMessage message)

  • void Send(MailMessage message)

• Save Mapi Distribution List to a Single Multi Contact VCF File - Save the Mapi Distribution List to a specified file name using the provided save options. You can provide the file name and an instance of the MapiDistributionListSaveOptions class as parameters.

  • void Save(string fileName, MapiDistributionListSaveOptions options) method has been added for this purpose.

Aspose.Email for .NET 23.7

• Delete Items from PST - We have added a new method, DeleteItem(string entryId), to the PersonalStorage class. This method provides a way to delete items (folders or messages) from a Personal Storage Table (PST) using the unique entryId associated with the item.
• Event Handling and PST Splitting - Improved Functionality in PersonalStorage class:

  • StorageProcessingEventHandler event occurs before the storage is processed, specifically before processing the current storage in MergeWith or SplitInto methods. This event provides an opportunity to execute custom logic or handle certain operations before the storage processing occurs.

  • StorageProcessingEventArgs class provides data for the PersonalStorage.StorageProcessing event.

  • SplitInto(long chunkSize, string partFileNamePrefix, string path) overload method allows the splitting of the PST storage into smaller-sized parts.

• Calendar Handling - New properties and a method were added to the CalendarReader class:
  • Count property allows you to retrieve the number of Vevent components (events) present in the calendar, making it easier to track the total number of events.
  • IsMultiEvents property determines whether the calendar contains multiple events.
  • Method property obtains the iCalendar method type associated with the calendar object. It returns the method type, such as “REQUEST,” “PUBLISH,” or “CANCEL,” providing valuable insights into the purpose of the calendar.
  • Version gets the Version of iCalendar.
  • LoadAsMultiple() method enables the loading of a list of events from a calendar containing multiple events. It returns a list of Appointment objects, allowing easy access and processing of each event individually.

Aspose.Email for .NET 23.6

• Preserve or Remove Signature in MBOX to PST Conversion - set the MboxToPstConversionOptions.RemoveSignature property to ‘true’ to remove the signature.

• Remove Signature when Loading EML Files - set the LoadOptions.RemoveSignature property to ‘true’ to remove the signature.

• Email Signature Check

  • Added a new SecureEmailManager class for checking the signature of secure emails. You can now check the signature of MapiMessage and MailMessage objects.
  • Added a new SmimeResult class to store the results of checking secure emails.

  Introduced methods of the SecureEmailManager:

  • CheckSignature(MapiMessage msg)
  • CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt)
  • CheckSignature(MapiMessage msg, X509Certificate2 certificateForDecrypt, X509Store store)
  • CheckSignature(MailMessage msg)
  • CheckSignature(MailMessage msg, X509Certificate2 certificateForDecrypt)
  • CheckSignature(MailMessage msg, X509Certificate2 certificateForDecrypt, X509Store store)

Aspose.Email for .NET 23.5

• Determine the Version of ICS/VCS Files - Use the Version property of the Appointment class to retrieve the version of ICS/VCS files.
• Customize Saving Options for VCard Files - We added the new VCardSaveOptions class to our API with the following properties:
  • VCardVersion enables users to specify the desired vCard version when saving contact items. By default, the class is set to use vCard version 2.1 (VCardVersion.V21).
  • UseExtensions - allows users to control whether extended fields can be used when saving vCard files. When set to true (default), extensions are permitted, providing compatibility with custom fields and additional contact information.
  • PreferredTextEncoding - the encoding to be used when saving vCard contact items.
• Get Total Number of Message Items Contained in the Zimbra Storage with the GetTotalItemsCount() method of the TgzReader class.
• Retrieve a PST subfolder by path - Retrieve a subfolder with the specified name from the current PST folder using the FolderInfo.GetSubFolder(string name, bool ignoreCase, bool handlePathSeparator) method overload.

Aspose.Email for .NET 23.4

• Add a Reference Attachment to a Message - We have added a new Add method to the MapiAttachmentCollection class with the following parameters:
  • name - the name of attachment
  • sharedLink - a fully qualified shared link to the attachment provided by web service manipulating the attachment
  • url - a file location
  • providerName - a name of reference attachment provider
• Multiple VCard Contacts Check - Check whether a source file contains multi contacts with the new VCardContact.IsMultiContacts(string filePath) method.
• Convert Calendar ICS Format to Message Formats - Convert appointments to message objects such as MapiMessage and MailMessage.
• Additional Options for Saving Messages in HTML and MHTML Formats:
  • MapiTask.Priority - Gets or sets the current Priority of the Task object.
  • MhtSaveOptions.SaveAllHeaders - Defines whether there is a need to save all headers in output mhtml or not.
  • HtmlFormatOptions.RenderTaskFields - Indicates that the specific Task fields should be written in output html.
• Set Timeout to Message Conversion and Loading Process - Limit the time in milliseconds while converting and loading messages, ensuring that the process does not take longer than necessary. For this purpose, the following features have been introduced:
  • MailConversionOptions.Timeout - Limits the time in milliseconds while converting a message.
  • MailConversionOptions.TimeoutReached - Raised if the time is out while converting to MailMessage.
  • MsgLoadOptions.Timeout - Limits the time in milliseconds while converting a message.
  • MsgLoadOptions.TimeoutReached - Raised if the time is out while converting to MailMessage.

Aspose.Email for .NET 23.3

• Get the Total Number of Message Items Contained in the OLM Storage with the GetTotalItemsCount() method to OlmStorage class.
• Determine if MapiMessage is OFT or MSG - Determine whether the MapiMessage was loaded from an OFT or MSG file with the new MapiMessage.IsTemplate property.
• Detect a NSF File Format

Aspose.Email for .NET 23.1

-Retrieve message properties from MboxMessageInfo - Get access to the information about individual messages stored in an mbox file, such as message size, message index, message headers, message flags, and other message-related metadata. We have added the following properties to MboxMessageInfo class:

DateTime Date - Gets the date of message MailAddress From - Gets the from address string Subject - Gets the message subject MailAddressCollection To - Gets the address collection that contains the recipients of message MailAddressCollection CC - Gets the address collection that contains CC recipients MailAddressCollection Bcc - Gets the address collection that contains BCC recipients of message

Aspose.Email for .NET 22.12

• Get the total number of message items contained in the PST - We have added the GetTotalItemsCount() method to PersonalStorage.Store property.
• Get a Standard RSS Feeds Folder in Personal Storage, Add a Standard RSS Feeds Folder in PST - A new RssFeeds value has been added to StandardIpmFolder enum. Now the RSS Feeds Folder can be easily retrieved or added to the storage.
• Decrypt an Email Message Stored in the MAPI Format - We have added a Decrypt method to the MapiMessage class:
  • MapiMessage.IsEncrypted - Gets a value indicating whether the message is encrypted.
  • MapiMessage.Decrypt() - Decrypts this message (method searches the current user and computer My stores for the appropriate certificate and private key).
  • MapiMessage.Decrypt(X509Certificate2 certificate) - Decrypts this message with certificate.
• Setting a Product ID when Saving MapiCalendar to ICS - We have added ProductIdentifier property to MapiCalendarIcsSaveOptions class.
• Extract Messages by Identifiers from OLM and MBOX - This is the efficient way to avoid traversing through the entire storage each time to find a specific message to extract.
• Determine whether the Attachment is Inline or Regular with the MapiAttachment.IsInline property.

Aspose.Email for .NET 22.11

• Get a MAPI Item Type - Avoid checking the MessageClass property value every time before message conversion.
• Remove Signature from MapiMessage - For better compatibility, the MapiMessage.RemoveSignature method and MapiMessage.IsSigned property were added.
• Identifying Predefined Folders - The new FolderInfo method, GetPredefinedType, has been introduced to determine if a folder is within a predefined folder by returning the StandardIpmFolder enum value based on the specified parameter value.
• Verifying Attachment TNEF Format - The Attachment.IsTnef property indicates whether the message attachment is TNEF formatted message.

Aspose.Email for .NET 22.10

• Renaming an Attachment in MapiMessage - Now it is possible to edit the DisplayName property value in MapiMessage attachments.

Aspose.Email for .NET 22.9

• List Messages with Graph API - The new OrderBy method allows you to control the ordering of the retrieved messages based on the criteria you specify.

Aspose.Email for .NET 22.8

• Reading Messages from MBOX - We have introduced new features for configuring loading options:
  • MailStorageConverter.MboxMessageOptions property - Gets or sets email load options when parsing an Mbox storage.
  • MboxrdStorageReader.ReadNextMessage(EmlLoadOptions options) method. EmlLoadOptions parameter specifies options when reading message from Mbox storage.

Aspose.Email for .NET 22.7

• Get Message Identification Info such as UID or sequence number using the following features:
  • MailboxInfo class - Represents identification information about a message in a mailbox.
  • SequenceNumber property - The sequence number of a message.
  • UniqueId property - The unique id of a message.
  • MailMessage.ItemId property - Represents identification information about a message in a mailbox.

Aspose.Email for .NET 22.6

• Preserving Original Timestamp in ICS Files - Extract calendar items from PST files and save them in ICS format with the original timestamp using the following options:
  • MapiCalendarIcsSaveOptions - Allows specifying additional options when saving MapiCalendar to ICS format.
  • MapiCalendarIcsSaveOptions.KeepOriginalDateTimeStamp - Allows keeing the original DateTimeStamp value in the output file.

Aspose.Email for .NET 22.5

• Enumerate Messages with Paging Support via Graph Client - The API provides the paging and filtering support for listing messages. This is very helpful where the mailbox has a large number of messages and requires a lot of time for retrieving the summary information about these.
• Asynchronous Mode in Handling Mail Clients - A new approach to the task includes the following API members:
  • IAsyncSmtpClient - Allows applications to send messages by using the Simple Mail Transfer Protocol (SMTP).
  • SmtpClient.CreateAsync - Creates a new instance of the Aspose.Email.Clients.Smtp.SmtpClient class.
  • IAsyncSmtpClient.SendAsync(Aspose.Email.Clients.Smtp.Models.SmtpSend) method parameter set.
  • IAsyncSmtpClient.ForwardAsync(Aspose.Email.Clients.Smtp.Models.SmtpForward) arguments.
  • IAsyncImapClient - Allows applications to access and manipulate messages by using the Internet Message Access Protocol (IMAP).
  • ImapClient.CreateAsync - Creates a new instance of the Aspose.Email.Clients.Imap.ImapClient class.

Aspose.Email for .NET 22.4

• Send Email with MailGun and SendGrid Delivery Services - We have created a unified API which you can use to initialize options depending on which service is going to be used for sending messages, call the required client instance using the builder, prepare and send an email message. There is also an asynchronous version of the Send method.
• Set the X-ALT-DESC header in ICS file - We introduced a new HtmlDescription property to set the X-ALT-DESC header.

Aspose.Email for .NET 22.3

• List Message Attachments using IMAP Client - Get information about attachments such as name, size without fetching the attachment data. API members involved in the operation:
  • Aspose.Email.Clients.Imap.ImapAttachmentInfo - Represents an attachment information.
  • Aspose.Email.Clients.Imap.ImapAttachmentInfoCollection - Represents a collection of ImapAttachmentInfo.
  • Aspose.Email.Clients.Imap.ListAttachments(int sequenceNumber) - Gets an information for each attachment in message.
• Fetch Items with Attachments via EWS Client - We added the FetchItems(EwsFetchItems options) method to EwsClient. It accepts an instance of EwsFetchItems class as a parameter to control the behavior of the method.

Aspose.Email for .NET 22.2

• Adding Reference Attachments Introduced API members:
  • Aspose.Email.ReferenceAttachment - represents a reference attachment.
  • Aspose.Email.AttachmentPermissionType - The permission type data associated with a web reference attachment.
  • Aspose.Email.AttachmentProviderType - The type of web service manipulating the attachment.
• Retrieve message class - We have added MessageClass property to ExchangeMessageInfo class to retrieve the class of each message in the collection from a public folder, after establishing a connection to an EWS client.