Comment envoyer un fichier PDF généré en tant que pièce jointe dans un courriel à partir de C# à l'aide d'IronPDF

Quels sont les outils nécessaires à la génération de PDF et à l'envoi de courriels en C#;?

Deux composants rendent ce flux de travail possible : une bibliothèque de génération de PDF et un mécanisme d'envoi d'e-mails. IronPDF gère la création de documents PDF à partir de contenu HTML, tandis que .NET prend en charge les fonctionnalités de messagerie électronique par le biais de System.Net.Mail ou de la bibliothèque moderne MailKit.

Installez le package NuGet IronPDF via l'explorateur de solutions de Visual Studio ou la console du gestionnaire de packages :

Install-Package IronPdf

Comment envoyer un fichier PDF généré en tant que pièce jointe dans un e-mail depuis C# à l'aide d'IronPDF : Image 2 - Installation

Pour une fonctionnalité de messagerie moderne, installez MailKit :

Install-Package MailKit

IronPDF utilise un moteur de rendu basé sur Chromium qui produit des PDF parfaits au pixel près à partir de HTML, CSS et JavaScript. La bibliothèque fonctionne dans les environnements Windows, Linux et macOS, et les applications .NET Core bénéficient d'une compatibilité multiplateforme.

Comment envoyer un fichier PDF généré en tant que pièce jointe dans un e-mail depuis C# à l'aide d'IronPDF : Image 3 - Caractéristiques

Comment les développeurs peuvent-ils générer un PDF en mémoire à l'aide de C#?

La classe ChromePdfRenderer convertit le contenu HTML en documents PDF. Plutôt que d'enregistrer le fichier PDF sur le disque, l'objet PdfDocument résultant fournit un accès direct aux données binaires via sa propriété BinaryData ou via un nouveau MemoryStream via sa propriété Stream.

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;

Imports IronPdf

' Create a new instance of the renderer
Dim renderer As New ChromePdfRenderer()

' Generate PDF document from HTML content
Dim htmlContent As String = "
    <h1>Order Confirmation</h1>
    <p>Thank you for your purchase.</p>
    <p>Order Total: $99.99</p>"
Dim PDF As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

' Access PDF as byte array for file attachment
Dim pdfBytes As Byte() = PDF.BinaryData

La méthode RenderHtmlAsPdf accepte une chaîne HTML et renvoie un document PDF entièrement rendu. La propriété BinaryData fournit le contenu du PDF sous la forme d'un tableau d'octets, qui est le format exact nécessaire pour ajouter des pièces jointes à un message électronique. Cette approche permet d'éviter complètement les opérations du système de fichiers, en conservant le fichier PDF en mémoire tout au long du processus, de la génération à la livraison, comme le montre la capture d'écran suivante.

Comment un PDF en mémoire est-il joint à un message électronique ?

MailKit fournit une approche moderne, recommandée par Microsoft, pour l'envoi d'e-mails dans les applications .NET et les applications web. La classe BodyBuilder gère les pièces jointes en acceptant directement les tableaux d'octets, ce qui rend l'intégration avec IronPDF simple.

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

Imports IronPdf
Imports MailKit.Net.Smtp
Imports MailKit.Security
Imports MimeKit

' Generate PDF document with IronPDF
Dim renderer As New ChromePdfRenderer()
Dim HTML As String = "<h1>Monthly Report</h1><p>Generated automatically.</p>"
Dim PDF As PdfDocument = renderer.RenderHtmlAsPdf(HTML)

' Build new email message
Dim message As 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
Dim builder As 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 client As New SmtpClient()
    Await client.ConnectAsync("smtp.example.com", 587, SecureSocketOptions.StartTls)
    Await client.AuthenticateAsync("username", "password")
    Await client.SendAsync(message)
    Await client.DisconnectAsync(True)
End Using

Cet exemple de code crée un exemple de travail complet du flux de travail PDF-to-email en une seule opération. La méthode BodyBuilder.Attachments.Add accepte trois paramètres : le nom du fichier que les destinataires verront, le tableau d'octets PDF provenant d'IronPDF et le type MIME spécifiant le format de la pièce jointe comme application/pdf. Les méthodes asynchrones garantissent que l'opération ne bloque pas le thread appelant, ce qui est essentiel pour les applications web gérant plusieurs requêtes simultanées.

