Conversion de Word en PDF avec ASP.NET - Convertir un fichier DOCX en PDF en C#

Comment installer IronPDF dans un projet ASP.NET ?

Ouvrez la console du gestionnaire de packages dans Visual Studio et exécutez la commande suivante pour installer IronPDF:

Install-Package IronPdf
dotnet add package IronPdf

Install-Package IronPdf
dotnet add package IronPdf

Une fois le package installé, ajoutez une directive using IronPdf; à vos fichiers C#. IronPDF cible .NET 8 et versions ultérieures, ce qui le rend compatible avec ASP.NET Core, ASP.NET Framework 4.6.2+ et les projets de services de travail modernes. Aucun composant d'exécution supplémentaire ni licence Microsoft Office n'est requis.

Avant de lancer l'application en production, définissez votre clé de licence une seule fois au démarrage de l'application -- par exemple en haut de Program.cs. Vous pouvez lire la clé à partir de appsettings.json pour empêcher les informations d'identification d'être incluses dans le contrôle de version : IronPdf.License.LicenseKey = configuration["IronPdf:LicenseKey"]!;.

Comment convertir un document Word en PDF en C# ?

La classe DocxToPdfRenderer est le point d'entrée de toutes les conversions Word vers PDF. Il accepte un chemin de fichier, un tableau d'octets ou un Stream, et renvoie un objet PdfDocument que vous pouvez enregistrer, chiffrer, fusionner ou servir directement via HTTP.

Voici la conversion la plus simple possible :

using IronPdf;

// Set license key before first use
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("report.docx");
pdf.SaveAs("report.pdf");

using IronPdf;

// Set license key before first use
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("report.docx");
pdf.SaveAs("report.pdf");

Imports IronPdf

