FAQ — Aspose.Email FOSS für .NET

Lizenzierung

Welche Lizenz verwendet Aspose.Email.Foss?

MIT license. Kein Lizenzschlüssel ist erforderlich. Verwenden Sie sie frei in privaten, kommerziellen und Open‑Source‑Projekten.

Installation

Wie installiere ich Aspose.Email.Foss?

dotnet add package Aspose.Email.Foss

Welche .NET-Version ist erforderlich?

.NET 8.0 oder höher. Die Bibliothek unterstützt .NET Framework oder .NET Standard nicht.

Gibt es native Abhängigkeiten?

Nein. Die Bibliothek ist reines verwaltetes C# ohne native Abhängigkeiten. Sie läuft identisch auf Windows, Linux, macOS, Docker und serverlosen Umgebungen.

Formatunterstützung

Welche E‑Mail‑Formate werden unterstützt?

Kann ich EML-Dateien lesen?

Ja. Verwenden Sie MapiMessage.LoadFromEml(stream), um eine Standard-.eml-Datei in ein MapiMessage zu laden.
Der integrierte MIME‑Parser verarbeitet gefaltete Header, Base64‑Inhalte und Multipart‑Nachrichten.

Kann ich MSG in EML konvertieren?

Ja. Rufen Sie message.SaveToEml() für die In‑Memory byte[]‑Ausgabe auf, oder message.SaveToEml(stream), um in eine Datei zu schreiben. Betreff, Text, HTML‑Text, Absender, Empfänger und alle Anhänge bleiben erhalten.

Wird TNEF (winmail.dat) unterstützt?

Nein. Nur die Standard‑MSG (CFB)- und EML (MIME)-Formate werden unterstützt.

Wird IMAP/SMTP/POP3 unterstützt?

Nein. Die Bibliothek verarbeitet MSG-Dateien direkt und enthält keine Netzwerk‑/Protokollschicht.

API-Nutzung

Wie lade ich eine MSG-Datei?

using Aspose.Email.Foss.Msg;
using var stream = File.OpenRead("message.msg");
var message = MapiMessage.FromStream(stream);
Console.WriteLine(message.Subject);

Wie erstelle ich eine neue Nachricht?

var message = MapiMessage.Create("Subject", "Body");
message.SenderEmailAddress = "alice@example.com";
message.AddRecipient("bob@example.com", "Bob");
message.Save("output.msg");

Wie füge ich Anhänge hinzu?

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

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

Wie konvertiere ich EML zu MSG?

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

Wie greife ich auf die rohe CFB-Struktur zu?

using Aspose.Email.Foss.Cfb;
using var reader = CfbReader.FromFile("message.msg");
foreach (var entry in reader.IterChildren(CfbConstants.RootStreamId))
    Console.WriteLine(entry.Name);

Bekannte Einschränkungen

Gibt es nicht implementierte Methoden?

In der aktuellen Version existieren keine absichtlich nicht implementierten Stubs.

Ist die Kalender-/Terminunterstützung verfügbar?

Die Bibliothek verarbeitet MSG-Dateien generisch. Kalender‑spezifische Eigenschaften können über SetProperty() / GetPropertyValue() mit MAPI‑Property‑IDs aus CommonMessagePropertyId abgerufen werden, aber es gibt keine dedizierte Kalender‑ oder Termin‑API.

Ist Thread‑Sicherheit garantiert?

Jede MapiMessage‑ und CfbReader‑Instanz ist unabhängig. Der gleichzeitige Zugriff auf separate Instanzen aus verschiedenen Threads ist sicher. Teilen Sie keine einzelne Instanz über Threads hinweg ohne externe Synchronisation.