💡 Volledig werkend voorbeeld beschikbaar op GitHub:
convert-email-and-attachments-to-pdf-dotnet

E‑mail‑naar‑PDF‑conversie is een GroupDocs.Conversion‑workflow voor .NET die een Outlook‑bericht en de bijlagen ervan omzet in één of meer PDF‑bestanden, zonder dat één bijlage een andere overschrijft of dat één niet‑ondersteund bestand de hele uitvoering onderbreekt. Het vervangt een handmatige export‑en‑hernoem‑routine door een paar regels code die voor elk item weten waar het vandaan kwam en of het al dan niet is geconverteerd.

De oude manier was pijnlijk

Stel je een support‑inbox voor waarin elke case‑e‑mail twee of drie bijlagen bevat – een rapport hier, een screenshot daar, soms een bestandsformaat dat niemand in het team herkent. Daar is niets ongewoons aan. Het afhandelen van die case betekent het bericht openen, elke bijlage handmatig opslaan, de bijlagen die botsen hernoemen omdat twee systemen beide een bestand met de naam report.csv hebben geëxporteerd, en hopen dat er niets in de set staat dat je PDF‑viewer niet kan openen. Doe dat vijftig keer per week en de “snelle export” wordt het langzaamste deel van het werk, en het deel dat het meest geneigd is om gehaast te worden, precies wanneer fouten ontstaan.

Dit handmatig doen kost niet alleen tijd – het is ook waar bestanden stilletjes verdwijnen. Sla twee bijlagen met beide de naam report.csv op in dezelfde map zonder ze eerst te hernoemen, en de tweede opslag overschrijft de eerste; niemand merkt het tot de september‑cijfers nergens meer te vinden zijn. Een bericht met zelfs één bijlage in een formaat waarvoor niemand een converter heeft, kan de hele export stilleggen totdat iemand beslist wat ermee moet gebeuren.

De werkelijke kosten van handmatig doen: een hernoemde‑en‑overschreven bijlage geeft geen foutmelding – hij verdwijnt stilletjes, en het case‑bestand lijkt compleet totdat iemand de gegevens nodig heeft die erin zaten.

Er is een betere manier

GroupDocs.Conversion voor .NET maakt hiervan een paar regels code. Handmatig hernoemen is niet nodig. De EmailLoadOptions‑klasse bepaalt of het bericht, de bijlagen, of beide worden geconverteerd, en een SaveContext‑callback beschrijft elk uitvoeritem voldoende zodat twee bijlagen met de naam report.csv nooit botsen en een bijlage zonder PDF‑route de rest van de uitvoering niet stopt. Elke oproep van die callback rapporteert ItemIndex (een lopende teller beginnend bij 1), HierarchyLevel (0 voor het bericht, 1 voor een bijlage) en SourceFileName (de oorspronkelijke bestandsnaam), wat genoeg context biedt om een botsingsvrije uitvoernaam te bouwen zonder extra administratiecode.

Voordat we beginnen, heb je nodig:

  • .NET SDK 8.0 of later
  • GroupDocs.Conversion voor .NET 26.10.0 (verkrijg een tijdelijke licentie om evaluatielimieten te verwijderen)
  • Een Outlook‑.msg‑ of .eml‑bericht om te converteren

Installeer met één commando:

dotnet add package GroupDocs.Conversion --version 26.10.0

De nieuwe manier: een bericht en de bijlagen converteren

Zo ziet dezelfde taak eruit met GroupDocs.Conversion. Het onderstaande voorbeeld converteert een Outlook‑bericht en elke bijlage ervan naar een eigen PDF, met bestandsnamen die nooit botsen.

Stap 1 - Bepaal wat te converteren

EmailLoadOptions.ConvertOwner en ConvertOwned schakelen onafhankelijk het bericht en de bijlagen in of uit; Depth (standaard 2) beperkt hoe ver geneste bijlagen worden gevolgd.

// Converteer het bericht zelf en elke bijlage die het draagt
var loadOptions = new EmailLoadOptions
{
    ConvertOwner = true,
    ConvertOwned = true,
    Depth = 2
};

Stap 2 - Geef elke output een naam via SaveContext

Geef een SaveContext‑callback door aan Converter.Convert in plaats van een vaste uitvoerpad. De callback wordt één keer per item uitgevoerd, met ItemIndex uniek per item, zelfs wanneer twee bijlagen dezelfde bestandsnaam delen.

using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
    converter.Convert((SaveContext item) =>
    {
        // ItemIndex is 1 voor het bericht, daarna telt het op per bijlage
        string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
        return File.Create(Path.Combine(outputFolder, name));
    }, new PdfConvertOptions());
}

Stap 3 - Verwerk bijlagen zonder PDF‑route

