Functies en functionaliteiten

Deze pagina behandelt elke belangrijke functie van Aspose.Email FOSS for .NET met werkende C#‑voorbeelden.

MSG‑bestanden lezen

Laad een MSG‑bestand vanaf een pad of stream en krijg toegang tot al zijn eigenschappen:

using System.IO;
using Aspose.Email.Foss.Msg;

using var stream = File.OpenRead("message.msg");
var message = MapiMessage.FromStream(stream);

Console.WriteLine(message.Subject);
Console.WriteLine(message.Body);
Console.WriteLine(message.HtmlBody);
Console.WriteLine(message.SenderName);
Console.WriteLine(message.SenderEmailAddress);
Console.WriteLine(message.MessageDeliveryTime);
Console.WriteLine(message.InternetMessageId);

Gebruik strict: false voor tolerant ontleden van niet‑standaard MSG‑bestanden:

var message = MapiMessage.FromFile("message.msg", strict: false);

Controleer ValidationIssues om eventuele formatwaarschuwingen te bekijken zonder een uitzondering te werpen:

foreach (var issue in message.ValidationIssues)
    Console.WriteLine($"Warning: {issue}");

MSG-bestanden maken

Bouw een volledige e‑mail met MapiMessage.Create() en serialiseer met Save():

using System.IO;
using Aspose.Email.Foss.Msg;

var message = MapiMessage.Create("Hello", "Body");
message.SenderName = "Alice";
message.SenderEmailAddress = "alice@example.com";
message.HtmlBody = "<p>Body</p>";
message.InternetMessageId = "<hello@example.com>";
message.MessageDeliveryTime = new DateTime(2024, 1, 2, 3, 4, 5, DateTimeKind.Utc);

message.AddRecipient("bob@example.com", "Bob");

using var output = File.Create("hello.msg");
message.Save(output);

Save() zonder argumenten retourneert een byte[]. Save(path) schrijft rechtstreeks naar een bestandspad.

Ontvangers

Voeg To, Cc en Bcc ontvangers toe met AddRecipient():

message.AddRecipient("alice@example.com", "Alice");
message.AddRecipient("bob@example.com", "Bob", MapiMessage.RecipientTypeCc);
message.AddRecipient("carol@example.com", "Carol", MapiMessage.RecipientTypeBcc);

Itereer ontvangers van een geladen bericht:

foreach (var recipient in message.Recipients)
    Console.WriteLine($"{recipient.DisplayName} <{recipient.EmailAddress}>");

Bijlagen

Voeg bestand- of streambijlagen toe met metadata:

// From byte array
message.AddAttachment("report.pdf", pdfBytes, "application/pdf");

// From stream
using var attachStream = File.OpenRead("photo.png");
message.AddAttachment("photo.png", attachStream, "image/png");

// Inline image with Content-ID
message.AddAttachment("logo.png", logoBytes, "image/png", contentId: "logo@cid");

Lees bijlagen van een geladen bericht:

foreach (var attachment in message.Attachments)
{
    Console.WriteLine($"Filename: {attachment.Filename}");
    Console.WriteLine($"MIME type: {attachment.MimeType}");
    Console.WriteLine($"Size: {attachment.Data.Length} bytes");
    File.WriteAllBytes(attachment.Filename!, attachment.Data);
}

Ingesloten berichtbijlagen

Voeg één MapiMessage in een andere toe — vaak in doorgestuurde e‑mailketens:

using Aspose.Email.Foss.Msg;

var parent = MapiMessage.Create("Outer", "Parent body");
var child = MapiMessage.Create("Inner", "Child body");
child.SenderEmailAddress = "inner@example.com";
parent.AddEmbeddedMessageAttachment(child, "inner.msg");

parent.Save("outer.msg");

Lees ingesloten berichtbijlagen:

var loaded = MapiMessage.FromFile("outer.msg");
foreach (var attachment in loaded.Attachments)
{
    if (attachment.IsEmbeddedMessage)
    {
        Console.WriteLine($"Embedded: {attachment.EmbeddedMessage!.Subject}");
    }
}

EML- en MIME-conversie

Laad een RFC 5322 .eml‑bestand in een MapiMessage voor Outlook‑compatibele opslag:

using System.IO;
using Aspose.Email.Foss.Msg;

using var input = File.OpenRead("message.eml");
var message = MapiMessage.LoadFromEml(input);

using var msgOutput = File.Create("message.msg");
message.Save(msgOutput);

Converteer terug naar EML vanuit een MSG‑bestand:

var message = MapiMessage.FromFile("message.msg");
using var emlOutput = File.Create("roundtrip.eml");
message.SaveToEml(emlOutput);

