Convertir un document Word en PDF en C# nécessite trois lignes de code avec IronPDF : créez un DocxToPdfRenderer, appelez RenderDocxAsPdf, et enregistrez le résultat. Aucune installation de Microsoft Office, aucune interopérabilité COM, aucune configuration serveur complexe : juste un package NuGet et du code .NET qui fonctionne dans n'importe quel environnement, y compris le cloud, Docker et les services Windows.
Ouvrez la console du gestionnaire de packages dans Visual Studio et exécutez la commande suivante pour installer 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 passer en production, définissez votre clé de licence une fois au démarrage de l'application -- par exemple en haut de Program.cs. Vous pouvez lire la clé depuis appsettings.json pour garder les identifiants hors du contrôle de source : IronPdf.License.LicenseKey = configuration["IronPdf:LicenseKey"]!;.
IronPDF prend en charge les plateformes suivantes :
| Plate-forme | Version minimale | Remarques |
|---|---|---|
| .NET | 8, 9, 10 | Soutien total, recommandé |
| .NET Framework | 4.6.2 | Windows uniquement |
| ASP.NET Core | 3.1+ | Contrôleurs intermédiaires et MVC |
| Azure Functions | v4 | Modèle de processus isolé |
| Docker / Linux | N'importe lequel | Nécessite libgdiplus |
La classe DocxToPdfRenderer est le point d'entrée pour toutes les conversions Word en PDF. Elle accepte un chemin de fichier, un tableau d'octets, ou un Stream, et renvoie un objet PdfDocument que vous pouvez enregistrer, crypter, 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");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")DocxToPdfRenderer préserve les éléments suivants du document Word lors de la conversion :
Pour des notes de comportement détaillées sur les cas limites tels que les objets OLE intégrés ou les modifications suivies, consultez la documentation de DocxToPdfRenderer .
Lorsque vous recevez un fichier DOCX par téléchargement ou que vous le lisez à partir d'un blob de base de données, vous pouvez transmettre le flux directement au moteur de rendu :
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 UsingCette approche évite l'écriture de fichiers temporaires sur le disque, ce qui est important dans les environnements de systèmes de fichiers en lecture seule tels qu'Azure App Service.
Lorsque vous devez traiter l'intégralité d'un dossier de documents, itérez sur les fichiers et réutilisez une seule instance de 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)}");
}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
Pour des scénarios à haut débit, envisagez de paralléliser la boucle avec Parallel.ForEach. Créez un DocxToPdfRenderer par thread si vous exécutez des conversions concurrentes, car la classe n'est pas sûre pour les threads lorsqu'elle est partagée entre eux.
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.
L'DocxToPdfRenderer d'IronPDF accepte un DataTable, un Dictionary<string, string>, ou 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");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 avec des 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 .
Après la conversion, vous pouvez appliquer une protection par mot de passe et des restrictions de permission directement sur l'objet PdfDocument avant d'enregistrer. 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");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")
IronPDF utilise un chiffrement AES 128 bits et 256 bits selon la version du PDF. Pour plus de détails sur toutes les options de sécurité disponibles, consultez la documentation de sécurité IronPDF .
Le tableau suivant récapitule les propriétés de sécurité les plus couramment utilisées :
| Propriété | Type de texte | Description du projet |
|---|---|---|
| MotDePasseUtilisateur | string | Mot de passe requis pour ouvrir le document |
| OwnerPassword | string | Mot de passe qui annule toutes les restrictions |
| Autoriser l'impression par l'utilisateur | énumération PdfPrintSecurity | Contrôle les autorisations d'impression |
| Autoriser le copier-coller par l'utilisateur | bool | Autorise ou bloque la copie de texte |
| Autoriser les annotations utilisateur | bool | Autorise ou bloque les outils d'annotation |
| Autoriser les données du formulaire utilisateur | bool | Autorise ou bloque le remplissage des formulaires |
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");
}
}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 ClassPour les applications plus larges, enregistrez DocxToPdfRenderer en tant que singleton via le système d'injection de dépendances intégré à ASP.NET Core. Dans Program.cs, ajoutez builder.Services.AddSingleton<DocxToPdfRenderer>(); après avoir défini la clé de licence. L'enregistrement du moteur de rendu en tant que singleton signifie que l'objet est initialisé une seule fois et réutilisé pour toutes les requêtes, ce qui réduit la surcharge par requête. Injectez-le dans les contrôleurs et les services via le constructeur, comme vous le feriez pour n'importe quelle autre dépendance.
Les documents Word peuvent contenir des fonctionnalités non prises en charge ou être malformés. Enveloppez les appels de conversion dans un bloc try/catch pour gérer IronPdfException et renvoyer une réponse significative à l'appelant :
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 TryUne bonne gestion des erreurs empêche les exceptions non gérées d'apparaître aux utilisateurs finaux et facilite considérablement le débogage des problèmes de conversion.
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");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.
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");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 .
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.
| Bibliothèque | Fidélité du rendu | Bureau requis | Prise en charge de Linux | Modèle de licence |
|---|---|---|---|---|
| IronPDF | Haut | Non | Oui | Par développeur / SaaS |
| Aspose.Words | Très élevé | Non | Oui | Par développeur |
| Telerik RadWords | Moyen-élevé | Non | Oui | Suite Telerik |
| Microsoft.Office.Interop | Parfait | Oui | Non | Licence de bureau |
| LibreOffice sans interface graphique | Moyen | Non | Oui | Logiciel libre (MPL) |
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.
IronPDF lit directement le format Office Open XML (OOXML) – la même spécification utilisée par Microsoft Word. Il n'exécute pas Word en arrière-plan et n'utilise pas de pont d'automatisation COM. Cela signifie que la conversion s'exécute au sein même de votre application .NET , ce qui la rend prévisible, déterministe et sûre pour les charges de travail serveur multithread.
Le pipeline interne analyse le package XML OOXML, résout les ressources incorporées (images, polices, objets incorporés), applique la mise en forme des paragraphes et des séquences, dispose la géométrie de la page en fonction des propriétés de section du document et rasterise le résultat en un flux de contenu PDF. La spécification PDF (ISO 32000) régit le format de sortie, assurant la compatibilité avec tous les principaux visualiseurs PDF.
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 :
Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.
IronPDF fait partie de IRONSUITE
10 API .NET pour vos documents
Lorsque vous avez besoin que votre PDF ressemble à HTML, rapidement.