Niet elke bijlage kan een PDF worden. Controleer SaveContext.TargetFormat tegen FileType.Unknown en sla dat ene item op onder zijn eigen naam in plaats van het te converteren.

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

Richt deze code op een voorbeeld‑support‑e‑mail met twee bijlagen die beide report.csv heten en één bijlage in een niet‑ondersteund formaat. Drie PDF’s komen eruit: het bericht en beide CSV‑rapporten. Het niet‑ondersteunde bestand komt ook uit, onaangeroerd – open het naast het origineel en al zijn 32 bytes op één lijn.

Hoe voorkom ik dat bijlagen met dezelfde bestandsnaam worden overschreven?

Een bestandsnaam op zichzelf kan geen veilige sleutel voor de output zijn, omdat twee bijlagen exact dezelfde naam kunnen hebben. Voeg SaveContext.ItemIndex toe aan de naam samen met SaveContext.SourceFileName, en twee bijlagen met de naam report.csv stoppen met concurreren om dezelfde plek op schijf; elk krijgt zijn eigen nul‑gevulde prefix (02- en 03- in het voorbeeld, na de 01- van het bericht) en zijn eigen bestand, ongeacht de naam die de bron gebruikte.

Zij aan zij: vóór vs. daarna

Vóór (Handmatig) Daarna (GroupDocs.Conversion)
Tijd Minuten per bericht, handmatig Een paar regels code, elk aantal berichten
Dubbele namen Stilletjes overschreven Gescheiden via ItemIndex
Niet‑ondersteunde bijlage Breekt de hele conversie (pre‑26.10) Opgeslagen onder eigen naam, uitvoering gaat door
Output Wat je PDF‑viewer ook kan opslaan Gestructureerde PDF’s die je kunt archiveren of indexeren

De voorbeeld‑support‑e‑mail is opgebouwd uit precies die mix: twee maandelijkse CSV‑exports met dezelfde naam, en één capture‑bestand dat geen converter herkent.

Voorbeeld uit de praktijk: archivering van supportcases

Een supportteam logt elke klantcase als een e‑mail met één of meer spreadsheet‑bijlagen, en het case‑tracking‑systeem heeft elke bijlage nodig als een eigen doorzoekbare PDF, los van het bericht. Het uitvoeren van KeepAttachmentsWithoutPdfRoute één keer per binnenkomende case zet het bericht en de bijlagen om in een genummerde set bestanden, zonder dat een bijlage ooit een andere overschrijft, zelfs wanneer twee rapporten dezelfde naam delen. Een case‑e‑mail met twee maandelijkse report.csv‑exports en één capture‑bestand in een formaat dat niemand converteert, levert vier bestanden op: het bericht, beide CSV‑rapporten als PDF’s, en het capture‑bestand opgeslagen onder zijn eigen naam – niets verloren, niets samengevoegd, niets stilletjes overschreven.

// Eén oproep per case‑e‑mail – geen handmatige export, geen hernoemde duplicaten
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);

Wat kun je nog meer doen met GroupDocs.Conversion voor .NET?

Naast het scheiden van een bericht van zijn bijlagen, dekt EmailLoadOptions meer van het bericht zelf:

  • Veldzichtbaarheid: toon of verberg de header en de regels From, To, Cc en Bcc met DisplayHeader en de gerelateerde Display*‑opties (Cc en Bcc zijn standaard verborgen).
  • Gelokaliseerde headers: koppel elk EmailField aan een andere caption met FieldTextMap, bijvoorbeeld om Subject en Attachments naar een andere taal te vertalen.
  • Datumnotatie: de Sent‑regel volgt de cultuur van de machine die de conversie uitvoert, en TimeZoneOffset stelt de UTC‑offset in die voor de berichtdatums wordt gebruikt.
  • Alleen‑bericht‑output: stel ConvertOwned in op false wanneer de PDF alleen het bericht moet vertegenwoordigen, met bijlagenamen nog steeds vermeld in de header ter referentie.

Zie de volledige EmailLoadOptions‑referentie voor elke optie.

Conclusie

Wat vroeger betekende: een bericht openen, bijlagen handmatig opslaan en opnieuw controleren op overschreven duplicaten, vereist nu een SaveContext‑callback en een paar regels code. GroupDocs.Conversion voor .NET geeft elk uitvoeritem – het bericht en elke bijlage – een naam die nooit botst, en bewaart een bijlage zonder PDF‑route in plaats van de uitvoering te laten falen. Dezelfde drie bouwblokken – ConvertOwner, ConvertOwned en de SaveContext‑callback – schalen van één samenvattende PDF tot een volledige, botsings‑veilige uitsplitsing van een bericht en elke bijlage die het draagt, zodat je klein kunt beginnen en kunt groeien naar de volledige workflow naarmate je inbox dat vereist.

Klaar om je e‑mail‑naar‑PDF‑workflow te automatiseren?

Aanvullende bronnen