LoadFromEml() accepteert ook een string pad of byte[]. SaveToEml() zonder argumenten retourneert een byte[]. Onderwerp, inhoud, HTML‑inhoud, afzender, ontvangers en alle bijlagen (inclusief inline‑afbeeldingen met Content-ID) blijven behouden tijdens volledige EML ↔ MSG round‑trips.

MAPI‑eigenschapstoegang

MapiPropertyCollection biedt getypeerde toegang tot MAPI‑eigenschappen via SetProperty() en GetPropertyValue(). Gebruik CommonMessagePropertyId enum‑waarden voor standaardeigenschappen:

using Aspose.Email.Foss.Msg;

var message = MapiMessage.FromFile("sample.msg");

// Named convenience properties
Console.WriteLine(message.Subject);
Console.WriteLine(message.SenderName);
Console.WriteLine(message.MessageDeliveryTime);

// Iterate all MAPI property keys
foreach (var key in message.IterPropertyKeys())
    Console.WriteLine($"0x{(ushort)key.PropertyId:X4} / {key.PropertyType}");

CFB Containertoegang

Outlook MSG‑bestanden zijn gebaseerd op het Compound File Binary (CFB)-formaat. CfbReader toont de volledige directoryboom voor inspectie en gegevensextractie:

using System.Text;
using Aspose.Email.Foss.Cfb;

using var reader = CfbReader.FromFile("message.msg");

// Iterate all top-level children
foreach (var entry in reader.IterChildren(CfbConstants.RootStreamId))
    Console.WriteLine($"{(entry.IsStorage() ? "Storage" : "Stream")}: {entry.Name}");

// Navigate to a specific stream by path
var entry2 = reader.ResolvePath(["__substg1.0_0037001E"]);
if (entry2 is not null)
{
    var data = reader.GetStreamData(entry2.StreamId);
    Console.WriteLine(Encoding.Unicode.GetString(data));
}

Bouw en serialiseer een CFB‑document vanaf nul met CfbWriter:

using System.Text;
using Aspose.Email.Foss.Cfb;

var document = new CfbDocument();
document.Root.AddStream(new CfbStream("Notes", Encoding.UTF8.GetBytes("hello")));
var storage = document.Root.AddStorage(new CfbStorage("DataStore"));
storage.AddStream(new CfbStream("Payload", Encoding.UTF8.GetBytes("content")));

byte[] bytes = CfbWriter.ToBytes(document);
File.WriteAllBytes("output.cfb", bytes);

Tips en Best Practices

Gebruik using of Dispose() op MapiMessage en CfbReader om bestandshandvatten vrij te geven
Controleer message.ValidationIssues na het laden om niet‑standaard MSG‑opmaak te detecteren
De strict‑parameter in FromFile() / FromStream() bepaalt de fouttolerantie — gebruik strict: false voor een lossere parsing van bestanden van derden
MapiMessage.Create() genereert standaard Unicode‑stringberichten; stel unicodeStrings: false in voor legacy ANSI‑compatibiliteit
SaveToEml() zonder argumenten retourneert byte[] — handig voor in‑memory‑workflows

Veelvoorkomende problemen

Issue	Cause	Fix
`CfbException` bij het laden	Geen geldig CFB/MSG‑bestand	Controleer of het bestand een Outlook‑MSG is
Lege `Body` na laden	Body alleen opgeslagen in HTML	Controleer in plaats daarvan `message.HtmlBody`
0 bijlagen na `LoadFromEml`	EML heeft geen `Content-Disposition: attachment`‑onderdelen	Inline‑onderdelen (alleen Content‑ID) verschijnen ook in `Attachments`

API-referentie Samenvatting

Klasse	Beschrijving
`MapiMessage`	High-level MSG-berichtrepresentatie
`MapiAttachment`	Bijlage of ingesloten bericht op een `MapiMessage`
`MapiRecipient`	Ontvanger op een `MapiMessage`
`MapiProperty`	Enkele MAPI-eigenschap invoer
`MapiPropertyCollection`	Getypeerde MAPI-eigenschapstas
`CommonMessagePropertyId`	Enum van standaard MAPI-eigenschapidentifiers
`MsgReader`	Low-level MSG-structuurlezer
`MsgWriter`	Low-level MSG-structuurschrijver
`CfbReader`	CFB-binaire containerlezer
`CfbWriter`	CFB-binaire containerschrijver
`CfbDocument`	In-memory CFB-document voor constructie
`CfbStorage`	Opslagknooppunt in een CFB-document
`CfbStream`	Stroomknooppunt in een CFB-document