Le paramètre SecureSocketOptions.StartTls permet une communication cryptée avec l'adresse du serveur SMTP, protégeant ainsi les informations d'identification et le contenu du corps du message pendant la transmission. Remplacez les paramètres du client SMTP par les valeurs de configuration de votre fournisseur de messagerie. Notez que des services comme Gmail nécessitent un mot de passe d'application pour l'authentification SMTP.

Comment envoyer un fichier PDF généré en tant que pièce jointe dans un e-mail depuis C# à l'aide d'IronPDF : Image 6 - Compatibilité multiplateforme

Comment System.Net.Mail peut-il être utilisé comme alternative à l'attachement de fichiers ?

Pour les projets utilisant des versions .NET plus anciennes ou nécessitant des dépendances minimales, System.Net.Mail fournit une fonctionnalité de courrier électronique intégrée. Bien que Microsoft recommande MailKit pour les nouveaux développements, cette approche reste viable pour les scénarios plus simples. Le code suivant présente un exemple de travail complet utilisant les classes SmtpClient client et MailMessage.

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

Imports IronPdf
Imports System.Net
Imports System.Net.Mail
Imports System.IO

' Generate PDF document
Dim renderer As New ChromePdfRenderer()
Dim PDF As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Invoice #1001</h1>")

' Create new MailMessage with attachment
Using message As 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
    Dim stream As New MemoryStream(PDF.BinaryData)
    message.Attachments.Add(New Attachment(stream, "Invoice.pdf", "application/pdf"))

    ' Send email via SMTP server
    Using client As New SmtpClient("smtp.example.com", 587)
        client.Credentials = New NetworkCredential("username", "password")
        client.EnableSsl = True
        Await client.SendMailAsync(message)
    End Using
End Using

La principale différence consiste à créer un nouveau MemoryStream à partir du tableau d'octets avant d'attacher le fichier PDF. Le constructeur de la classe Attachment accepte un flux, un nom de fichier et un type MIME comme paramètres. Le MailMessage et le SmtpClient sont tous deux enveloppés dans des instructions using afin de garantir l'élimination correcte des ressources une fois l'envoi terminé. La méthode message.Attachments.Add crée un nouvel objet pièce jointe à partir du flux.

Quelles sont les applications pratiques des pièces jointes PDF pour les courriels ?

Ce modèle de génération de PDF et d'envoi d'e-mails prend en charge de nombreux scénarios commerciaux. L'automatisation des factures envoie des confirmations d'achat immédiatement après la fin des transactions. La distribution de rapports fournit des analyses planifiées aux parties prenantes sans intervention manuelle. La génération de reçus fournit aux clients une documentation instantanée de leurs achats. Chaque cas d'utilisation bénéficie de la possibilité de créer un document PDF et de l'envoyer automatiquement en pièce jointe.

L'approche en mémoire offre des avantages par rapport aux solutions basées sur les fichiers. Les applications évitent les surcharges d'E/S sur disque et éliminent les besoins de nettoyage des fichiers temporaires. Cette efficacité est particulièrement précieuse pour les applications web à fort trafic.

Les options de rendu d'IronPDF permettent de personnaliser les marges, les en-têtes, les pieds de page et la taille des pages. Les développeurs peuvent créer des documents professionnels adaptés aux communications avec les clients, y compris le contenu du corps de l'e-mail en texte brut ou au format HTML, parallèlement à la pièce jointe au PDF.

Conclusion

La combinaison d'IronPDF et de bibliothèques de messagerie C# permet de créer un flux de travail efficace pour l'envoi automatisé de documents. La propriété BinaryData d'IronPDF permet d'accéder directement au contenu d'un PDF sous la forme d'un tableau d'octets, tandis que MailKit ou System.Net.Mail gèrent la transmission des courriels de manière transparente. Cette approche permet d'assurer l'efficacité des opérations en évitant les interactions inutiles avec le système de fichiers.

Le modèle va de simples courriels de notification à des systèmes complexes d'automatisation de documents. Qu'il s'agisse de créer des systèmes de facturation, des générateurs de rapports ou des outils de communication avec les clients, ce flux de travail PDF-to-email en mémoire constitue une base solide. Le code d'exemple complet peut être téléchargé et adapté aux besoins spécifiques du projet.

Démarrez un essai gratuit pour explorer les capacités de génération de PDF d'IronPDF, ou voyez les options de licence pour un déploiement en production.

Comment envoyer un fichier PDF généré en tant que pièce jointe dans un e-mail depuis C# à l'aide d'IronPDF : Image 8 - Licence