' Set license key before first use
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim pdf = renderer.RenderDocxAsPdf("report.docx")
pdf.SaveAs("report.pdf")

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using var docxStream = new FileStream("document.docx", FileMode.Open);
var renderer = new DocxToPdfRenderer();
var pdfDocument = renderer.RenderDocxAsPdf(docxStream);
pdfDocument.SaveAs("output.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

using var docxStream = new FileStream("document.docx", FileMode.Open);
var renderer = new DocxToPdfRenderer();
var pdfDocument = renderer.RenderDocxAsPdf(docxStream);
pdfDocument.SaveAs("output.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Using docxStream As New FileStream("document.docx", FileMode.Open)
    Dim renderer As New DocxToPdfRenderer()
    Dim pdfDocument = renderer.RenderDocxAsPdf(docxStream)
    pdfDocument.SaveAs("output.pdf")
End Using

Comment convertir plusieurs fichiers DOCX par lots ?

Lorsque vous devez traiter un dossier entier de documents, parcourez les fichiers et réutilisez une seule instance DocxToPdfRenderer. La réutilisation du moteur de rendu évite les surcharges liées à l'initialisation répétée :

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
string[] docxFiles = Directory.GetFiles(@"C:\WordDocuments", "*.docx");

foreach (string docxFile in docxFiles)
{
    var pdf = renderer.RenderDocxAsPdf(docxFile);
    string pdfPath = Path.ChangeExtension(docxFile, ".pdf");
    pdf.SaveAs(pdfPath);
    Console.WriteLine($"Converted: {Path.GetFileName(pdfPath)}");
}

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
string[] docxFiles = Directory.GetFiles(@"C:\WordDocuments", "*.docx");

foreach (string docxFile in docxFiles)
{
    var pdf = renderer.RenderDocxAsPdf(docxFile);
    string pdfPath = Path.ChangeExtension(docxFile, ".pdf");
    pdf.SaveAs(pdfPath);
    Console.WriteLine($"Converted: {Path.GetFileName(pdfPath)}");
}

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim docxFiles As String() = Directory.GetFiles("C:\WordDocuments", "*.docx")

For Each docxFile As String In docxFiles
    Dim pdf = renderer.RenderDocxAsPdf(docxFile)
    Dim pdfPath As String = Path.ChangeExtension(docxFile, ".pdf")
    pdf.SaveAs(pdfPath)
    Console.WriteLine($"Converted: {Path.GetFileName(pdfPath)}")
Next

Comment utiliser la fusion et le publipostage pour générer des PDF personnalisés ?

La fonction de publipostage vous permet de définir un modèle DOCX avec des espaces réservés, puis de les remplir avec des données lors de l'exécution. Ce procédé est idéal pour les factures, les contrats, les certificats et tout document dont la structure est fixe mais dont le contenu varie selon le destinataire.

IronPDF accepte une source de données personnalisée via la propriété MailMergeDataSource :

using IronPdf;
using System.Data;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Build the data source
var data = new DataTable();
data.Columns.Add("CustomerName");
data.Columns.Add("InvoiceNumber");
data.Columns.Add("TotalAmount");
data.Rows.Add("Acme Corp", "INV-2026-001", "$4,500.00");

var renderer = new DocxToPdfRenderer();
renderer.MailMergeDataSource = data;

var pdf = renderer.RenderDocxAsPdf("invoice_template.docx");
pdf.SaveAs("acme_invoice.pdf");

using IronPdf;
using System.Data;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

// Build the data source
var data = new DataTable();
data.Columns.Add("CustomerName");
data.Columns.Add("InvoiceNumber");
data.Columns.Add("TotalAmount");
data.Rows.Add("Acme Corp", "INV-2026-001", "$4,500.00");

var renderer = new DocxToPdfRenderer();
renderer.MailMergeDataSource = data;

var pdf = renderer.RenderDocxAsPdf("invoice_template.docx");
pdf.SaveAs("acme_invoice.pdf");

Imports IronPdf
Imports System.Data

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

' Build the data source
Dim data As New DataTable()
data.Columns.Add("CustomerName")
data.Columns.Add("InvoiceNumber")
data.Columns.Add("TotalAmount")
data.Rows.Add("Acme Corp", "INV-2026-001", "$4,500.00")

Dim renderer As New DocxToPdfRenderer()
renderer.MailMergeDataSource = data

Dim pdf = renderer.RenderDocxAsPdf("invoice_template.docx")
pdf.SaveAs("acme_invoice.pdf")

Dans le modèle DOCX, entourez chaque nom de champ de doubles chevrons (par exemple, <<CustomerName>>) pour marquer les champs de fusion. Lors de la conversion, IronPDF remplace chaque espace réservé par la valeur de colonne correspondante de la source de données. Vous pouvez en apprendre davantage sur les modèles d'automatisation des documents dans la documentation de publipostage de Microsoft Word .

Comment sécuriser un PDF après sa conversion depuis un fichier DOCX ?

Après la conversion, vous pouvez appliquer une protection par mot de passe et des restrictions d'autorisation directement sur l'objet PdfDocument avant l'enregistrement. Ceci est utile lors de la diffusion de rapports financiers, d'accords juridiques ou de tout document qui ne doit pas être librement copié ou imprimé :

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("confidential.docx");

// Require a password to open the file
pdf.SecuritySettings.UserPassword = "user123";

// Owner password allows overriding restrictions
pdf.SecuritySettings.OwnerPassword = "owner456";

// Restrict printing and content copying
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SaveAs("secured_document.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("confidential.docx");

// Require a password to open the file
pdf.SecuritySettings.UserPassword = "user123";

// Owner password allows overriding restrictions
pdf.SecuritySettings.OwnerPassword = "owner456";

// Restrict printing and content copying
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;

pdf.SaveAs("secured_document.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim pdf = renderer.RenderDocxAsPdf("confidential.docx")

' Require a password to open the file
pdf.SecuritySettings.UserPassword = "user123"

' Owner password allows overriding restrictions
pdf.SecuritySettings.OwnerPassword = "owner456"

' Restrict printing and content copying
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.NoPrint
pdf.SecuritySettings.AllowUserCopyPasteContent = False

pdf.SaveAs("secured_document.pdf")

Comment intégrer la conversion DOCX vers PDF dans un contrôleur ASP.NET Core ?

Pour exposer la conversion Word vers PDF en tant que point de terminaison HTTP, injectez la logique de conversion dans une action de contrôleur. L'exemple suivant accepte le téléchargement d'un formulaire en plusieurs parties, convertit le fichier en mémoire et renvoie le PDF sous forme de fichier téléchargeable :

using IronPdf;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class DocumentController : ControllerBase
{
    [HttpPost("convert")]
    public IActionResult ConvertWordToPdf(IFormFile wordFile)
    {
        if (wordFile == null || wordFile.Length == 0)
            return BadRequest("Please upload a valid Word document.");

        using var stream = new MemoryStream();
        wordFile.CopyTo(stream);

        var renderer = new DocxToPdfRenderer();
        var pdfDocument = renderer.RenderDocxAsPdf(stream.ToArray());

        return File(pdfDocument.BinaryData, "application/pdf", "converted.pdf");
    }
}

using IronPdf;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;

[ApiController]
[Route("api/[controller]")]
public class DocumentController : ControllerBase
{
    [HttpPost("convert")]
    public IActionResult ConvertWordToPdf(IFormFile wordFile)
    {
        if (wordFile == null || wordFile.Length == 0)
            return BadRequest("Please upload a valid Word document.");

        using var stream = new MemoryStream();
        wordFile.CopyTo(stream);

        var renderer = new DocxToPdfRenderer();
        var pdfDocument = renderer.RenderDocxAsPdf(stream.ToArray());

        return File(pdfDocument.BinaryData, "application/pdf", "converted.pdf");
    }
}

Imports IronPdf
Imports Microsoft.AspNetCore.Http
Imports Microsoft.AspNetCore.Mvc

<ApiController>
<Route("api/[controller]")>
Public Class DocumentController
    Inherits ControllerBase

    <HttpPost("convert")>
    Public Function ConvertWordToPdf(wordFile As IFormFile) As IActionResult
        If wordFile Is Nothing OrElse wordFile.Length = 0 Then
            Return BadRequest("Please upload a valid Word document.")
        End If

        Using stream As New MemoryStream()
            wordFile.CopyTo(stream)

            Dim renderer As New DocxToPdfRenderer()
            Dim pdfDocument = renderer.RenderDocxAsPdf(stream.ToArray())

            Return File(pdfDocument.BinaryData, "application/pdf", "converted.pdf")
        End Using
    End Function
End Class

try
{
    var pdf = renderer.RenderDocxAsPdf(stream.ToArray());
    return File(pdf.BinaryData, "application/pdf", "output.pdf");
}
catch (IronPdfException ex)
{
    // Log the exception and return a 422 Unprocessable Entity
    return UnprocessableEntity($"Conversion failed: {ex.Message}");
}

try
{
    var pdf = renderer.RenderDocxAsPdf(stream.ToArray());
    return File(pdf.BinaryData, "application/pdf", "output.pdf");
}
catch (IronPdfException ex)
{
    // Log the exception and return a 422 Unprocessable Entity
    return UnprocessableEntity($"Conversion failed: {ex.Message}");
}

Try
    Dim pdf = renderer.RenderDocxAsPdf(stream.ToArray())
    Return File(pdf.BinaryData, "application/pdf", "output.pdf")
Catch ex As IronPdfException
    ' Log the exception and return a 422 Unprocessable Entity
    Return UnprocessableEntity($"Conversion failed: {ex.Message}")
End Try

Comment fusionner un PDF converti avec un document existant ?

Un flux de travail courant consiste à convertir une lettre d'accompagnement DOCX puis à l'ajouter en préambule à un rapport PDF existant. La fonctionnalité de fusion de fichiers PDF d'IronPDF permet de réaliser cette opération en une seule ligne :

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var coverLetter = renderer.RenderDocxAsPdf("cover_letter.docx");
var existingReport = PdfDocument.FromFile("annual_report.pdf");

// Merge cover letter (first) with existing report (second)
var merged = PdfDocument.Merge(coverLetter, existingReport);
merged.SaveAs("final_document.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var coverLetter = renderer.RenderDocxAsPdf("cover_letter.docx");
var existingReport = PdfDocument.FromFile("annual_report.pdf");

// Merge cover letter (first) with existing report (second)
var merged = PdfDocument.Merge(coverLetter, existingReport);
merged.SaveAs("final_document.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim coverLetter As PdfDocument = renderer.RenderDocxAsPdf("cover_letter.docx")
Dim existingReport As PdfDocument = PdfDocument.FromFile("annual_report.pdf")

' Merge cover letter (first) with existing report (second)
Dim merged As PdfDocument = PdfDocument.Merge(coverLetter, existingReport)
merged.SaveAs("final_document.pdf")

Vous pouvez fusionner autant d'objets PdfDocument que nécessaire en passant une collection à PdfDocument.Merge. Pour des scénarios d'assemblage de documents plus avancés, explorez la possibilité d'ajouter des pages à un PDF existant ou d'apposer des filigranes sur le document converti.

Comment ajouter des filigranes ou des en-têtes aux PDF convertis ?

Après la conversion d'un fichier DOCX, vous pouvez ajouter des en-têtes, des pieds de page et des tampons de texte personnalisés à chaque page. Ceci est utile pour ajouter un statut d'approbation, des mentions de confidentialité ou une marque aux documents générés :

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("proposal.docx");

// Add a text stamp on every page
pdf.ApplyStamp(new TextStamp("DRAFT", new TextStampStyle
{
    FontSize = 36,
    FontColor = IronSoftware.Drawing.Color.FromArgb(100, 200, 0, 0),
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center,
    Rotation = -45
}));

pdf.SaveAs("proposal_draft.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";

var renderer = new DocxToPdfRenderer();
var pdf = renderer.RenderDocxAsPdf("proposal.docx");

// Add a text stamp on every page
pdf.ApplyStamp(new TextStamp("DRAFT", new TextStampStyle
{
    FontSize = 36,
    FontColor = IronSoftware.Drawing.Color.FromArgb(100, 200, 0, 0),
    VerticalAlignment = VerticalAlignment.Middle,
    HorizontalAlignment = HorizontalAlignment.Center,
    Rotation = -45
}));

pdf.SaveAs("proposal_draft.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY-HERE"

Dim renderer As New DocxToPdfRenderer()
Dim pdf = renderer.RenderDocxAsPdf("proposal.docx")

' Add a text stamp on every page
pdf.ApplyStamp(New TextStamp("DRAFT", New TextStampStyle With {
    .FontSize = 36,
    .FontColor = IronSoftware.Drawing.Color.FromArgb(100, 200, 0, 0),
    .VerticalAlignment = VerticalAlignment.Middle,
    .HorizontalAlignment = HorizontalAlignment.Center,
    .Rotation = -45
}))

pdf.SaveAs("proposal_draft.pdf")

Pour les en-têtes et pieds de page HTML incluant des numéros de page, consultez la documentation IronPDF sur les en-têtes et pieds de page .

Comment comparer IronPDF avec d'autres bibliothèques de conversion Word vers PDF ?

Il existe plusieurs bibliothèques pour convertir des fichiers DOCX en PDF en .NET. Comprendre les compromis vous aide à choisir l'outil adapté à votre cas d'utilisation.

Le logiciel de traitement de documents Telerik (RadWordsProcessing) prend en charge la conversion des fichiers DOCX en PDF et est inclus dans la Suite Telerik. Il fonctionne entièrement en code managé et ne nécessite aucune dépendance native, mais la qualité d'affichage des mises en page complexes peut différer de celle de Word. Aspose.Words est une autre option éprouvée offrant une grande fidélité et une API riche, bien qu'elle ait un coût de licence par développeur similaire à celui IronPDF.

Parmi les alternatives open source, DocX de Xceed permet la manipulation des fichiers DOCX mais n'inclut pas directement la conversion en PDF. Les développeurs qui ont besoin d'une option sans dépendance sous Linux peuvent également envisager LibreOffice en mode sans interface graphique, appelé depuis un processus, bien que cela introduit une importante dépendance binaire et une surcharge liée à la création de processus.

Le principal avantage d' IronPDF dans cette comparaison réside dans la combinaison d'une haute fidélité, de l'absence de dépendance native à Office, de la prise en charge de Linux et d'une installation simple basée sur NuGet. Pour les équipes utilisant déjà une licence IronPDF pour la conversion HTML vers PDF, le moteur de rendu DOCX est inclus sans frais supplémentaires.

Quelles sont vos prochaines étapes ?

Vous disposez désormais d'une base solide pour convertir des documents Word en PDF dans n'importe quelle application .NET ou ASP.NET . Voici ce qu'il faut explorer ensuite :

• Téléchargez et essayez IronPDF -- Commencez par la version d'essai gratuite pour tester toutes les fonctionnalités dans votre propre projet avant de vous engager sur une licence.
• Consultez le guide de conversion DOCX : l' article pratique sur DocxToPdfRenderer aborde en détail les cas particuliers, les options avancées et l'optimisation des performances.
• Explorez la conversion HTML vers PDF -- Si votre flux de travail implique des modèles HTML ou des vues Razor , IronPDF peut convertir le HTML en PDF avec la même interface API fluide.
• Fusionner et diviser des documents -- Apprenez à combiner plusieurs PDF en un seul fichier ou à diviser un PDF volumineux en pages individuelles.
• Ajouter des signatures numériques -- Pour les flux de travail juridiques ou de conformité, IronPDF prend en charge les signatures numériques PDF utilisant des certificats X.509.
• Examinez les options de licence : explorez les licences par développeur, par site et OEM pour trouver le plan qui correspond à votre modèle de déploiement.
• Consultez le blog -- Le blog IronPDF contient des tutoriels sur la génération de PDF, la manipulation, l'intégration de la reconnaissance optique de caractères (OCR), et bien plus encore.