Wie man mit IronPDF eine generierte PDF-Datei als Anhang in einer E-Mail von C# aus versendet

Welche Werkzeuge werden für die PDF-Erstellung und den E-Mail-Versand in C# benötigt?

Zwei Komponenten machen diesen Arbeitsablauf möglich: eine Bibliothek zur PDF-Erzeugung und ein Mechanismus zum Versenden von E-Mails. IronPDF übernimmt die Erstellung von PDF-Dokumenten aus HTML-Inhalten, während .NET E-Mail-Funktionen über System.Net.Mail oder die moderne MailKit-Bibliothek unterstützt.

Installieren Sie das IronPDF NuGet-Paket über den Projektmappen-Explorer von Visual Studio oder die Paketmanager-Konsole:

Install-Package IronPdf

Für moderne E-Mail-Funktionen installieren Sie MailKit:

Install-Package MailKit

IronPDF verwendet eine Chromium-basierte Rendering-Engine, die pixelgenaue PDFs aus HTML, CSS und JavaScript erzeugt. Die Bibliothek funktioniert in allen Windows-, Linux- und macOS-Umgebungen, und .NET Core-Anwendungen profitieren von der plattformübergreifenden Kompatibilität.

Wie können Entwickler mit C# ein PDF im Speicher erzeugen?

Die ChromePdfRenderer Klasse konvertiert HTML Inhalte in PDF Dokumente. Anstatt die PDF-Datei auf der Festplatte zu speichern, bietet das resultierende PdfDocument-Objekt über seine BinaryData-Eigenschaft oder über einen neuen MemoryStream über seine Stream-Eigenschaft direkten Zugriff auf die Binärdaten.

using IronPdf;
// Create a new instance of the renderer
var renderer = new ChromePdfRenderer();
// Generate PDF document from HTML content
string htmlContent = @"
    <h1>Order Confirmation</h1>
    <p>Thank you for your purchase.</p>
    <p>Order Total: $99.99</p>";
PdfDocument PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Access PDF as byte array for file attachment
byte[] pdfBytes = pdf.BinaryData;

using IronPdf;
// Create a new instance of the renderer
var renderer = new ChromePdfRenderer();
// Generate PDF document from HTML content
string htmlContent = @"
    <h1>Order Confirmation</h1>
    <p>Thank you for your purchase.</p>
    <p>Order Total: $99.99</p>";
PdfDocument PDF = renderer.RenderHtmlAsPdf(htmlContent);
// Access PDF as byte array for file attachment
byte[] pdfBytes = pdf.BinaryData;

IRON VB CONVERTER ERROR developers@ironsoftware.com

Die Methode RenderHtmlAsPdf akzeptiert einen HTML-String und gibt ein vollständig gerendertes PDF-Dokument zurück. Die BinaryData-Eigenschaft stellt den PDF-Inhalt als Byte-Array zur Verfügung, was genau das Format ist, das für das Hinzufügen von Anhängen zu einer E-Mail-Nachricht benötigt wird. Bei diesem Ansatz werden Dateisystemoperationen vollständig vermieden, da die PDF-Datei während des gesamten Prozesses von der Erstellung bis zur Auslieferung im Speicher verbleibt, wie im folgenden Screenshot zu sehen ist.

Wie wird eine In-Memory-PDF-Datei an eine E-Mail-Nachricht angehängt?

MailKit bietet einen modernen, von Microsoft empfohlenen Ansatz für den Versand von E-Mails in .NET-Anwendungen und Webanwendungen. Die BodyBuilder-Klasse verarbeitet Anhänge, indem sie Byte-Arrays direkt akzeptiert, was die Integration mit IronPDF einfach macht.

