💡 Voll funktionsfähiges Beispiel auf GitHub verfügbar:
convert-email-and-attachments-to-pdf-dotnet

Die Email‑zu‑PDF‑Konvertierung ist ein GroupDocs.Conversion‑Workflow für .NET, der eine Outlook‑Nachricht und ihre Anhänge in eine oder mehrere PDF‑Dateien umwandelt, ohne dass ein Anhang einen anderen überschreibt oder eine nicht unterstützte Datei den gesamten Durchlauf zum Absturz bringt. Sie ersetzt ein manuelles Export‑und‑Umbenennen‑Verfahren durch ein paar Code‑Zeilen, die für jedes Element wissen, woher es stammt und ob es überhaupt konvertiert wurde.

Der alte Weg war schmerzhaft

Stellen Sie sich ein Support‑Postfach vor, in dem jede Fall‑E‑Mail zwei oder drei Anhänge enthält – hier einen Bericht, dort einen Screenshot, manchmal ein Dateiformat, das niemand im Team erkennt. Nichts daran ist ungewöhnlich. Einen Fall zu bearbeiten bedeutet, die Nachricht zu öffnen, jeden Anhang von Hand zu speichern, die kollidierenden umzubenennen, weil zwei Systeme beide eine Datei namens report.csv exportiert haben, und zu hoffen, dass nichts im Satz ein Format ist, das Ihr PDF‑Betrachter nicht öffnen kann. Machen Sie das fünfzig Mal pro Woche und der „Schnell‑Export“ wird zum langsamsten Teil der Arbeit und zum Teil, das am ehesten überstürzt wird – genau dann passieren Fehler.

Das manuelle Vorgehen kostet nicht nur Zeit – hier gehen Dateien leise verloren. Speichern Sie zwei Anhänge, beide mit dem Namen report.csv, im selben Ordner, ohne sie vorher umzubenennen, und das zweite Speichern überschreibt das erste; niemand bemerkt es, bis die September‑Zahlen nicht mehr zu finden sind. Eine Nachricht mit nur einem Anhang in einem Format, für das niemand einen Konverter hat, kann den gesamten Export blockieren, bis jemand entscheidet, was damit geschehen soll.

Die wahren Kosten des manuellen Vorgehens: Ein umbenannter und überschriebener Anhang wirft keinen Fehler – er verschwindet einfach stillschweigend, und die Falldatei sieht vollständig aus, bis jemand die darin enthaltenen Daten benötigt.

Es gibt einen besseren Weg

GroupDocs.Conversion für .NET verwandelt das in ein paar Code‑Zeilen. Manuelles Umbenennen ist nicht nötig. Die Klasse EmailLoadOptions steuert, ob die Nachricht, die Anhänge oder beides konvertiert werden, und ein SaveContext‑Callback beschreibt jedes Ausgabeelement so genau, dass zwei Anhänge mit dem Namen report.csv nie kollidieren und ein Anhang ohne PDF‑Route den Rest des Durchlaufs nicht stoppt. Jeder Aufruf dieses Callbacks liefert ItemIndex (eine laufende Zählung, beginnend bei 1), HierarchyLevel (0 für die Nachricht, 1 für einen Anhang) und SourceFileName (der ursprüngliche Dateiname) – genug Kontext, um einen kollisionsfreien Ausgabename zu erzeugen, ohne zusätzliche Buchführung zu schreiben.

Bevor wir beginnen, benötigen Sie:

  • .NET SDK 8.0 oder höher
  • GroupDocs.Conversion für .NET 26.10.0 (temporäre Lizenz erhalten zum Entfernen der Evaluationsbeschränkungen)
  • Eine Outlook‑.msg‑ oder .eml‑Nachricht zum Konvertieren

Installation mit einem Befehl:

dotnet add package GroupDocs.Conversion --version 26.10.0

Der neue Weg: Eine Nachricht und ihre Anhänge konvertieren

So sieht dieselbe Aufgabe mit GroupDocs.Conversion aus. Das folgende Beispiel konvertiert eine Outlook‑Nachricht und jeden ihrer Anhänge in ein eigenes PDF, mit Dateinamen, die niemals kollidieren.

Schritt 1 – Entscheiden, was konvertiert werden soll

EmailLoadOptions.ConvertOwner und ConvertOwned schalten die Nachricht bzw. ihre Anhänge unabhängig ein oder aus; Depth (Standard 2) begrenzt, wie tief verschachtelte Anhänge verfolgt werden.

// Die Nachricht selbst und jeden Anhang, den sie trägt, konvertieren
var loadOptions = new EmailLoadOptions
{
    ConvertOwner = true,
    ConvertOwned = true,
    Depth = 2
};

Schritt 2 – Jede Ausgabe aus SaveContext benennen

Übergeben Sie einen SaveContext‑Callback an Converter.Convert anstelle eines festen Ausgabepfads. Der Callback wird einmal pro Element ausgelöst, wobei ItemIndex pro Element eindeutig ist, selbst wenn zwei Anhänge denselben Dateinamen teilen.

using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
    converter.Convert((SaveContext item) =>
    {
        // ItemIndex ist 1 für die Nachricht, dann zählt er pro Anhang hoch
        string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
        return File.Create(Path.Combine(outputFolder, name));
    }, new PdfConvertOptions());
}

Schritt 3 – Anhänge ohne PDF‑Route behandeln

Nicht jeder Anhang kann zu einem PDF werden. Prüfen Sie SaveContext.TargetFormat gegen FileType.Unknown und speichern Sie dieses Element unter seinem eigenen Namen, anstatt es zu konvertieren.

