💡 Exemplo completo em funcionamento disponível no GitHub:
convert-email-and-attachments-to-pdf-dotnet

A conversão de Email para PDF é um fluxo de trabalho do GroupDocs.Conversion para .NET que transforma uma mensagem do Outlook e seus anexos em um ou mais arquivos PDF sem que um anexo sobrescreva outro ou que um arquivo não suportado interrompa toda a execução. Ele substitui uma rotina manual de exportação e renomeação por algumas linhas de código que sabem, para cada item, de onde ele veio e se foi convertido ou não.

O Antigo Método Era Doloroso

Imagine uma caixa de entrada de suporte onde cada e‑mail de caso traz dois ou três anexos – um relatório aqui, uma captura de tela ali, às vezes um formato de arquivo que ninguém da equipe reconhece. Nada disso é incomum. Arquivar esse caso significa abrir a mensagem, salvar cada anexo manualmente, renomear os que colidem porque dois sistemas exportaram um arquivo chamado report.csv, e torcer para que nada no conjunto seja um formato que seu visualizador de PDF não consiga abrir. Faça isso cinquenta vezes por semana e a “exportação rápida” se torna a parte mais lenta do trabalho, e a parte mais propensa a ser feita às pressas, exatamente quando os erros acontecem.

Fazer isso manualmente não custa apenas tempo – é também onde os arquivos desaparecem silenciosamente. Salve dois anexos ambos nomeados report.csv na mesma pasta sem renomeá‑los primeiro, e o segundo salvamento sobrescreve o primeiro; ninguém percebe até que os números de setembro desapareçam. Uma mensagem com até um anexo em um formato que ninguém tem conversor pode travar toda a exportação até que alguém decida o que fazer com ele.

O custo real de fazer isso manualmente: um anexo renomeado e sobrescrito não gera erro – ele simplesmente desaparece silenciosamente, e o arquivo do caso parece completo até que alguém precise dos dados que estavam nele.

Existe um Caminho Melhor

GroupDocs.Conversion para .NET transforma isso em algumas linhas de código. Nenhum renomeio manual é necessário. Sua classe EmailLoadOptions controla se a mensagem, os anexos ou ambos são convertidos, e um callback SaveContext descreve cada item de saída suficientemente bem para que dois anexos nomeados report.csv nunca colidam e um anexo sem rota para PDF nunca interrompa o restante da execução. Cada chamada a esse callback relata ItemIndex (uma contagem crescente a partir de 1), HierarchyLevel (0 para a mensagem, 1 para um anexo) e SourceFileName (o nome original do arquivo), o que é contexto suficiente para gerar um nome de saída livre de colisões sem escrever nenhuma contabilidade extra.

Antes de começar, você precisará:

  • .NET SDK 8.0 ou posterior
  • GroupDocs.Conversion para .NET 26.10.0 (obtenha uma licença temporária para remover limites de avaliação)
  • Uma mensagem Outlook .msg ou .eml para converter

Instale com um único comando:

dotnet add package GroupDocs.Conversion --version 26.10.0

O Novo Caminho: Convertendo uma Mensagem e Seus Anexos

Veja como a mesma tarefa fica com GroupDocs.Conversion. O exemplo a seguir converte uma mensagem do Outlook e cada um de seus anexos em seu próprio PDF, com nomes de arquivo que nunca colidem.

Etapa 1 – Decidir o Que Converter

EmailLoadOptions.ConvertOwner e ConvertOwned alternam independentemente a mensagem e seus anexos; Depth (padrão 2) limita até onde os anexos aninhados são seguidos.

// Converte a própria mensagem e cada anexo que ela contém
var loadOptions = new EmailLoadOptions
{
    ConvertOwner = true,
    ConvertOwned = true,
    Depth = 2
};

Etapa 2 – Nomear Cada Saída a Partir de SaveContext

Passe um callback SaveContext para Converter.Convert em vez de um caminho de saída fixo. O callback é disparado uma vez por item, com ItemIndex único por item mesmo quando dois anexos compartilham o mesmo nome de arquivo.

using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
    converter.Convert((SaveContext item) =>
    {
        // ItemIndex é 1 para a mensagem, depois conta por anexo
        string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
        return File.Create(Path.Combine(outputFolder, name));
    }, new PdfConvertOptions());
}

Etapa 3 – Tratar Anexos Sem Rota para PDF

Nem todo anexo pode se tornar um PDF. Verifique SaveContext.TargetFormat contra FileType.Unknown e salve esse item com seu próprio nome em vez de convertê‑lo.

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