using IronPdf;
using MailKit.Net.Smtp;
using MailKit.Security;
using MimeKit;
// Generate PDF document with IronPDF
var renderer = new ChromePdfRenderer();
string HTML = "<h1>Monthly Report</h1><p>Generated automatically.</p>";
PdfDocument PDF = renderer.RenderHtmlAsPdf(html);
// Build new email message
var message = new MimeMessage();
message.From.Add(new MailboxAddress("Sender", "sender@example.com"));
message.To.Add(new MailboxAddress("Recipient", "recipient@example.com"));
message.Subject = "Your Report is Ready";
// Create body with PDF attachment
var builder = new BodyBuilder();
builder.TextBody = "Please find your report attached.";
builder.Attachments.Add("Report.pdf", pdf.BinaryData, new ContentType("application", "pdf"));
message.Body = builder.ToMessageBody();
// Send email via SMTP server
using var client = new SmtpClient();
await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls);
await client.AuthenticateAsync("username", "password");
await client.SendAsync(message);
await client.DisconnectAsync(true);

using IronPdf;
using MailKit.Net.Smtp;
using MailKit.Security;
using MimeKit;
// Generate PDF document with IronPDF
var renderer = new ChromePdfRenderer();
string HTML = "<h1>Monthly Report</h1><p>Generated automatically.</p>";
PdfDocument PDF = renderer.RenderHtmlAsPdf(html);
// Build new email message
var message = new MimeMessage();
message.From.Add(new MailboxAddress("Sender", "sender@example.com"));
message.To.Add(new MailboxAddress("Recipient", "recipient@example.com"));
message.Subject = "Your Report is Ready";
// Create body with PDF attachment
var builder = new BodyBuilder();
builder.TextBody = "Please find your report attached.";
builder.Attachments.Add("Report.pdf", pdf.BinaryData, new ContentType("application", "pdf"));
message.Body = builder.ToMessageBody();
// Send email via SMTP server
using var client = new SmtpClient();
await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls);
await client.AuthenticateAsync("username", "password");
await client.SendAsync(message);
await client.DisconnectAsync(true);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Mit diesem Codebeispiel wird ein vollständiges Arbeitsbeispiel für den PDF-zu-E-Mail-Workflow in einem einzigen Vorgang erstellt. Die Methode BodyBuilder.Attachments.Add akzeptiert drei Parameter: den Dateinamen, den der Empfänger sieht, das PDF-Byte-Array von IronPDF und den MIME-Typ, der das Format des Anhangs als application/pdf angibt. Die asynchronen Methoden stellen sicher, dass der Vorgang den aufrufenden Thread nicht blockiert, was für Webanwendungen, die mehrere gleichzeitige Anfragen verarbeiten, unerlässlich ist.

Der Parameter SecureSocketOptions.StartTls ermöglicht die verschlüsselte Kommunikation mit der SMTP-Serveradresse und schützt so die Anmeldedaten und den Inhalt der E-Mail während der Übertragung. Ersetzen Sie die Platzhalter für die SMTP-Client-Einstellungen durch die Konfigurationswerte Ihres E-Mail-Anbieters. Beachten Sie, dass Dienste wie Gmail ein App-Passwort für die SMTP-Authentifizierung erfordern.

Wie kann System.Net.Mail als Alternative für Dateianhänge verwendet werden?

Für Projekte, die ältere .NET-Versionen verwenden oder nur minimale Abhängigkeiten benötigen, bietet System.Net.Mail integrierte E-Mail-Funktionen. Obwohl Microsoft MailKit für Neuentwicklungen empfiehlt, ist dieser Ansatz auch für einfachere Szenarien praktikabel. Der folgende Code demonstriert ein komplettes Arbeitsbeispiel unter Verwendung des SmtpClient-Clients und der MailMessage-Klassen.

using IronPdf;
using System.Net;
using System.Net.Mail;
// Generate PDF document
var renderer = new ChromePdfRenderer();
PdfDocument PDF = renderer.RenderHtmlAsPdf("<h1>Invoice #1001</h1>");
// Create new MailMessage with attachment
using var message = new MailMessage("sender@example.com", "recipient@example.com");
message.Subject = "Invoice Attached";
message.Body = "Your invoice is attached to this email.";
// Attach PDF file from new MemoryStream
var stream = new MemoryStream(pdf.BinaryData);
message.Attachments.Add(new Attachment(stream, "Invoice.pdf", "application/pdf"));
// Send email via SMTP server
using var client = new SmtpClient("smtp.example.com", 587);
client.Credentials = new NetworkCredential("username", "password");
client.EnableSsl = true;
await client.SendMailAsync(message);

