Load Email document with options Leave feedback
On this page
GroupDocs.Conversion provides the EmailLoadOptions class to give you control over how the source email document will be processed. The following options could be set:
| Option | Description |
|---|---|
| Format | The document type is auto-detected during loading, however, you can specify explicitly the type of the source email document. Available options are: Msg, Eml, Emlx, Pst, Ost, Vcf, Mht |
| ConvertOwned | Controls whether the owned documents in the documents container must be converted |
| ConvertOwner | Controls whether the documents container itself must be converted If this property is true the documents container will be the first converted document |
| Depth | Controls how many levels in depth to perform the conversion |
| DisplayBccEmailAddress | Option to display or hide “Bcc” email address |
| DisplayCcEmailAddress | Option to display or hide “Cc” email address |
| DisplayEmailAddress | Option to display or hide email address |
| DisplayFromEmailAddress | Option to display or hide “from” email address |
| DisplayHeader | Option to display or hide the email header |
| DisplayToEmailAddress | Option to display or hide “to” email address |
| FieldTextMap | The mapping between email message EmailField and field text representation |
| PreserveOriginalDate | defines whether to keep the original date header string in the mail message when saving (Default value is true) |
| ResourceLoadingTimeout | Specifies the timeout of loading the external resources. |
| TimeZoneOffset | Gets or sets the Coordinated Universal Time (UTC) offset for the message dates. This property defines the time zone difference, between the local time and UTC. |
The following code snippet shows how to convert an Email document and control the visibility of the fields:
Contracts.Func<LoadOptions> getLoadOptions = () => new EmailLoadOptions
{
DisplayHeader = false,
DisplayFromEmailAddress = false,
DisplayToEmailAddress = false,
DisplayEmailAddress = false,
DisplayCcEmailAddress = false,
DisplayBccEmailAddress = false
};
using (Converter converter = new Converter("sample.msg", getLoadOptions))
{
PdfConvertOptions options = new PdfConvertOptions();
converter.Convert("converted.pdf", options);
}
The following code snippet shows how to convert an Email document and all attachments:
var source = "sample-with-attachment.eml";
var loadOptions = new EmailLoadOptions {
ConvertOwner = true,
ConvertOwned = true,
// convert email itself and the attachments
Depth = 2
};
using (var converter = new Converter(source, () => loadOptions))
{
var index = 1;
var options = new PdfConvertOptions();
// Note: index = 1 is the email itself, all following indexes are attachments
converter.Convert(() => new FileStream($"converted-{index++}.pdf", FileMode.Create) , options);
}
WarningThis functionality is introduced in v20.1
The following code snippet shows how to convert an Email document and localize the Email fields:
var source = "sample.eml";
var loadOptions = new EmailLoadOptions
{
FieldTextMap = new Dictionary<EmailField, string>
{
{ EmailField.Subject, "Gegenstand" },
{ EmailField.From, "Von" },
{ EmailField.Attachments, "Anhänge" }
}
};
using (var converter = new Converter(source, () => loadOptions))
{
var options = new PdfConvertOptions();
converter.Convert("converted.pdf" , options);
}
WarningThis functionality is introduced in v20.3
The following code snippet shows how to convert an Email document and modify the date/time format:
var source = "sample.eml";
CultureInfo.CurrentCulture = new CultureInfo("fr-FR");
using (var converter = new Converter(source))
{
var options = new PdfConvertOptions();
converter.Convert("converted.pdf" , options);
}
WarningThis functionality is introduced in v20.3
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.
