Carica e Salva Messaggio Email
Carica Messaggio Email
Carica da EML
Questa sezione descrive come caricare un file EML in un oggetto MailMessage usando il EmlLoadOptions classe. La classe EmlLoadOptions fornisce varie opzioni per personalizzare come il file EML viene caricato, come preservare i formati dei messaggi incorporati o controllare il comportamento di caricamento degli allegati TNEF.
- Inizializza un’istanza di EmlLoadOptions.
- Configura le opzioni di caricamento secondo necessità.
- Usa il MailMessage.Load() metodo per caricare il file EML con le opzioni specificate.
using Aspose.Email;
// Initialize EmlLoadOptions
var loadOptions = new EmlLoadOptions
{
// Configure load options
PreferredTextEncoding = Encoding.UTF8, // Sets preferred encoding for the message
PreserveEmbeddedMessageFormat = true, // Preserve format of embedded messages
PreserveTnefAttachments = true, // Control TNEF attachment loading
RemoveSignature = false // Do not remove the signature
};
// Load the EML file
var eml = MailMessage.Load("file.eml", loadOptions);
Proprietà di EmlLoadOptions
- PreferredTextEncoding: Imposta la codifica preferita per l’oggetto e il corpo del messaggio. Il valore predefinito è
null. - PreserveEmbeddedMessageFormat: Indica se preservare il formato dei messaggi incorporati durante il caricamento. Il valore predefinito è
false. - PreserveTnefAttachments: Controlla il comportamento di caricamento degli allegati TNEF. Il valore predefinito è
false. - RemoveSignature: Specifica se la firma deve essere rimossa durante il caricamento. Il valore predefinito è
false.
Preserva Formato Messaggi Incorporati
string dataDir = RunExamples.GetDataDir_Email();
MailMessage mail = MailMessage.Load(dataDir + "tnefWithMsgInside.eml", new EmlLoadOptions() { PreserveEmbeddedMessageFormat = true });
FileFormatType fileFormat = FileFormatUtil.DetectFileFormat(mail.Attachments[0].ContentStream).FileFormatType;
Console.WriteLine("Embedded message file format: " + fileFormat);
Carica messaggio con firma/senza firma
La conservazione della firma è supportata di default quando si caricano file EML. Per rimuovere la firma, è possibile impostare il LoadOptions.RemoveSignature proprietà a true.
Il frammento di codice seguente mostra come rimuovere una firma durante il caricamento di un messaggio:
var msg = MailMessage.Load(fileName, new EmlLoadOptions() { RemoveSignature = true});
Carica da EMLX
La sezione seguente tratta il caricamento di un file EMLX con il EmlxLoadOptions classe. Questa classe fornisce opzioni simili a EmlLoadOptions, offrendo controllo sulla codifica, rimozione della firma e altro.
- Istanzia le EmlxLoadOptions.
- Configura le proprietà secondo necessità.
- Usa il MailMessage.Load() metodo per caricare il file EMLX.
using Aspose.Email;
// Instantiate EmlxLoadOptions
var loadOptions = new EmlxLoadOptions
{
// Configure load options
PreferredTextEncoding = Encoding.UTF8, // Set encoding preference
PreserveEmbeddedMessageFormat = true, // Preserve embedded message formats
RemoveSignature = true // Remove signatures during loading
};
// Load the EMLX file
var emlx = MailMessage.Load("file.emlx", loadOptions);
Proprietà di EmlxLoadOptions
- PreferredTextEncoding: Imposta la codifica preferita per l’oggetto e il corpo del messaggio. Il valore predefinito è
null. - PreserveEmbeddedMessageFormat: Indica se preservare il formato dei messaggi incorporati. Il valore predefinito è
false. - RemoveSignature: Specifica se rimuovere la firma durante il caricamento. Il valore predefinito è
false.
Carica da HTML
Scopri come caricare un file HTML in un MailMessage usando il HtmlLoadOptions classe. Questa classe è specificamente progettata per gestire contenuti HTML con opzioni per gestire le risorse e aggiungere visualizzazioni in testo semplice.
- Inizializza un’istanza di HtmlLoadOptions.
- Configura le proprietà necessarie.
- Usa il MailMessage.Load() metodo per caricare il file HTML con le opzioni specificate.
using Aspose.Email;
// Initialize HtmlLoadOptions
var loadOptions = new HtmlLoadOptions
{
// Configure load options
PathToResources = "resources/", // Path to directory containing resource files
PreferredTextEncoding = Encoding.UTF8, // Set encoding preference
ShouldAddPlainTextView = true // Add plain text view of the body
};
// Load the HTML file
var html = MailMessage.Load("file.html", loadOptions);
Proprietà di HtmlLoadOptions
- PathToResources: Definisce il percorso della directory contenente i file delle risorse (immagini, ad es.).
- PreferredTextEncoding: Imposta la codifica preferita per l’oggetto e il corpo del messaggio. Il valore predefinito è
null. - PreserveEmbeddedMessageFormat: Determina se preservare il formato dei messaggi incorporati. Il valore predefinito è
false. - ShouldAddPlainTextView: Specifica se aggiungere una visualizzazione in testo semplice del corpo del messaggio. Il valore predefinito è
false.
Carica da MHTML
Questa sezione spiega come caricare un file MHTML usando il MhtmlLoadOptions classe. La classe MhtmlLoadOptions offre opzioni per gestire la codifica, preservare i formati dei messaggi incorporati e gestire gli allegati TNEF.
- Crea un’istanza di MhtmlLoadOptions.
- Configura le proprietà desiderate.
- Carica il file MHTML usando il MailMessage.Load() metodo.
using Aspose.Email;
// Create MhtmlLoadOptions
var loadOptions = new MhtmlLoadOptions
{
// Set load options
PreferredTextEncoding = Encoding.UTF8, // Set encoding preference
PreserveEmbeddedMessageFormat = true, // Preserve format of embedded messages
PreserveTnefAttachments = true, // Handle TNEF attachments
RemoveSignature = false // Keep the signature
};
// Load the MHTML file
var mhtml = MailMessage.Load("file.mht", loadOptions);
Proprietà di MhtmlLoadOptions
- MessageFormat: Rappresenta il formato del messaggio di posta, che può essere EML, MSG o MHTML. Il valore predefinito è EML.
- PreferredTextEncoding: Imposta la codifica preferita per l’oggetto e il corpo del messaggio. Il valore predefinito è
null. - PreserveEmbeddedMessageFormat: Determina se preservare il formato dei messaggi incorporati. Il valore predefinito è
false. - PreserveTnefAttachments: Controlla il comportamento di caricamento degli allegati TNEF. Il valore predefinito è
false. - RemoveSignature: Specifica se rimuovere la firma durante il caricamento. Il valore predefinito è
false.
Carica da MSG
Questa sezione spiega come caricare un file MSG in un oggetto MailMessage usando il MsgLoadOptions classe. La classe MsgLoadOptions offre varie proprietà per gestire il modo in cui i file MSG sono caricati, incluse opzioni per preservare il contenuto RTF o gestire gli allegati TNEF.
- Crea un’istanza di MsgLoadOptions.
- Imposta le proprietà desiderate per personalizzare il caricamento.
- Carica il file MSG usando il MailMessage.Load() metodo.
using Aspose.Email;
// Create MsgLoadOptions
var loadOptions = new MsgLoadOptions
{
// Set load options
KeepOriginalEmailAddresses = true, // Preserve original email addresses
PreferredTextEncoding = Encoding.UTF8, // Set preferred encoding
PreserveRtfContent = true, // Keep RTF content in the message
PreserveTnefAttachments = true, // Handle TNEF attachments
RemoveSignature = false, // Keep the signature
Timeout = 5000 // Set timeout to 5 seconds
};
// Load the MSG file
var msg = MailMessage.Load("file.msg", loadOptions);
Proprietà di MsgLoadOptions
- KeepOriginalEmailAddresses: Indica se conservare gli indirizzi email originali. Il valore predefinito è
false. - PreferredTextEncoding: Definisce la codifica preferita per l’oggetto e il corpo del messaggio. Il valore predefinito è
null. - PreserveEmbeddedMessageFormat: Determina se il formato dei messaggi incorporati deve essere preservato. Il valore predefinito è
false. - PreserveRtfContent: Specifica se conservare il contenuto del corpo RTF in
MailMessage. Il valore predefinito èfalse. - PreserveTnefAttachments: Gestisce il comportamento di caricamento degli allegati TNEF. Il valore predefinito è
false. - RemoveSignature: Decide se rimuovere la firma durante il caricamento. Il valore predefinito è
false. - Timeout: Limita il tempo di formattazione in millisecondi durante la conversione. Il valore predefinito è 3000 ms.
Carica da TNEF
Scopri come caricare un file TNEF eml con il TnefLoadOptions classe. Questa classe fornisce opzioni per gestire la codifica e rimuovere le firme durante il processo di caricamento.
- Istanzia il TnefLoadOptions.
- Configura le proprietà secondo necessità.
- Usa il MailMessage.Load() metodo per caricare il file TNEF.
using Aspose.Email;
// Instantiate TnefLoadOptions
var loadOptions = new TnefLoadOptions
{
// Configure load options
PreferredTextEncoding = Encoding.UTF8, // Set encoding preference
PreserveEmbeddedMessageFormat = true, // Preserve embedded message formats
RemoveSignature = true // Remove signatures during loading
};
// Load the TNEF file
var tnef = MailMessage.Load("file.eml", loadOptions);
Proprietà di TnefLoadOptions
- MessageFormat: Rappresenta il formato del messaggio di posta, come EML, MSG o MHTML. Il valore predefinito è EML.
- PreferredTextEncoding: Imposta la codifica preferita per l’oggetto e il corpo del messaggio. Il valore predefinito è
null. - PreserveEmbeddedMessageFormat: Indica se preservare il formato dei messaggi incorporati. Il valore predefinito è
false. - RemoveSignature: Specifica se rimuovere la firma durante il caricamento. Il valore predefinito è
false.
Carica un Messaggio da una Libreria Documenti Microsoft SharePoint
Puoi leggere i messaggi email memorizzati in una libreria documenti Microsoft SharePoint e caricarli in un MailMessage oggetto. Per accedere ai file in una libreria documenti SharePoint, l’SDK SharePoint deve essere installato sul sistema. L’SDK fornisce l’API necessaria per effettuare il login e accedere ai file della libreria.
L’esempio sotto assume che il file di messaggio Microsoft Outlook (.msg) è già memorizzato nella cartella Documenti Condivisi della libreria documenti SharePoint. L’SDK SharePoint è usato per leggere il file del messaggio in uno stream, che viene poi passato al MailMessage.Load metodo. Una volta caricato, le proprietà del messaggio (oggetto, testo, corpo HTML, ecc.) possono essere accessibili. Per informazioni su come installare e configurare Microsoft SharePoint Server e l’SDK, consulta le sezioni corrispondenti nella libreria MSDN.
// Private members
private SPSite site = null;
private SPWeb web = null;
private void EstablishSharepoint()
{
site = new SPSite("http://localhost/Site1");
web = site.OpenWeb();
}
private void button2_Click(object sender, EventArgs e)
{
SPSecurity.CodeToRunElevated elevatedGetSite = new SPSecurity.CodeToRunElevated(EstablishSharepoint);
SPSecurity.RunWithElevatedPrivileges(elevatedGetSite);
// Path to the MSG file stored in the Shared Documents folder
SPFile msgFile = web.GetFile("Shared Documents/Test.msg");
// Read the file into a memory stream
MemoryStream fileStream = new MemoryStream();
byte[] currentFileContent = msgFile.OpenBinary();
fileStream.Write(currentFileContent, 0, currentFileContent.Length);
fileStream.Position = 0;
// Create an instance of the MailMessage class and pass the memory stream of the MSG file to it
MailMessage msg = MailMessage.Load(fileStream, new MsgLoadOptions());
fileStream.Close();
fileStream.Dispose();
// Access the MailMessage class' public properties
Console.WriteLine("Subject: " + msg.Subject);
Console.WriteLine("From: " + msg.From.ToString());
Console.WriteLine("Text Body: " + msg.TextBody);
}
Rilevamento dei Formati dei File
L’API Aspose.Email fornisce la capacità di rilevare il formato del file del messaggio fornito. Il DetectFileFormat metodo di FileFormatUtil classe può essere usata per ottenere questo risultato. I seguenti tipi e metodi possono essere usati per rilevare il formato del file caricato.
- FileFormatType Enumerazione
- FileFormatInfo Classe
- FileFormatUtil Classe
- FileFormatUtil.DetectFileFormat(Stream) Method
- FileFormatUtil.DetectFileFormat(String) Method
Il frammento di codice seguente ti mostra come rilevare i formati dei file.
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Email();
// Detect file format and Gets the detected load format
FileFormatInfo info = FileFormatUtil.DetectFileFormat(dataDir + "message.msg");
Console.WriteLine("The message format is: " + info.FileFormatType);
Salva e converte messaggi
Aspose.Email rende facile convertire qualsiasi tipo di messaggio in un altro formato. Per dimostrare questa funzionalità, il codice in questo articolo carica tre tipi di messaggi dal disco e li salva nuovamente in altri formati. La classe base SaveOptions e le classi EmlSaveOptions, MsgSaveOptions, MhtSaveOptions, HtmlSaveOptions per impostazioni aggiuntive durante il salvataggio MailMessage può essere usato per salvare i messaggi in altri formati. L’articolo mostra come usare queste classi per salvare una email di esempio come:
- Formato EML.
- Outlook MSG.
- Formato MHTML.
- Formato HTML.
Salva in EML
Il seguente frammento di codice mostra come caricare un messaggio EML e salvarlo su disco nello stesso formato.
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Email();
// Initialize and Load an existing EML file by specifying the MessageFormat
MailMessage mailMessage = MailMessage.Load(dataDir + "Attachments.eml");
mailMessage.Save(dataDir + "LoadAndSaveFileAsEML_out.eml", SaveOptions.DefaultEml);
Confini del messaggio originale
Quando un messaggio EML viene caricato e salvato nuovamente in EML, i confini del messaggio sorgente sono preservati per impostazione predefinita, quindi non è necessaria alcuna configurazione per mantenerli. Le versioni precedenti della libreria esponevano una EmlSaveOptions.PreserveOriginalBoundaries proprietà a questo scopo. Questa proprietà è stata rimossa e preservare i confini originali è ora il comportamento predefinito.
Personalizza i confini MIME
Se hai bisogno che i confini seguano uno schema specifico, usa il BoundariesTemplate proprietà del EmlSaveOptions classe. Definisce il modello usato per generare i confini MIME per il messaggio salvato. Il valore predefinito è null, il che significa che i confini sono generati dalla libreria. Due caratteri jolly sono supportati nel modello:
{#}– il numero di confine.{guid}– un GUID generato.
Il frammento di codice seguente mostra come caricare un EML e salvarlo come EML con confini MIME personalizzati.
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Email();
MailMessage mailMessage = MailMessage.Load(dataDir + "Attachments.eml");
// Save as eml with a custom boundary template
EmlSaveOptions emlSaveOptions = new EmlSaveOptions(MailMessageSaveType.EmlFormat)
{
BoundariesTemplate = "boundary_{#}_{guid}"
};
mailMessage.Save(dataDir + "CustomBoundaries_out.eml", emlSaveOptions);
Preserva gli allegati TNEF
Il frammento di codice seguente ti mostra come salvare come EML preservando gli allegati TNEF.
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Email();
MailMessage mailMessage = MailMessage.Load(dataDir + "tnefEML.eml");
// Save as eml with preserved attachment
EmlSaveOptions emlSaveOptions = new EmlSaveOptions(MailMessageSaveType.EmlFormat)
{
FileCompatibilityMode = FileCompatibilityMode.PreserveTnefAttachments
};
mailMessage.Save(dataDir + "PreserveTNEFAttachment_out.eml", emlSaveOptions);
Salva EML in MSG
Il seguente frammento di codice mostra come caricare un messaggio EML e convertirlo in MSG usando l’opzione appropriata da SaveOptions.
// Data directory for reading and writing files
string dataDir = RunExamples.GetDataDir_Email();
// Initialize and Load an existing EML file by specifying the MessageFormat
MailMessage eml = MailMessage.Load(dataDir + "Message.eml");
// Save the Email message to disk in ASCII format and Unicode format
eml.Save(dataDir + "AnEmail_out.msg", SaveOptions.DefaultMsgUnicode);
Preserva le date
Il MsgSaveOptions la classe consente di salvare il messaggio di origine come file Outlook Message (MSG) preservando le date. Il frammento di codice seguente mostra come salvare come MSG con le date preservate.
// Data directory for reading and writing files
string dataDir = RunExamples.GetDataDir_Email();
// Initialize and Load an existing EML file by specifying the MessageFormat
MailMessage eml = MailMessage.Load(dataDir + "Message.eml");
// Save as msg with preserved dates
MsgSaveOptions msgSaveOptions = new MsgSaveOptions(MailMessageSaveType.OutlookMessageFormatUnicode)
{
PreserveOriginalDates = true
};
eml.Save(Path.Combine(dataDir, "outTest_out.msg"), msgSaveOptions);
Salva EML in MHTML
Diverse opzioni di MHTML possono essere usate per ottenere i risultati desiderati. Il frammento di codice seguente ti mostra come caricare un messaggio EML in MailMessage e convertilo in MHTML con la data del messaggio nel sistema UTC.
// Set options for MHTML output
MhtSaveOptions saveOptions = SaveOptions.DefaultMhtml;
saveOptions.PreserveOriginalDate = false; // save a message date as UTC date
// Initialize and load an existing EML file
using (MailMessage mailMessage = MailMessage.Load(folderPath + "Message.eml"))
{
mailMessage.Save(folderPath + "Message_out.mhtml", saveOptions);
}
Opzioni di conversione
Il MhtSaveOptions la classe fornisce opzioni aggiuntive per salvare i messaggi email in formato MHTML. L’enumeratore MhtFormatOptions consente di scrivere informazioni email aggiuntive nel MHTML di output. I seguenti campi aggiuntivi possono essere scritti:
WriteHeader– scrive l’intestazione email nel file di output.WriteOutlineAttachments– scrive gli allegati outline nel file di output.WriteCompleteEmailAddress– scrive l’indirizzo email completo nel file di output.NoEncodeCharacters– non dovrebbe essere usata alcuna codifica di trasferimento per i caratteri.HideExtraPrintHeader– nasconde l’intestazione di stampa extra dalla parte superiore del file di output.WriteCompleteToEmailAddress– scrive l’indirizzo email completo del destinatario nel file di output.WriteCompleteFromEmailAddress– scrive l’indirizzo email completo del mittente nel file di output.WriteCompleteCcEmailAddress– scrive gli indirizzi email completi di tutti i destinatari in copia carbone nel file di output.WriteCompleteBccEmailAddress– scrive l’indirizzo email completo di tutti i destinatari in copia carbone nascosta nel file di output.RenderCalendarEvent– scrive il testo dell’evento calendario nel file di output.SkipByteOrderMarkInBody– saltare i byte del Byte Order Mark (BOM) nel corpo del file di output.RenderVCardInfo– scrive il testo da VCard AlternativeView nel file di output.DisplayAsOutlook– visualizza l’intestazione From.RenderTaskFields– scrive campi specifici del Task nel file di output.None– Nessuna impostazione specificata.
Il frammento di codice seguente ti mostra come convertire file EML in MHTML con impostazioni opzionali.
MailMessage eml = MailMessage.Load(Path.Combine(dataDir, "Message.eml"));
// Save as mht with header
MhtSaveOptions mhtSaveOptions = new MhtSaveOptions
{
//Specify formatting options required
//Here we are specifying to write header information to the output without writing extra print header
//and the output headers should display as the original headers in message
MhtFormatOptions = MhtFormatOptions.WriteHeader | MhtFormatOptions.HideExtraPrintHeader | MhtFormatOptions.DisplayAsOutlook,
// Check the body encoding for validity.
CheckBodyContentEncoding = true
};
eml.Save(Path.Combine(dataDir, "outMessage_out.mht"), mhtSaveOptions);
Renderizza eventi del calendario
Il MhtFormatOptions.RenderCalendarEvent renderizza gli eventi del Calendario nell’output MHTML. Il seguente frammento di codice mostra come renderizzare gli eventi del calendario durante la conversione in MHTML.
// The path to the File directory.
string dataDir = RunExamples.GetDataDir_Email();
string fileName = "Meeting with Recurring Occurrences.msg";
MailMessage msg = MailMessage.Load(dataDir + fileName);
MhtSaveOptions options = new MhtSaveOptions();
options.MhtFormatOptions = MhtFormatOptions.WriteHeader | MhtFormatOptions.RenderCalendarEvent;
//Format the output details if required - optional
//Set the display for Start Property
if (options.FormatTemplates.ContainsKey(MhtTemplateName.Start))
options.FormatTemplates[MhtTemplateName.Start] = @"<span class='headerLineTitle'>Start:</span><span class='headerLineText'>{0}</span><br/>";
else
options.FormatTemplates.Add(MhtTemplateName.Start, @"<span class='headerLineTitle'>Start:</span><span class='headerLineText'>{0}</span><br/>");
//Set the display for End Property
if (options.FormatTemplates.ContainsKey(MhtTemplateName.End))
options.FormatTemplates[MhtTemplateName.End] = @"<span class='headerLineTitle'>End:</span><span class='headerLineText'>{0}</span><br/>";
else
options.FormatTemplates.Add(MhtTemplateName.End, @"<span class='headerLineTitle'>End:</span><span class='headerLineText'>{0}</span><br/>");
//Set the display for Recurrence Property
if (options.FormatTemplates.ContainsKey(MhtTemplateName.Recurrence))
options.FormatTemplates[MhtTemplateName.Recurrence] = @"<span class='headerLineTitle'>Recurrence:</span><span class='headerLineText'>{0}</span><br/>";
else
options.FormatTemplates.Add(MhtTemplateName.Recurrence, @"<span class='headerLineTitle'>Recurrence:</span><span class='headerLineText'>{0}</span><br/>");
//Set the display for RecurrencePattern Property
if (options.FormatTemplates.ContainsKey(MhtTemplateName.RecurrencePattern))
options.FormatTemplates[MhtTemplateName.RecurrencePattern] = @"<span class='headerLineTitle'>RecurrencePattern:</span><span class='headerLineText'>{0}</span><br/>";
else
options.FormatTemplates.Add(MhtTemplateName.RecurrencePattern, @"<span class='headerLineTitle'>RecurrencePattern:</span><span class='headerLineText'>{0}</span><br/>");
//Set the display for Organizer Property
if (options.FormatTemplates.ContainsKey(MhtTemplateName.Organizer))
options.FormatTemplates[MhtTemplateName.Organizer] = @"<span class='headerLineTitle'>Organizer:</span><span class='headerLineText'>{0}</span><br/>";
else
options.FormatTemplates.Add(MhtTemplateName.Organizer, @"<span class='headerLineTitle'>Organizer:</span><span class='headerLineText'>{0}</span><br/>");
//Set the display for RequiredAttendees Property
if (options.FormatTemplates.ContainsKey(MhtTemplateName.RequiredAttendees))
options.FormatTemplates[MhtTemplateName.RequiredAttendees] = @"<span class='headerLineTitle'>RequiredAttendees:</span><span class='headerLineText'>{0}</span><br/>";
else
options.FormatTemplates.Add(MhtTemplateName.RequiredAttendees, @"<span class='headerLineTitle'>RequiredAttendees:</span><span class='headerLineText'>{0}</span><br/>");
msg.Save(dataDir + "Meeting with Recurring Occurrences.mhtml", options);
Esportazione dell’email in MHT senza immagini in linea
Il SkipInlineImages proprietà del MhtSaveOptions classe definisce se saltare i riferimenti alle immagini quando si salva in MHTML. Il valore predefinito è false.
MailMessage eml = MailMessage.Load(Path.Combine(dataDir, "Message.eml"));
MhtSaveOptions mhtSaveOptions = new MhtSaveOptions
{
SkipInlineImages = true
};
eml.Save(Path.Combine(dataDir, "EmlToMhtmlWithoutInlineImages_out.mht"), mhtSaveOptions);
Esportazione Email in MHT con Fuso Orario Personalizzato
MailMessage classe fornisce il TimeZoneOffset proprietà per impostare il fuso orario personalizzato durante l’esportazione in MHT. Il seguente frammento di codice mostra come esportare l’email in MHT con fuso orario personalizzato.
MailMessage eml = MailMessage.Load(dataDir + "Message.eml");
// Set the local time for message date.
eml.TimeZoneOffset = TimeZone.CurrentTimeZone.GetUtcOffset(DateTime.Now);
// or set custom time zone offset for message date (-0800)
// eml.TimeZoneOffset = new TimeSpan(-8,0,0);
// The dates will be rendered by local system time zone.
MhtSaveOptions so = new MhtSaveOptions();
so.MhtFormatOptions = MhtFormatOptions.WriteHeader;
eml.Save(dataDir + "ExportEmailToMHTWithCustomTimezone_out.mhtml", so);
Regolazione del carattere
string dataDir = RunExamples.GetDataDir_Email();
MailMessage eml = MailMessage.Load(dataDir + "Message.eml");
MhtSaveOptions options = SaveOptions.DefaultMhtml;
int cssInsertPos = options.CssStyles.LastIndexOf("</style>");
options.CssStyles = options.CssStyles.Insert(cssInsertPos,
".PlainText{" +
" font-family: sans-serif;" +
"}"
);
eml.Save("message.mhtml", options);
Salva EML in HTML
Il HtmlSaveOptions la classe consente di esportare il corpo del messaggio in HTML. Il seguente frammento di codice mostra come salvare un messaggio in HTML.
MailMessage message = MailMessage.Load(dataDir + "Message.eml");
message.Save(dataDir + "SaveAsHTML_out.html", SaveOptions.DefaultHtml);
// OR
MailMessage eml = MailMessage.Load(dataDir + "Message.eml");
HtmlSaveOptions options = SaveOptions.DefaultHtml;
options.HtmlFormatOptions = HtmlFormatOptions.WriteHeader | HtmlFormatOptions.WriteCompleteEmailAddress; //save the message headers to output HTML using the formatting options
eml.Save(dataDir + "SaveAsHTML1_out.html", options);
Controlla come le risorse vengono renderizzate
Il ResourceRenderingMode proprietà del HtmlSaveOptions classe definisce come le risorse del messaggio (immagini inline, ad esempio) sono scritte nell’HTML di output. Accetta i valori di ResourceRenderingMode enumerazione:
EmbedIntoHtml– incorporare le risorse nell’HTML come stringhe base64. Questo è il valore predefinito.SaveToFile– salvare le risorse su file e inserire il percorso di ciascun file nelsrctag.SubstituteFromFile– usare un file personalizzato come icona e inserire il percorso nelsrctag.None– non rendere le risorse nell’HTML.
Quando le risorse non sono incorporate, il SaveResourceHandler delegate viene chiamato per ogni allegato del messaggio, consentendo di decidere dove ogni risorsa è memorizzata e quale percorso viene scritto nell’HTML.
var fileName = "EmailWithAttandEmbedded.eml";
var filePath = Path.Combine(dataDir, fileName);
MailMessage msg = MailMessage.Load(filePath);
var outFileName = Path.Combine(dataDir, fileName + ".html");
var options = new HtmlSaveOptions()
{
ResourceRenderingMode = ResourceRenderingMode.SaveToFile,
SaveResourceHandler =
(AttachmentBase attachment, out string resourcePath) =>
{
attachment.Save(Path.Combine(dataDir, attachment.ContentId));
resourcePath = Path.Combine(".", attachment.ContentId);
}
};
msg.Save(outFileName, options);
Salva EML in OFT
Il seguente frammento di codice mostra come salvare un messaggio come file modello Outlook (.oft).
using (MailMessage eml = new MailMessage("test@from.to", "test@to.to", "template subject", "Template body"))
{
string oftEmlFileName = "EmlAsOft_out.oft";
MsgSaveOptions options = SaveOptions.DefaultMsgUnicode;
options.SaveAsTemplate = true;
eml.Save(dataDir + oftEmlFileName, options);
}
Converti EML in MSG (MailMessage a MapiMessage)
Per convertire un MailMessage oggetto caricato da un file EML a un MapiMessage oggetto, utilizza il MapiConversionOptions classe. Questa conversione è spesso necessaria perché questi due oggetti servono a scopi diversi e soddisfano esigenze distinte nell’elaborazione delle email. MapiMessage è specificamente progettato per la compatibilità con Microsoft Outlook e Exchange Server, poiché aderisce al formato Messaging Application Programming Interface (MAPI). Ciò garantisce che le email convertite in file MSG siano pienamente compatibili con i prodotti Microsoft, permettendo di aprirle, modificarle e gestirle direttamente in Outlook.
Questa conversione è anche necessaria quando le email devono essere archiviate, indicizzate o elaborate da archivi che richiedono il formato MAPI, PST/OST, OLM. Il MapiConversionOptions la classe consente di specificare opzioni aggiuntive, come preservare il formato originale del messaggio, mantenere le date originali e comprimere il corpo RTF durante la conversione. Il seguente esempio di codice mostra come caricare un’email da un file in formato .eml e convertirla in un formato Outlook .msg consentendo la personalizzazione ma garantendo che alcune caratteristiche dell’email originale siano preservate durante la conversione.
- Crea un’istanza di
MapiConversionOptionse configura le sue proprietà. - Converti il
MailMessageoggetto a unMapiMessageoggetto che utilizza le opzioni di conversione configurate.
MailMessage eml = MailMessage.Load("email.eml", new EmlLoadOptions());
// Create an instance of MapiConversionOptions
var conversionOptions = new MapiConversionOptions
{
// Configure MapiConversionOptions
Format = OutlookMessageFormat.Unicode, // Use Unicode format for MSG
PreserveEmbeddedMessageFormat = true, // Preserve the format of embedded messages
PreserveOriginalAddresses = true, // Keep original email addresses
PreserveOriginalDates = true, // Preserve original dates
PreserveEmptyDates = false, // Generate new dates if original are empty
RemoveSignature = false, // Do not remove the signature
UseBodyCompression = true, // Enable RTF body compression
ForcedRtfBodyForAppointment = false // Disable forced RTF body for appointments
};
// Convert MailMessage to MapiMessage
MapiMessage msg = MapiMessage.FromMailMessage(eml, conversionOptions);
Proprietà disponibili di MapiConversionOptions
-
ASCIIFormat: Restituisce
MapiConversionOptionsconfigurato conOutlookMessageFormatcome ASCII, conPreserveSignatureimpostato su false eUseBodyCompressionimpostato su false. Questa opzione è utile quando è necessaria una conversione in formato ASCII semplice. -
UnicodeFormat: Restituisce
MapiConversionOptionsconOutlookMessageFormatimpostato su Unicode, e entrambiPreserveSignatureeUseBodyCompressionimpostato su false. Usa questa opzione per un supporto di caratteri più completo nei file MSG. -
ForcedRtfBodyForAppointment: Quando impostato su true, forza l’uso del corpo RTF per gli appuntamenti del calendario. Questo è utile se vuoi garantire la compatibilità con alcuni client di posta. Il valore predefinito è true.
-
Format: Specifica il formato di output per il file MSG. Può essere impostato su
OutlookMessageFormat.ASCIIoppureOutlookMessageFormat.Unicode, controllando se il MSG convertito deve usare codifica ASCII o Unicode. -
PreserveEmbeddedMessageFormat: Determina se mantenere il formato EML originale dei messaggi incorporati durante la conversione in
MapiMessage. Impostando questo su true si garantisce che le email incorporate conservino la loro struttura originale. Il valore predefinito è false. -
PreserveEmptyDates: Quando impostato su true, conserva le date originali di salvataggio e modifica dal file EML. Altrimenti, nuove date verranno generate se quelle originali sono vuote.
-
PreserveOriginalAddresses: Se impostato su true, mantiene gli indirizzi email originali senza convalida. Questo è utile quando si lavora con indirizzi email che potrebbero non conformarsi a standard rigidi ma devono essere preservati così come sono. Il valore predefinito è false.
-
PreserveOriginalDates: Garantisce che le date originali di invio e ricezione siano mantenute durante il processo di conversione. Impostandolo su true queste date vengono conservate per una migliore precisione storica.
-
RemoveSignature: Controlla se la firma digitale, se presente, sarà rimossa dal messaggio durante la conversione. Il valore predefinito è false, il che significa che la firma sarà mantenuta a meno che non venga rimossa esplicitamente.
-
UseBodyCompression: Abilita la compressione del corpo RTF se impostato su true. Questo può aiutare a ridurre la dimensione del file MSG, specialmente con messaggi grandi con formattazione ricca.