Utility Features - MailMessage

Encrypting and Decrypting Messages

Aspose.Email provides facility to Encrypt and decrypt Email messages. This topic shows how an existing or new message can be loaded and encrypted using MailMessage. The encrypt() and decrypt() methods return the MailMessage object for the applied effects and needs to be taken care of while encrypting/decrypting messages. Encrypting and decrypting messages involves the following steps:

  1. Create a new message or load an existing one
  2. Encrypt the message using the certificate file
  3. Send the message or save it
  4. Decrypt the message as required

The following code snippet shows you how to encrypt and decrypt messages.

Checking a Message for Encryption

Aspose.Email MailMessage class allows checking a message if it is encrypted or not. The isEncrypted property of MailMessage allows checking this as shown in the following code sample.

Configure Locale Options for Aspose.Email

You can use LocaleOptions class in case of unrecognised default locale and set most appropriate locale for Aspose Email lib. It offers the following methods to perform the task:

The following code sample demonstrates how to load a mail message from a file using the specified locale settings:

final Locale locale = new Locale("en", "DE");

// set Locale for Aspose Email lib
// or
//LocaleOptions.setLocale(new Locale("en", "US"));


This code ensures that the application and the Aspose.Email library use the specified locales for handling language, country, and cultural conventions.

MailMessages Containing TNEF attachments

Transport Neutral Encapsulation Format (TNEF) is a proprietary email attachment format used by Microsoft Outlook and Microsoft Exchange Server. The Aspose.Email API allows you to read email messages that have TNEF attachments and modify the contents of them. The email can then be saved as a normal email or to the same format, preserving TNEF attachments. This article shows different code samples for working with messages containing TNEF attachments.

Reading a Message by Preserving TNEF Attachments

The following code snippet shows you how to read a message by preserving TNEF attachments.

Updating Resources in a TNEF Attachment and Preserving TNEF Format

The following code snippet shows you how to update resources in a TNEF attachment and preserve the TNEF format.

Adding New Attachments to Main Message Containing TNEF

Creating TNEF EML from MSG

Outlook MSGs sometimes contain information such as tables and text styles that may get disturbed if these are converted to EML. Creating TNEF messages from such MSG files allows us to retain the formatting and even send such messages via the email clients retaining the formatting. 

To create the TNEF, the following sample code can be used.

Detect if a Message is TNEF

Processing Bounced Messages

It is very common that a message sent to a recipient may bounce for any reason such as an invalid recipient address. Aspose.Email API has the capability to process such a message for checking if it is a bounced email or a regular email message. The CheckBounced method of the MailMessage class returns a valid result if the email message is a bounced email.

This article shows the usage of BounceResult class that provides the capability of checking if a message is a bounced email. It further gives detailed information about the recipients, action taken and the reason for the notification.

Ignore exceptions

The library offers an ExceptionManager class to implement ignore exceptions ability into your application functionality. The code snippet below demonstrates how to set a callback to handle exceptions:

 ExceptionManager.setIgnoreExceptionsHandler( new IgnoreExceptionsCallback() {

   //exception path: {Module}\{Method}\{Action}\{GUID}

   //example: MailMessage\Load\DecodeTnefAttachment\64149867-679e-4645-9af0-d46566cae598

   public boolean invoke(AsposeException ex, String path) {

       //Ignore all exceptions on MailMessage.Load

       return path.equals("MailMessage\\Load");



Or use an alternative:


Also, you can set a callback for ignored exceptions log:

ExceptionManager.setIgnoreExceptionsLogHandler( new IgnoreExceptionsLogCallback() {

   public void invoke(String message) {

        System.out.println("=== EXCEPTION IGNORED === " + message);



The user will be notified, that the exception can be ignored by an error message. For example:

Exception in message:

AsposeArgumentException: properties should not be empty.

If you want to ignore an exception and want to proceed further then you can use:


Invalid TNEF Attachment will be interpreted as regular attachment.

Bayesian Spam Analyzer

Aspose.Email provides the facility of e-mail filtering using the Bayes spam analyzer. It provides the SpamAnalyzer class for this purpose. This article shows how to train the filter to distinguish between the spam and regular emails based on the words database.

Obtaining Preamble and Epilogue from EML Messages

In the MIME format, the preamble is the text that appears after the headers and before the first multipart boundary. The epilogue is the text that appears after the last boundary and before the end of the message. This text is usually not visible to users in mail readers, but some MIME implementations may use it to insert notes for recipients who read the message using non-MIME-compliant programs.

The following code snippet shows how to obtain preamble and epilogue from an EML message which can be achieved with the corresponding methods of the MailMessage class:

// Gets or sets a preamble text.
public String getPreamble, setPreamble

// Gets or sets an epilogue text.
public String getEpilogue, setEpilogue