**Inheritance:** java.lang.Object, [com.aspose.email.SaveOptions](../../com.aspose.email/saveoptions) ``` public class EmlSaveOptions extends SaveOptions ``` Allows to specify additional options when saving MailMessage to Eml and Emlx format. -------------------- > The following example shows how to load and Save an EML message Preserving the embedded message format. > > [Java] > > ``` > MailMessage mailMessage = MailMessage.load("source.eml"); > // Save as eml with preserved embedded message format > EmlSaveOptions emlSaveOptions = new EmlSaveOptions(MailMessageSaveType.getEmlFormat()) > emlSaveOptions.setPreserveEmbeddedMessageFormat(true); > mailMessage.save("target.eml", emlSaveOptions); > ``` -------------------- ## Constructors | Constructor | Description | | --- | --- | | [EmlSaveOptions(MailMessageSaveType saveType)](#EmlSaveOptions-com.aspose.email.MailMessageSaveType-) | Initializes a new instance of this class that can be used to save a MailMessage in the Eml and Emlx format. | ## Methods | Method | Description | | --- | --- | | [createSaveOptions(MailMessageSaveType saveType)](#createSaveOptions-com.aspose.email.MailMessageSaveType-) | Creates a save options object of a class suitable for the specified save type. | | [equals(Object arg0)](#equals-java.lang.Object-) | | | [getBoundariesTemplate()](#getBoundariesTemplate--) | Gets or sets the boundary template for the message. Default value is null. | | [getCheckBodyContentEncoding()](#getCheckBodyContentEncoding--) | Defines whether need check message body content encoding when saving. | | [getClass()](#getClass--) | | | [getCustomProgressHandler()](#getCustomProgressHandler--) | Represents method that usually supplied by calling side and handles progress events. | | [getDefaultEml()](#getDefaultEml--) | Gets options with default values for saving message to Eml format. | | [getDefaultEmlx()](#getDefaultEmlx--) | Gets options with default values for saving message to Emlx format. | | [getDefaultHtml()](#getDefaultHtml--) | Gets options with default values for saving message to Html format. | | [getDefaultMhtml()](#getDefaultMhtml--) | Gets options with default values for saving message to Mhtml format. | | [getDefaultMsg()](#getDefaultMsg--) | Gets options with default values for saving message to Msg(ASCII) format. | | [getDefaultMsgUnicode()](#getDefaultMsgUnicode--) | Gets options with default values for saving message to Msg(Unicode) format. | | [getDefaultOft()](#getDefaultOft--) | Gets options with default values for saving message to Outlook template (Oft) format. | | [getFileCompatibilityMode()](#getFileCompatibilityMode--) | Defines inner conversions,that are necessarily to be done when saving a message. | | [getMailMessageSaveType()](#getMailMessageSaveType--) | Represents the mail message save type.It can be in eml,msg(ASCII or Unicode),mhtml or html format. | | [getPreserveEmbeddedMessageFormat()](#getPreserveEmbeddedMessageFormat--) | Gets or sets a value indicating whether it is necessary to preserve MSG format of embedded message at converting to MailMessage. | | [getPreserveSignedContent()](#getPreserveSignedContent--) | Gets or sets a value indicating whether it is necessary to save signed message without changes of content to provide correctly structure of digital sign. | | [hashCode()](#hashCode--) | | | [notify()](#notify--) | | | [notifyAll()](#notifyAll--) | | | [setBoundariesTemplate(String value)](#setBoundariesTemplate-java.lang.String-) | Gets or sets the boundary template for the message. Default value is null. | | [setCheckBodyContentEncoding(boolean value)](#setCheckBodyContentEncoding-boolean-) | Defines whether need check message body content encoding when saving. | | [setCustomProgressHandler(ConversionProgressEventHandler value)](#setCustomProgressHandler-com.aspose.email.ConversionProgressEventHandler-) | Represents method that usually supplied by calling side and handles progress events. | | [setFileCompatibilityMode(int value)](#setFileCompatibilityMode-int-) | Defines inner conversions,that are necessarily to be done when saving a message. | | [setMailMessageSaveType(MailMessageSaveType value)](#setMailMessageSaveType-com.aspose.email.MailMessageSaveType-) | Represents the mail message save type.It can be in eml,msg(ASCII or Unicode),mhtml or html format. | | [setPreserveEmbeddedMessageFormat(boolean value)](#setPreserveEmbeddedMessageFormat-boolean-) | Gets or sets a value indicating whether it is necessary to preserve MSG format of embedded message at converting to MailMessage. | | [setPreserveSignedContent(boolean value)](#setPreserveSignedContent-boolean-) | Gets or sets a value indicating whether it is necessary to save signed message without changes of content to provide correctly structure of digital sign. | | [toString()](#toString--) | | | [wait()](#wait--) | | | [wait(long arg0)](#wait-long-) | | | [wait(long arg0, int arg1)](#wait-long-int-) | | ### EmlSaveOptions(MailMessageSaveType saveType) {#EmlSaveOptions-com.aspose.email.MailMessageSaveType-} ``` public EmlSaveOptions(MailMessageSaveType saveType) ``` Initializes a new instance of this class that can be used to save a MailMessage in the Eml and Emlx format. **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | saveType | [MailMessageSaveType](../../com.aspose.email/mailmessagesavetype) | | ### createSaveOptions(MailMessageSaveType saveType) {#createSaveOptions-com.aspose.email.MailMessageSaveType-} ``` public static SaveOptions createSaveOptions(MailMessageSaveType saveType) ``` Creates a save options object of a class suitable for the specified save type. **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | saveType | [MailMessageSaveType](../../com.aspose.email/mailmessagesavetype) | The MailMessageSaveTypesave type (\#getMailMessageSaveType.getMailMessageSaveType/\#setMailMessageSaveType(MailMessageSaveType).setMailMessageSaveType(MailMessageSaveType)) for which to create a save options object. | **Returns:** [SaveOptions](../../com.aspose.email/saveoptions) - An object of a class that derives from [SaveOptions](../../com.aspose.email/saveoptions). ### equals(Object arg0) {#equals-java.lang.Object-} ``` public boolean equals(Object arg0) ``` **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | arg0 | java.lang.Object | | **Returns:** boolean ### getBoundariesTemplate() {#getBoundariesTemplate--} ``` public final String getBoundariesTemplate() ``` Gets or sets the boundary template for the message. Default value is null. The '\{\#\}' wildcard is used for the boundary number placeholder. The '\{guid\}' wildcard is used for the boundary GUID placeholder. example: boundary--\{\#\}-\{guid\} **Returns:** java.lang.String ### getCheckBodyContentEncoding() {#getCheckBodyContentEncoding--} ``` public final boolean getCheckBodyContentEncoding() ``` Defines whether need check message body content encoding when saving. By default the value is false. -------------------- If true, it will be check whether the MailMessage.HtmlBody ([MailMessage.getHtmlBody](../../com.aspose.email/mailmessage\#getHtmlBody)/[MailMessage.setHtmlBody(String)](../../com.aspose.email/mailmessage\#setHtmlBody-String-)) content encoding matches to the encoding specified by the MailMessage.BodyEncoding ([MailMessage.getBodyEncoding](../../com.aspose.email/mailmessage\#getBodyEncoding)/[MailMessage.setBodyEncoding(Encoding)](../../com.aspose.email/mailmessage\#setBodyEncoding-Encoding-)) property. If the HtmlBody content encoding doesn't match BodyEncoding property, the MailMessage.BodyEncoding ([MailMessage.getBodyEncoding](../../com.aspose.email/mailmessage\#getBodyEncoding)/[MailMessage.setBodyEncoding(Encoding)](../../com.aspose.email/mailmessage\#setBodyEncoding-Encoding-)) and MailMessage.PreferredTextEncoding ([MailMessage.getPreferredTextEncoding](../../com.aspose.email/mailmessage\#getPreferredTextEncoding)/[MailMessage.setPreferredTextEncoding(Encoding)](../../com.aspose.email/mailmessage\#setPreferredTextEncoding-Encoding-)) will be changed to default System.Text.Encoding.UTF8 (java.nio.charset.Charset\#getUTF8.getUTF8). **Returns:** boolean ### getClass() {#getClass--} ``` public final native Class getClass() ``` **Returns:** java.lang.Class ### getCustomProgressHandler() {#getCustomProgressHandler--} ``` public final ConversionProgressEventHandler getCustomProgressHandler() ``` Represents method that usually supplied by calling side and handles progress events. **Returns:** [ConversionProgressEventHandler](../../com.aspose.email/conversionprogresseventhandler) ### getDefaultEml() {#getDefaultEml--} ``` public static EmlSaveOptions getDefaultEml() ``` Gets options with default values for saving message to Eml format. **Returns:** [EmlSaveOptions](../../com.aspose.email/emlsaveoptions) ### getDefaultEmlx() {#getDefaultEmlx--} ``` public static EmlSaveOptions getDefaultEmlx() ``` Gets options with default values for saving message to Emlx format. **Returns:** [EmlSaveOptions](../../com.aspose.email/emlsaveoptions) ### getDefaultHtml() {#getDefaultHtml--} ``` public static HtmlSaveOptions getDefaultHtml() ``` Gets options with default values for saving message to Html format. **Returns:** [HtmlSaveOptions](../../com.aspose.email/htmlsaveoptions) ### getDefaultMhtml() {#getDefaultMhtml--} ``` public static MhtSaveOptions getDefaultMhtml() ``` Gets options with default values for saving message to Mhtml format. **Returns:** [MhtSaveOptions](../../com.aspose.email/mhtsaveoptions) ### getDefaultMsg() {#getDefaultMsg--} ``` public static MsgSaveOptions getDefaultMsg() ``` Gets options with default values for saving message to Msg(ASCII) format. **Returns:** [MsgSaveOptions](../../com.aspose.email/msgsaveoptions) ### getDefaultMsgUnicode() {#getDefaultMsgUnicode--} ``` public static MsgSaveOptions getDefaultMsgUnicode() ``` Gets options with default values for saving message to Msg(Unicode) format. **Returns:** [MsgSaveOptions](../../com.aspose.email/msgsaveoptions) ### getDefaultOft() {#getDefaultOft--} ``` public static MsgSaveOptions getDefaultOft() ``` Gets options with default values for saving message to Outlook template (Oft) format. **Returns:** [MsgSaveOptions](../../com.aspose.email/msgsaveoptions) ### getFileCompatibilityMode() {#getFileCompatibilityMode--} ``` public final int getFileCompatibilityMode() ``` Defines inner conversions,that are necessarily to be done when saving a message. The default value is FileCompatibilityMode.None. **Returns:** int ### getMailMessageSaveType() {#getMailMessageSaveType--} ``` public final MailMessageSaveType getMailMessageSaveType() ``` Represents the mail message save type.It can be in eml,msg(ASCII or Unicode),mhtml or html format. The default value is Eml. **Returns:** [MailMessageSaveType](../../com.aspose.email/mailmessagesavetype) ### getPreserveEmbeddedMessageFormat() {#getPreserveEmbeddedMessageFormat--} ``` public final boolean getPreserveEmbeddedMessageFormat() ``` Gets or sets a value indicating whether it is necessary to preserve MSG format of embedded message at converting to MailMessage. By default the value is false. -------------------- Generally, embedded messages have the same format (EML or MSG) as the underlying message. By default, when converting from MSG to EML and vice versa, embedded messages are also converted to the target format. Setting the property to true preserves the original format of embedded messages. **Returns:** boolean ### getPreserveSignedContent() {#getPreserveSignedContent--} ``` public final boolean getPreserveSignedContent() ``` Gets or sets a value indicating whether it is necessary to save signed message without changes of content to provide correctly structure of digital sign. By default the value is false. -------------------- The property is only meaningful for signed messages; it has no effect on unsigned messages. This property is intended for some complex signed messages with detached signature generated by other clients, whose implementation differences prevent Aspose.Email from exactly replicating their MIME content generation. Saving such messages without using PreserveSignedContent will cause the signature in the saved messages to fail. Some simple messages and messages with an attached signature can be saved correctly without using this property. **Returns:** boolean ### hashCode() {#hashCode--} ``` public native int hashCode() ``` **Returns:** int ### notify() {#notify--} ``` public final native void notify() ``` ### notifyAll() {#notifyAll--} ``` public final native void notifyAll() ``` ### setBoundariesTemplate(String value) {#setBoundariesTemplate-java.lang.String-} ``` public final void setBoundariesTemplate(String value) ``` Gets or sets the boundary template for the message. Default value is null. The '\{\#\}' wildcard is used for the boundary number placeholder. The '\{guid\}' wildcard is used for the boundary GUID placeholder. example: boundary--\{\#\}-\{guid\} **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | value | java.lang.String | | ### setCheckBodyContentEncoding(boolean value) {#setCheckBodyContentEncoding-boolean-} ``` public final void setCheckBodyContentEncoding(boolean value) ``` Defines whether need check message body content encoding when saving. By default the value is false. -------------------- If true, it will be check whether the MailMessage.HtmlBody ([MailMessage.getHtmlBody](../../com.aspose.email/mailmessage\#getHtmlBody)/[MailMessage.setHtmlBody(String)](../../com.aspose.email/mailmessage\#setHtmlBody-String-)) content encoding matches to the encoding specified by the MailMessage.BodyEncoding ([MailMessage.getBodyEncoding](../../com.aspose.email/mailmessage\#getBodyEncoding)/[MailMessage.setBodyEncoding(Encoding)](../../com.aspose.email/mailmessage\#setBodyEncoding-Encoding-)) property. If the HtmlBody content encoding doesn't match BodyEncoding property, the MailMessage.BodyEncoding ([MailMessage.getBodyEncoding](../../com.aspose.email/mailmessage\#getBodyEncoding)/[MailMessage.setBodyEncoding(Encoding)](../../com.aspose.email/mailmessage\#setBodyEncoding-Encoding-)) and MailMessage.PreferredTextEncoding ([MailMessage.getPreferredTextEncoding](../../com.aspose.email/mailmessage\#getPreferredTextEncoding)/[MailMessage.setPreferredTextEncoding(Encoding)](../../com.aspose.email/mailmessage\#setPreferredTextEncoding-Encoding-)) will be changed to default System.Text.Encoding.UTF8 (java.nio.charset.Charset\#getUTF8.getUTF8). **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | value | boolean | | ### setCustomProgressHandler(ConversionProgressEventHandler value) {#setCustomProgressHandler-com.aspose.email.ConversionProgressEventHandler-} ``` public final void setCustomProgressHandler(ConversionProgressEventHandler value) ``` Represents method that usually supplied by calling side and handles progress events. **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | value | [ConversionProgressEventHandler](../../com.aspose.email/conversionprogresseventhandler) | | ### setFileCompatibilityMode(int value) {#setFileCompatibilityMode-int-} ``` public final void setFileCompatibilityMode(int value) ``` Defines inner conversions,that are necessarily to be done when saving a message. The default value is FileCompatibilityMode.None. **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | value | int | | ### setMailMessageSaveType(MailMessageSaveType value) {#setMailMessageSaveType-com.aspose.email.MailMessageSaveType-} ``` public final void setMailMessageSaveType(MailMessageSaveType value) ``` Represents the mail message save type.It can be in eml,msg(ASCII or Unicode),mhtml or html format. The default value is Eml. **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | value | [MailMessageSaveType](../../com.aspose.email/mailmessagesavetype) | | ### setPreserveEmbeddedMessageFormat(boolean value) {#setPreserveEmbeddedMessageFormat-boolean-} ``` public final void setPreserveEmbeddedMessageFormat(boolean value) ``` Gets or sets a value indicating whether it is necessary to preserve MSG format of embedded message at converting to MailMessage. By default the value is false. -------------------- Generally, embedded messages have the same format (EML or MSG) as the underlying message. By default, when converting from MSG to EML and vice versa, embedded messages are also converted to the target format. Setting the property to true preserves the original format of embedded messages. **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | value | boolean | | ### setPreserveSignedContent(boolean value) {#setPreserveSignedContent-boolean-} ``` public final void setPreserveSignedContent(boolean value) ``` Gets or sets a value indicating whether it is necessary to save signed message without changes of content to provide correctly structure of digital sign. By default the value is false. -------------------- The property is only meaningful for signed messages; it has no effect on unsigned messages. This property is intended for some complex signed messages with detached signature generated by other clients, whose implementation differences prevent Aspose.Email from exactly replicating their MIME content generation. Saving such messages without using PreserveSignedContent will cause the signature in the saved messages to fail. Some simple messages and messages with an attached signature can be saved correctly without using this property. **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | value | boolean | | ### toString() {#toString--} ``` public String toString() ``` **Returns:** java.lang.String ### wait() {#wait--} ``` public final void wait() ``` ### wait(long arg0) {#wait-long-} ``` public final native void wait(long arg0) ``` **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | arg0 | long | | ### wait(long arg0, int arg1) {#wait-long-int-} ``` public final void wait(long arg0, int arg1) ``` **Parameters:** | Parameter | Type | Description | | --- | --- | --- | | arg0 | long | | | arg1 | int | |