using IronPdf;
using System.Net;
using System.Net.Mail;
// Generate PDF document
var renderer = new ChromePdfRenderer();
PdfDocument PDF = renderer.RenderHtmlAsPdf("<h1>Invoice #1001</h1>");
// Create new MailMessage with attachment
using var message = new MailMessage("sender@example.com", "recipient@example.com");
message.Subject = "Invoice Attached";
message.Body = "Your invoice is attached to this email.";
// Attach PDF file from new MemoryStream
var stream = new MemoryStream(pdf.BinaryData);
message.Attachments.Add(new Attachment(stream, "Invoice.pdf", "application/pdf"));
// Send email via SMTP server
using var client = new SmtpClient("smtp.example.com", 587);
client.Credentials = new NetworkCredential("username", "password");
client.EnableSsl = true;
await client.SendMailAsync(message);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Der Hauptunterschied besteht darin, dass ein neuer MemoryStream aus dem Byte-Array erstellt wird, bevor die PDF-Datei angehängt wird. Der Konstruktor der Klasse Attachment akzeptiert einen Stream, einen Dateinamen und einen MIME-Typ als Parameter. Sowohl MailMessage als auch SmtpClient sind in using-Anweisungen verpackt, um die ordnungsgemäße Entsorgung der Ressourcen nach Abschluss des Sendevorgangs sicherzustellen. Die Methode message.Attachments.Add erstellt ein neues Anhangsobjekt aus dem Stream.

Was sind praktische Anwendungen für PDF-E-Mail-Anhänge?

Dieses Muster für die PDF-Erzeugung und den E-Mail-Versand unterstützt zahlreiche Geschäftsszenarien. Die Rechnungsautomatisierung sendet Kaufbestätigungen sofort nach Abschluss der Transaktionen. Die Verteilung von Berichten liefert geplante Analysen an die Beteiligten ohne manuelle Eingriffe. Durch die Erstellung von Quittungen erhalten die Kunden eine sofortige Dokumentation ihrer Einkäufe. Jeder Anwendungsfall profitiert von der Möglichkeit, ein PDF-Dokument zu erstellen und es automatisch als Anhang zu versenden.

Der In-Memory-Ansatz bietet Vorteile gegenüber dateibasierten Alternativen. Die Anwendungen vermeiden E/A-Overhead auf der Festplatte und müssen keine temporären Dateien mehr bereinigen. Bei stark frequentierten Webanwendungen ist diese Effizienz besonders wertvoll.

Die Rendering-Optionen von IronPDF ermöglichen die Anpassung von Rändern, Kopf- und Fußzeilen sowie der Seitengröße. Die Entwickler können professionelle Dokumente erstellen, die sich für die Kommunikation mit dem Kunden eignen und neben dem PDF-Anhang auch einfachen Text oder HTML-formatierte E-Mail-Inhalte enthalten.

Abschluss

Durch die Kombination von IronPDF mit C#-E-Mail-Bibliotheken entsteht ein effizienter Arbeitsablauf für die automatische Zustellung von Dokumenten. Die BinaryData-Eigenschaft von IronPDF bietet direkten Zugriff auf PDF-Inhalte als Byte-Array, während MailKit oder System.Net.Mail die E-Mail-Übertragung nahtlos abwickeln. Dieser Ansatz sorgt für eine effiziente Arbeitsweise, indem unnötige Interaktionen mit dem Dateisystem vermieden werden.

Das Muster reicht von einfachen Benachrichtigungs-E-Mails bis hin zu komplexen Dokumentenautomatisierungssystemen. Ob beim Aufbau von Rechnungssystemen, Berichtsgeneratoren oder Tools für die Kundenkommunikation - dieser speicherinterne PDF-zu-E-Mail-Workflow bietet eine solide Grundlage. Der vollständige Arbeitsbeispielcode kann heruntergeladen und für spezifische Projektanforderungen angepasst werden.

Starten Sie eine kostenlose Testversion, um die PDF-Erzeugungsfunktionen von IronPDF kennenzulernen, oder sehen Sie sich die Lizenzierungsoptionen für den Produktionseinsatz an.