Aponte esse código para um e‑mail de suporte de exemplo com dois anexos ambos nomeados report.csv e um anexo em formato não suportado. Três PDFs são gerados: a mensagem e ambos os relatórios CSV. O arquivo não suportado também é gerado, intocado – abra‑o ao lado do original e cada um de seus 32 bytes se alinha.

Como evitar sobrescrever anexos que compartilham o mesmo nome de arquivo?

Um nome de arquivo por si só não pode servir como chave segura para a saída, porque dois anexos podem ter exatamente o mesmo nome. Incorpore SaveContext.ItemIndex ao nome junto com SaveContext.SourceFileName, e dois anexos nomeados report.csv deixam de competir pela mesma posição no disco; cada um recebe seu próprio prefixo preenchido com zeros (02- e 03- no exemplo, após o 01- da mensagem) e seu próprio arquivo, independentemente do nome usado na origem.

Lado a Lado: Antes vs. Depois

Antes (Manual) Depois (GroupDocs.Conversion)
Tempo Minutos por mensagem, manualmente Algumas linhas de código, qualquer número de mensagens
Nomes duplicados Sobrescritos silenciosamente Mantidos separados via ItemIndex
Anexo não suportado Interrompe toda a conversão (pré‑26.10) Salvo com seu próprio nome, a execução continua
Saída O que seu visualizador de PDF conseguir salvar PDFs estruturados que você pode arquivar ou indexar

O e‑mail de suporte do exemplo foi construído exatamente a partir dessa mistura: duas exportações mensais de CSV com o mesmo nome e um arquivo de captura que nenhum conversor reconhece.

Exemplo Real: Arquivamento de Casos de Suporte

Uma equipe de suporte registra cada caso de cliente como um e‑mail com um ou mais anexos de planilha, e o sistema de rastreamento de casos precisa que cada anexo seja arquivado como seu próprio PDF pesquisável, separado da mensagem. Executar a mensagem através de KeepAttachmentsWithoutPdfRoute uma vez por caso recebido transforma a mensagem e seus anexos em um conjunto numerado de arquivos, sem que nenhum anexo sobrescreva outro mesmo quando dois relatórios compartilham o mesmo nome. Um e‑mail de caso com duas exportações mensais report.csv e um arquivo de captura em formato que ninguém converte resulta em quatro arquivos: a mensagem, ambos os relatórios CSV como PDFs, e o arquivo de captura salvo com seu próprio nome – nada foi descartado, nada foi mesclado, nada sobrescrito silenciosamente.

// Uma chamada por e‑mail de caso – sem exportação manual, sem duplicatas renomeadas
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);

O Que Mais Você Pode Fazer com GroupDocs.Conversion para .NET?

Além de separar a mensagem dos anexos, EmailLoadOptions cobre mais aspectos da própria mensagem:

  • Visibilidade de campos: mostre ou oculte o cabeçalho e suas linhas From, To, Cc e Bcc com DisplayHeader e as opções relacionadas Display* (Cc e Bcc são ocultados por padrão).
  • Cabeçalhos localizados: mapeie cada EmailField para uma legenda diferente com FieldTextMap, por exemplo traduzindo Subject e Attachments para outro idioma.
  • Formatação de data: a linha Sent segue a cultura da máquina que executa a conversão, e TimeZoneOffset define o deslocamento UTC usado para as datas da mensagem.
  • Saída apenas da mensagem: defina ConvertOwned como false quando o PDF precisar representar apenas a mensagem, mantendo os nomes dos anexos listados no cabeçalho para referência.

Consulte a referência completa de EmailLoadOptions para todas as opções.

Conclusão

O que antes significava abrir uma mensagem, salvar anexos manualmente e rever duplicatas sobrescritas agora se resume a um callback SaveContext e algumas linhas de código. GroupDocs.Conversion para .NET fornece a cada item de saída – a mensagem e cada anexo – um nome que nunca colide, e mantém um anexo sem rota para PDF em vez de falhar a execução. Os mesmos três blocos de construção – ConvertOwner, ConvertOwned e o callback SaveContext – escalam de um único PDF resumido até uma divisão completa e livre de colisões de uma mensagem e todos os seus anexos, permitindo que você comece pequeno e evolua para o fluxo completo conforme sua caixa de entrada exigir.

Pronto para automatizar seu fluxo de trabalho de e‑mail para PDF?

Recursos Adicionais