💡 Pełny działający przykład dostępny na GitHubie:
convert-email-and-attachments-to-pdf-dotnet
Konwersja Email‑to‑PDF jest przepływem pracy GroupDocs.Conversion dla .NET, który przekształca wiadomość Outlook oraz jej załączniki w jeden lub więcej plików PDF, bez tego, aby jeden załącznik nadpisywał drugi lub aby nieobsługiwany plik przerywał cały proces. Zastępuje ręczną procedurę eksportu i zmiany nazwy kilkoma liniami kodu, które wiedzą, dla każdego elementu, skąd pochodzi i czy został w ogóle skonwertowany.
Stara metoda była bolesna
Wyobraź sobie skrzynkę wsparcia, w której każda wiadomość e‑mail zawiera dwa lub trzy załączniki – raport tutaj, zrzut ekranu tam, czasem plik w formacie, którego nikt w zespole nie rozpoznaje. Nic w tym nie jest niezwykłe. Zarchiwizowanie takiego zgłoszenia oznacza otwarcie wiadomości, ręczne zapisanie każdego załącznika, zmianę nazw tych, które kolidują, ponieważ dwa systemy wyeksportowały plik o nazwie report.csv, oraz liczenie na to, że żaden z elementów nie jest w formacie, którego Twój przeglądarka PDF nie potrafi otworzyć. Zrób to pięćdziesiąt razy w tygodniu, a „szybki eksport” stanie się najwolniejszą częścią pracy i najczęściej pośpiesznie wykonywaną, czyli właśnie wtedy, gdy pojawiają się błędy.
Robienie tego ręcznie nie kosztuje tylko czasu – to także miejsce, w którym pliki cicho znikają. Zapisz dwa załączniki o tej samej nazwie report.csv w tym samym folderze bez wcześniejszej zmiany nazw, a drugi zapis nadpisze pierwszy; nikt tego nie zauważy, dopóki we wrześniu nie braknie danych. Wiadomość z choćby jednym załącznikiem w formacie, dla którego nikt nie ma konwertera, może zatrzymać cały eksport, dopóki ktoś nie zdecyduje, co z nim zrobić.
Rzeczywisty koszt ręcznego wykonywania: załącznik, którego nazwa została zmieniona i nadpisany, nie generuje błędu – po prostu cicho znika, a plik zgłoszenia wygląda na kompletny, dopóki ktoś nie potrzebuje danych, które w nim były.
Jest lepszy sposób
GroupDocs.Conversion dla .NET zamienia to w kilka linii kodu. Nie ma potrzeby ręcznego zmieniania nazw. Klasa EmailLoadOptions kontroluje, czy wiadomość, załączniki lub oba elementy mają być konwertowane, a wywołanie zwrotne SaveContext opisuje każdy element wyjściowy na tyle szczegółowo, że dwa załączniki o nazwie report.csv nigdy nie kolidują, a załącznik bez ścieżki do PDF nie zatrzymuje reszty procesu. Każde wywołanie tego zwrotnego raportuje ItemIndex (licznik zaczynający się od 1), HierarchyLevel (0 dla wiadomości, 1 dla załącznika) oraz SourceFileName (pierwotna nazwa pliku), co wystarcza, aby zbudować nazwę wyjściową bez kolizji, nie zapisując dodatkowych danych pomocniczych.
Zanim zaczniemy, będziesz potrzebować:
- .NET SDK 8.0 lub nowszy
- GroupDocs.Conversion dla .NET 26.10.0 (get a temporary license aby usunąć ograniczenia wersji ewaluacyjnej)
- Wiadomość Outlook
.msglub.emldo konwersji
Instalacja jednym poleceniem:
dotnet add package GroupDocs.Conversion --version 26.10.0
Nowy sposób: konwersja wiadomości i jej załączników
Oto jak wygląda to samo zadanie przy użyciu GroupDocs.Conversion. Poniższy przykład konwertuje wiadomość Outlook oraz każdy jej załącznik do osobnego pliku PDF, przy czym nazwy plików nigdy nie kolidują.
Krok 1 – Zdecyduj, co konwertować
EmailLoadOptions.ConvertOwner i ConvertOwned niezależnie włączają lub wyłączają konwersję wiadomości i jej załączników; Depth (domyślnie 2) ogranicza, jak głęboko podążane są zagnieżdżone załączniki.
// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
Krok 2 – Nazwij każdy wynik z SaveContext
Przekaż wywołanie zwrotne SaveContext do Converter.Convert zamiast stałej ścieżki wyjściowej. Wywołanie zwrotne uruchamia się raz na element, a ItemIndex jest unikalny dla każdego elementu, nawet gdy dwa załączniki mają tę samą nazwę pliku.
using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
converter.Convert((SaveContext item) =>
{
// ItemIndex is 1 for the message, then counts up per attachment
string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());
}
Krok 3 – Obsłuż załączniki bez ścieżki PDF
Nie każdy załącznik może stać się PDF. Sprawdź SaveContext.TargetFormat względem FileType.Unknown i zapisz ten element pod własną nazwą zamiast go konwertować.
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());
Skieruj ten kod na przykładową wiadomość wsparcia z dwoma załącznikami o nazwie report.csv oraz jednym załącznikiem w nieobsługiwanym formacie. Uzyskasz trzy pliki PDF: wiadomość i oba raporty CSV. Nieobsługiwany plik również zostanie zapisany, nienaruszony – otwórz go obok oryginału i wszystkie 32 bajty będą się zgadzać.
Jak uniknąć nadpisywania załączników o tej samej nazwie pliku?
Nazwa pliku sama w sobie nie może służyć jako bezpieczny klucz wyjścia, ponieważ dwa załączniki mogą mieć dokładnie tę samą nazwę. Włącz SaveContext.ItemIndex do nazwy razem z SaveContext.SourceFileName, a dwa załączniki nazwane report.csv przestaną konkurować o to samo miejsce na dysku; każdy otrzyma własny prefiks z wiodącymi zerami (02- i 03- w przykładzie, po 01- wiadomości) oraz własny plik, niezależnie od nazwy źródłowej.
Porównanie: Przed vs. Po
| Przed (ręcznie) | Po (GroupDocs.Conversion) | |
|---|---|---|
| Czas | Minuty na wiadomość, ręcznie | Kilka linii kodu, dowolna liczba wiadomości |
| Nazwy duplikatów | Cicho nadpisane | Rozdzielone dzięki ItemIndex |
| Nieobsługiwany załącznik | Przerywa całą konwersję (przed 26.10) | Zapisany pod własną nazwą, proces trwa dalej |
| Wyjście | Cokolwiek potrafi zapisać przeglądarka PDF | Strukturalne PDF‑y, które można archiwizować lub indeksować |
Wiadomość wsparcia w przykładzie została zbudowana właśnie z takiego zestawu: dwa comiesięczne eksporty CSV o tej samej nazwie oraz jeden plik przechwytywania, którego żaden konwerter nie rozpoznaje.
Przykład z życia: Archiwizacja zgłoszeń wsparcia
Zespół wsparcia rejestruje każde zgłoszenie klienta jako e‑mail z jednym lub wieloma załącznikami arkuszy kalkulacyjnych, a system śledzenia zgłoszeń wymaga, aby każdy załącznik został zapisany jako osobny przeszukiwalny PDF, oddzielny od wiadomości. Przetworzenie wiadomości przy użyciu KeepAttachmentsWithoutPdfRoute raz na przychodzące zgłoszenie zamienia wiadomość i jej załączniki w numerowany zestaw plików, przy czym żaden załącznik nigdy nie nadpisuje innego, nawet gdy dwa raporty mają tę samą nazwę. E‑mail ze zgłoszeniem zawierający dwa comiesięczne eksporty report.csv oraz jeden plik przechwytywania w formacie, którego nikt nie konwertuje, zostaje zapisany jako cztery pliki: wiadomość, oba raporty CSV jako PDF oraz plik przechwytywania zapisany pod własną nazwą – nic nie zostaje utracone, nic nie zostaje scalone, nic nie zostaje cicho nadpisane.
// One call per case e‑mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
Co jeszcze możesz zrobić z GroupDocs.Conversion dla .NET?
Poza rozdzieleniem wiadomości od jej załączników, EmailLoadOptions obejmuje także dodatkowe elementy wiadomości:
- Widoczność pól: pokaż lub ukryj nagłówek oraz jego linie
From,To,CciBccprzy użyciuDisplayHeaderi powiązanych opcjiDisplay*(CciBccsą domyślnie ukryte). - Zlokalizowane nagłówki: mapuj każdy
EmailFieldna inny podpis przy pomocyFieldTextMap, np. tłumaczącSubjectiAttachmentsna inny język. - Formatowanie dat: linia
Sentużywa kultury maszyny, na której uruchamiana jest konwersja, aTimeZoneOffsetustawia przesunięcie UTC używane dla dat wiadomości. - Wyjście tylko wiadomości: ustaw
ConvertOwnednafalse, gdy PDF ma zastępować jedynie wiadomość, a nazwy załączników pozostaną wymienione w nagłówku jako odniesienie.
Zobacz pełną EmailLoadOptions reference dla wszystkich opcji.
Podsumowanie
To, co kiedyś oznaczało otwarcie wiadomości, ręczne zapisanie załączników i ponowne sprawdzenie pod kątem nadpisanych duplikatów, teraz wymaga wywołania zwrotnego SaveContext i kilku linii kodu. GroupDocs.Conversion dla .NET nadaje każdemu elementowi wyjściowemu – wiadomości i każdym załącznikowi – nazwę, która nigdy nie koliduje, i zachowuje załącznik bez ścieżki PDF zamiast przerywać proces. Te same trzy elementy budulcowe – ConvertOwner, ConvertOwned oraz wywołanie zwrotne SaveContext – skalują się od pojedynczego podsumowującego PDF‑a do pełnego, bezkolizyjnego podziału wiadomości i wszystkich jej załączników, dzięki czemu możesz zacząć od małego i rozwinąć pełny przepływ pracy w miarę rosnących potrzeb skrzynki odbiorczej.
Gotowy, aby zautomatyzować swój przepływ pracy Email‑to‑PDF?
- Try a free temporary license
- Zobacz konwersję każdego załącznika e‑mail do innego formatu wyjściowego
- Read the full EmailLoadOptions reference
- Check out the sample project on GitHub