converter.Convert((SaveContext item) =>
{
    bool passedThrough = item.TargetFormat == FileType.Unknown;
    string baseName = $"{item.ItemIndex:D2}-{item.SourceFileName}";
    string name = passedThrough
        ? baseName
        : $"{baseName}.{item.TargetFormat.Extension}";
    return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());

Richten Sie diesen Code auf eine Beispiel‑Support‑E‑Mail mit zwei Anhängen, beide report.csv genannt, und einem Anhang in einem nicht unterstützten Format. Drei PDFs entstehen: die Nachricht und beide CSV‑Berichte. Die nicht unterstützte Datei wird ebenfalls ausgegeben, unverändert – öffnen Sie sie neben dem Original und alle 32 Bytes passen exakt.

Wie vermeide ich das Überschreiben von Anhängen mit gleichem Dateinamen?

Ein Dateiname allein kann keinen sicheren Schlüssel für die Ausgabe darstellen, weil zwei Anhänge exakt denselben Namen haben können. Integrieren Sie SaveContext.ItemIndex zusammen mit SaveContext.SourceFileName in den Namen, und zwei Anhänge namens report.csv konkurrieren nicht mehr um denselben Platz auf der Festplatte; jeder erhält sein eigenes null‑gepolstertes Präfix (02- und 03- im Beispiel, nach dem 01- der Nachricht) und seine eigene Datei, egal welchen Namen die Quelle verwendet hat.

Gegenüberstellung: Vorher vs. Nachher

Vorher (Manuell) Nachher (GroupDocs.Conversion)
Zeit Minuten pro Nachricht, von Hand Ein paar Code‑Zeilen, beliebig viele Nachrichten
Doppelte Namen Stillschweigend überschrieben Getrennt gehalten über ItemIndex
Nicht unterstützter Anhang Bricht die gesamte Konvertierung ab (vor 26.10) Unter eigenem Namen gespeichert, Durchlauf bleibt
Ausgabe Was Ihr PDF‑Betrachter speichern kann Strukturierte PDFs, die Sie ablegen oder indexieren können

Die Beispiel‑Support‑E‑Mail besteht exakt aus dieser Mischung: zwei monatliche CSV‑Exporte mit gleichem Namen und eine Aufzeichnungsdatei, für die kein Konverter existiert.

Praxisbeispiel: Archivierung von Support‑Fällen

Ein Support‑Team protokolliert jeden Kundenfall als E‑Mail mit einem oder mehreren Tabellen‑Anhängen, und das Fall‑Tracking‑System benötigt jeden Anhang als eigenes durchsuchbares PDF, getrennt von der Nachricht. Das Aufrufen von KeepAttachmentsWithoutPdfRoute einmal pro eingehendem Fall wandelt die Nachricht und ihre Anhänge in ein nummeriertes Dateiset um, wobei kein Anhang jemals einen anderen überschreibt, selbst wenn zwei Berichte denselben Namen teilen. Eine Fall‑E‑Mail mit zwei monatlichen report.csv‑Exporten und einer Aufzeichnungsdatei in einem Format, das niemand konvertieren kann, ergibt vier Dateien: die Nachricht, beide CSV‑Berichte als PDFs und die Aufzeichnungsdatei unter ihrem eigenen Namen – nichts geht verloren, nichts wird zusammengeführt, nichts stillschweigend überschrieben.

// Ein Aufruf pro Fall‑E‑Mail – kein manueller Export, keine umbenannten Duplikate
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);

Was kann man sonst noch mit GroupDocs.Conversion für .NET tun?

Neben dem Auftrennen einer Nachricht von ihren Anhängen deckt EmailLoadOptions weitere Aspekte der Nachricht ab:

  • Feld‑Sichtbarkeit: Header und seine From‑, To‑, Cc‑ und Bcc‑Zeilen mit DisplayHeader und den zugehörigen Display*‑Optionen ein‑ bzw. ausblenden (Cc und Bcc sind standardmäßig ausgeblendet).
  • Lokalisierte Header: Jedem EmailField über FieldTextMap eine andere Beschriftung zuweisen, z. B. Subject und Attachments in eine andere Sprache übersetzen.
  • Datumsformatierung: Die Sent‑Zeile folgt der Kultur des Rechners, auf dem die Konvertierung läuft, und TimeZoneOffset legt den UTC‑Offset fest, der für die Nachrichten‑Datumsangaben verwendet wird.
  • Nur‑Nachrichten‑Ausgabe: ConvertOwned auf false setzen, wenn das PDF nur die Nachricht selbst ersetzen soll, wobei die Anhangsnamen weiterhin im Header zur Referenz aufgelistet werden.

Siehe die vollständige EmailLoadOptions‑Referenz für jede Option.

Fazit

Was früher bedeutete, eine Nachricht zu öffnen, Anhänge von Hand zu speichern und auf überschriebene Duplikate zu prüfen, erfordert jetzt nur einen SaveContext‑Callback und ein paar Code‑Zeilen. GroupDocs.Conversion für .NET gibt jedem Ausgabeelement – der Nachricht und jedem Anhang – einen Namen, der nie kollidiert, und bewahrt einen Anhang ohne PDF‑Route, anstatt den Durchlauf fehlschlagen zu lassen. Die gleichen drei Bausteine – ConvertOwner, ConvertOwned und der SaveContext‑Callback – skalieren von einem einzigen Zusammenfassungs‑PDF bis hin zu einer vollständigen, kollisionssicheren Aufschlüsselung einer Nachricht und aller ihrer Anhänge, sodass Sie klein anfangen und den Workflow nach Bedarf erweitern können.

Bereit, Ihren Email‑zu‑PDF‑Workflow zu automatisieren?

Weitere Ressourcen