Convertir un documento de Word a PDF en C# requiere tres líneas de código con IronPDF: crear un DocxToPdfRenderer, llamar a RenderDocxAsPdf y guardar el resultado. Sin instalación de Microsoft Office, sin interoperabilidad COM, sin configuración compleja de servidor: solo un paquete NuGet y código .NET que funciona en cualquier entorno, incluidos la nube, Docker y servicios de Windows.
Abra la consola del Administrador de paquetes en Visual Studio y ejecute el siguiente comando para instalar IronPDF:
Una vez instalado el paquete, agregue una directiva using IronPdf; a sus archivos C#. IronPDF está destinado a .NET 8 y versiones posteriores, lo que lo hace compatible con ASP.NET Core, ASP.NET Framework 4.6.2+ y proyectos de servicio de trabajo modernos. No se requieren componentes de ejecución adicionales ni licencias de Microsoft Office.
Antes de ejecutar en producción, configure su clave de licencia una vez al iniciar la aplicación, por ejemplo, en la parte superior de Program.cs. Puede leer la clave de appsettings.json para mantener las credenciales fuera del control de origen: IronPdf.License.LicenseKey = configuration["IronPdf:LicenseKey"]!;.
IronPDF es compatible con las siguientes plataformas:
| Plataforma | Versión mínima | Notas |
|---|---|---|
| .NET | 8, 9, 10 | Soporte completo, recomendado |
| Marco .NET | 4.6.2 | Sólo Windows |
| ASP.NET Core | 3.1+ | Controladores MVC y middleware |
| Azure Functions | versión 4 | Modelo de proceso aislado |
| Docker / Linux | Cualquier | Requiere libgdiplus |
La clase DocxToPdfRenderer es el punto de entrada para todas las conversiones de Word a PDF. Acepta una ruta de archivo, una matriz de bytes o un Stream, y devuelve un objeto PdfDocument que puede guardar, cifrar, fusionar o servir directamente a través de HTTP.
Aquí está la conversión más simple posible:
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 conserva los siguientes elementos del documento de Word durante la conversión:
Para obtener notas detalladas sobre el comportamiento de casos extremos, como objetos OLE integrados o cambios rastreados, consulte la documentación de DocxToPdfRenderer .
Cuando recibes un archivo DOCX como una carga o lo lees desde un blob de base de datos, puedes pasar la transmisión directamente al renderizador:
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 UsingEste enfoque evita escribir archivos temporales en el disco, lo cual es importante en entornos de sistemas de archivos de solo lectura como Azure App Service.
Cuando necesite procesar una carpeta completa de documentos, itere sobre los archivos y reutilice una única instancia DocxToPdfRenderer. La reutilización del renderizador evita la sobrecarga de inicialización repetida:
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
Para escenarios de alto rendimiento, considere paralelizar el bucle con Parallel.ForEach. Cree un DocxToPdfRenderer por hilo si ejecuta conversiones simultáneas, ya que la clase no es segura para hilos cuando se comparte entre hilos.
La combinación de correspondencia permite definir una plantilla DOCX con marcadores de posición y, posteriormente, rellenarlos con datos en tiempo de ejecución. Este patrón es ideal para facturas, contratos, certificados y cualquier documento cuya estructura es fija, pero cuyo contenido varía según el destinatario.
El DocxToPdfRenderer de IronPDF acepta un DataTable, un Dictionary<string, string> o una fuente de datos personalizada a través de la propiedad 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")En la plantilla DOCX, rodee cada nombre de campo con chevrones dobles (por ejemplo, <<CustomerName>>) para marcar los campos de combinación. En el momento de la conversión, IronPDF reemplaza cada marcador de posición con el valor de columna correspondiente de la fuente de datos. Puede obtener más información sobre los patrones de automatización de documentos en la documentación de combinación de correspondencia de Microsoft Word .
Después de la conversión, puede aplicar protección con contraseña y restricciones de permisos directamente en el objeto PdfDocument antes de guardar. Esto es útil cuando se distribuyen informes financieros, acuerdos legales o cualquier documento que no deba copiarse o imprimirse libremente:
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 utiliza encriptación AES de 128 bits y 256 bits según la versión del PDF. Para obtener más detalles sobre todas las opciones de seguridad disponibles, consulte la documentación de seguridad de IronPDF .
La siguiente tabla resume las propiedades de seguridad más utilizadas:
| Propiedad | Escriba a | Descripción |
|---|---|---|
| UserPassword | string | Se requiere contraseña para abrir el documento |
| OwnerPassword | string | Contraseña que anula todas las restricciones |
| AllowUserPrinting | PdfPrintSecurity enum | Controla los permisos de impresión |
| AllowUserCopyPasteContent | bool | Permite o bloquea la copia de texto |
| AllowUserAnnotations | bool | Permite o bloquea las herramientas de anotación |
| AllowUserFormData | bool | Permite o bloquea el llenado de formularios |
Para exponer la conversión de Word a PDF como un punto final HTTP, inyecte la lógica de conversión en una acción del controlador. El siguiente ejemplo acepta la carga de un formulario de varias partes, convierte el archivo en la memoria y devuelve el PDF como una respuesta de archivo descargable:
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 ClassPara aplicaciones más grandes, registre DocxToPdfRenderer como singleton a través del sistema de inyección de dependencia ASP.NET Core integrado. En Program.cs, agregue builder.Services.AddSingleton<DocxToPdfRenderer>(); después de configurar la clave de licencia. Registrar el renderizador como singleton significa que el objeto se inicializa una vez y se reutiliza en todas las solicitudes, lo que reduce la sobrecarga por solicitud. Inyéctelo en los controladores y servicios a través del constructor como lo haría con cualquier otra dependencia.
Los documentos de Word pueden contener características no compatibles o estar mal formados. Envuelva las llamadas de conversión en un bloque try/catch para manejar IronPdfException y devolver una respuesta significativa al llamador:
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 TryUn buen manejo de errores evita que aparezcan excepciones no controladas para los usuarios finales y hace que la depuración de problemas de conversión sea mucho más sencilla.
Un flujo de trabajo común implica convertir una carta de presentación DOCX y luego anteponerla a un informe PDF existente. La capacidad de fusión de PDF de IronPDF permite escribir esto en una sola línea:
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")Puede fusionar tantos objetos PdfDocument como necesite pasando una colección a PdfDocument.Merge. Para escenarios de ensamblaje de documentos más avanzados, explore la posibilidad de agregar páginas a un PDF existente o estampar marcas de agua en la salida convertida.
Después de convertir un archivo DOCX, puede agregar encabezados, pies de página y sellos de texto personalizados a cada página. Esto es útil para agregar estado de aprobación, avisos de confidencialidad o marca a los documentos generados:
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")Para encabezados y pies de página basados en HTML que incluyen números de página, consulte la documentación de encabezados y pies de página de IronPDF .
Existen varias bibliotecas para convertir archivos DOCX a PDF en .NET. Comprender las ventajas y desventajas le ayudará a elegir la herramienta adecuada para su caso de uso.
Telerik Document Processing (RadWordsProcessing) admite la conversión de DOCX a PDF y está incluido en la suite Telerik. Funciona completamente en código administrado y no requiere dependencias nativas, pero su fidelidad de representación para diseños complejos puede ser diferente a la de Word. Aspose.Words es otra opción establecida con alta fidelidad y una API enriquecida, aunque tiene un costo de licencia por desarrollador similar al de IronPDF.
Para alternativas de código abierto, DocX de Xceed proporciona manipulación DOCX pero no incluye conversión a PDF directamente. Los desarrolladores que necesitan una opción de dependencia cero en Linux también pueden considerar LibreOffice sin cabeza llamado desde un proceso, aunque eso introduce una gran dependencia binaria y una sobrecarga de generación de procesos.
| Biblioteca | Fidelidad de representación | Se requiere oficina | Soporte para Linux | Modelo de licencia |
|---|---|---|---|---|
| IronPDF | Alto | No | Sí | Por desarrollador / SaaS |
| Aspose.Words | Muy alto | No | Sí | Por desarrollador |
| Palabras de Telerik | Medio-alto | No | Sí | Suite Telerik |
| Microsoft.Office.Interop | Perfecto | Sí | No | Licencia de oficina |
| LibreOffice sin cabeza | Medio | No | Sí | Código abierto (MPL) |
La principal ventaja de IronPDF en esta comparación es la combinación de alta fidelidad, sin dependencia nativa de Office, compatibilidad con Linux y una instalación sencilla basada en NuGet. Para los equipos que ya utilizan una licencia IronPDF para la conversión de HTML a PDF, el renderizador DOCX viene incluido sin costo adicional.
IronPDF lee directamente el formato Office Open XML (OOXML), la misma especificación utilizada por Microsoft Word. No invoca Word en segundo plano ni utiliza un puente de automatización COM. Esto significa que la conversión se ejecuta en proceso dentro de su aplicación .NET , lo que la hace predecible, determinista y segura para cargas de trabajo de servidor multiproceso.
El canal interno analiza el paquete XML OOXML, resuelve los recursos integrados (imágenes, fuentes, objetos integrados), aplica formato de párrafo y de ejecución, diseña la geometría de la página según las propiedades de la sección del documento y rasteriza el resultado en un flujo de contenido PDF. La especificación PDF (ISO 32000) regula el formato de salida, garantizando la compatibilidad con los principales visores de PDF.
Ahora tiene una base sólida para convertir documentos de Word a PDF en cualquier aplicación .NET o ASP.NET . Esto es lo que debemos explorar a continuación:
Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien estructurados y visualmente atractivos.
IronPDF es parte de IRONSUITE
10 productos API .NET para tus documentos de oficina
Cuando necesitas que tu PDF se parezca al HTML, rápido.
