Funktionen und Funktionalitäten

Diese Seite behandelt jedes wichtige Feature von Aspose.Email FOSS for .NET mit funktionierenden C#‑Beispielen.

Lesen von MSG-Dateien

Laden Sie eine MSG-Datei von einem Pfad oder Stream und greifen Sie auf alle ihre Eigenschaften zu:

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);

Verwenden Sie strict: false für nachgiebiges Parsen nicht‑standardisierter MSG‑Dateien:

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

Überprüfen Sie ValidationIssues, um Formatwarnungen ohne Auslösen zu prüfen:

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

Erstellen von MSG-Dateien

Erstellen Sie eine vollständige E‑Mail mit MapiMessage.Create() und serialisieren Sie sie mit 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() ohne Argumente gibt ein byte[] zurück. Save(path) schreibt direkt in einen Dateipfad.

Empfänger

Fügen Sie To, Cc und Bcc Empfänger mit AddRecipient() hinzu:

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

Empfänger aus einer geladenen Nachricht iterieren:

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

Anhänge

Datei‑ oder Stream‑Anhänge mit Metadaten hinzufügen:

// 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");

Anhänge aus einer geladenen Nachricht lesen:

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);
}

Eingebettete Nachrichtenanhänge

Fügen Sie ein MapiMessage in ein anderes ein — üblich in weitergeleiteten E‑Mail‑Ketten:

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");

Bitte stellen Sie den zu übersetzenden Text bereit.

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

EML und MIME-Konvertierung

Laden Sie eine RFC 5322 .eml‑Datei in ein MapiMessage für Outlook‑kompatible Speicherung:

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);

Zurück zu EML aus einer MSG-Datei konvertieren:

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

LoadFromEml() akzeptiert auch einen string Pfad oder byte[]. SaveToEml() ohne Argumente gibt ein byte[] zurück. Betreff, Body, HTML-Body, Absender, Empfänger und alle Anhänge (einschließlich Inline‑Bilder mit Content-ID) bleiben bei vollständigen EML ↔ MSG Rundum‑Konvertierungen erhalten.

Zugriff auf MAPI‑Eigenschaften

MapiPropertyCollection bietet typisierten Zugriff auf MAPI‑Eigenschaften über SetProperty() und GetPropertyValue(). Verwenden Sie die Aufzählungswerte von CommonMessagePropertyId für Standard‑Eigenschaften:

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-Containerzugriff

Outlook‑MSG‑Dateien basieren auf dem Compound File Binary (CFB)-Format. CfbReader stellt den vollständigen Verzeichnisbaum zur Inspektion und Datenextraktion bereit:

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));
}

Erstellen und serialisieren Sie ein CFB-Dokument von Grund auf mit 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);

Tipps und bewährte Verfahren

Verwenden Sie using oder Dispose() auf MapiMessage und CfbReader, um Dateihandles freizugeben
Überprüfen Sie message.ValidationIssues nach dem Laden, um nicht standardmäßige MSG‑Formatierung zu erkennen
Der strict‑Parameter in FromFile() / FromStream() steuert die Fehlertoleranz – verwenden Sie strict: false für nachgiebiges Parsen von Dateien aus Drittanbietersystemen
MapiMessage.Create() erzeugt standardmäßig Unicode‑String‑Nachrichten; setzen Sie unicodeStrings: false für die Kompatibilität mit legacy ANSI
SaveToEml() ohne Argumente gibt byte[] zurück – praktisch für In‑Memory‑Workflows

Häufige Probleme

Problem	Ursache	Lösung
`CfbException` beim Laden	Keine gültige CFB/MSG-Datei	Stellen Sie sicher, dass die Datei eine Outlook‑MSG ist
Leeres `Body` nach dem Laden	Body nur in HTML gespeichert	Überprüfen Sie stattdessen `message.HtmlBody`
0 Anhänge nach `LoadFromEml`	EML hat keine `Content-Disposition: attachment`‑Teile	Inline‑Teile (nur Content‑ID) erscheinen ebenfalls in `Attachments`

API-Referenzübersicht

Class	Description
`MapiMessage`	Hochrangige MSG-Nachrichtendarstellung
`MapiAttachment`	Anhang oder eingebettete Nachricht in einem `MapiMessage`
`MapiRecipient`	Empfänger in einem `MapiMessage`
`MapiProperty`	Einzelner MAPI‑Eigenschaftseintrag
`MapiPropertyCollection`	Typisierte MAPI‑Eigenschaftssammlung
`CommonMessagePropertyId`	Enum der Standard‑MAPI‑Eigenschaftskennungen
`MsgReader`	Low‑level MSG-Strukturleser
`MsgWriter`	Low‑level MSG-Strukturschreiber
`CfbReader`	CFB‑Binärcontainer‑Leser
`CfbWriter`	CFB‑Binärcontainer‑Schreiber
`CfbDocument`	Im‑Speicher CFB‑Dokument zur Erstellung
`CfbStorage`	Speicherknoten in einem CFB‑Dokument
`CfbStream`	Stream‑Knoten in einem CFB‑Dokument