Guía de inicio rápido de IronPDF

Q: ¿Cómo configuro IronPDF para conectar a un servidor remoto de IronPDFEngine?

Para configurar IronPDF para un servidor remoto, usa Installation.ConnectTo IronPDFHost con el método IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer , especificando los detalles de IP y puerto del servidor.

Q: ¿Qué paquete debo usar para minimizar el tamaño de la aplicación al usar IronPDFEngine?

Deberías usar el paquete IronPdf.Slim de NuGet, ya que incluye solo los componentes necesarios para ejecutar IronPDF con IronPDFEngine, reduciendo así el tamaño de la aplicación.

Curtis Chau

Updated: 4 de junio de 2026

Instale IronPDF y cree su primer PDF en sólo cinco minutos. Con su sencilla API, puede convertir HTML, DOCX, imágenes y mucho más en PDF perfectos.

1. Requisitos previos

.NET Framework 4.6.2+ O .NET Core 3.1+ O .NET 5+
Redistribuible de Visual C++ (para Windows).

2. Instalar IronPDF

La instalación estándar de IronPDF se ejecuta localmente. Si deseas implementar en Docker/microservicios, consulta Guía del Modo de Motor Remoto.

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2Copie y ejecute este fragmento de código.

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

3Despliegue para probar en su entorno real

Comienza a usar IronPDF en tu proyecto hoy mismo con una prueba gratuita

Administrador de paquetes NuGet

Descarga de DLL

Ir a la biblioteca IronPDF NuGet:

Selecciona 'Administrar paquetes NuGet' > 'Explorar' > Busca IronPDF

PM > Install-Package IronPdf

Install-Package IronPdf

Descargar Paquete IronPDF DLL
Descomprima el archivo ZIP para su sistema operativo en una ubicación dentro de su directorio de soluciones
En el Explorador de soluciones de Visual Studio, haga clic con el botón derecho del ratón en "Dependencias"
añadir referencia de proyecto' > Seleccione 'Examinar' para incluir todas las DLL extraídas del zip.

Guías específicas de plataforma

3. Aplicar clave de licencia

Cuando compras licencias de IronPDF o decides comenzar con una prueba de 30 días, se te enviará una clave de licencia a tu correo electrónico. Copia la clave y agrégala al inicio de tu aplicación.

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

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

Imports IronPdf

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

Imports IronPdf

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

4. Cree su primer PDF

Agrega esto en la parte superior de tu archivo .cs.

using IronPdf;

using IronPdf;

Imports IronPdf

Imports IronPdf

Crear un PDF en blanco

Convertir cadena HTML a PDF

Convertir DOCX a PDF

La forma más simple de crear un objeto PDF es usando solo el ancho y el alto. Este PdfDocument constructor crea un PDF en blanco, listo para personalización.

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");

Imports IronPdf

Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")

Imports IronPdf

Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")

Usando el método ChromePdfRenderer.RenderHtmlAsPdf, puedes transformar cualquier HTML (incluyendo HTML5) en un PDF usando el motor Chromium incrustado.

using IronPdf;

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("string-to-pdf.pdf");

using IronPdf;

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("string-to-pdf.pdf");

Convierte documentos de Word a PDF con la clase DocxToPdfRenderer, puedes renderizar archivos DOCX directamente en PDFs personalizables para una integración fluida en aplicaciones .NET.

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");

Imports IronPdf

Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")

Imports IronPdf

Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")

5. Ejemplos más avanzados

Además de la creación y conversión de PDF sencillas, IronPDF también ofrece opciones más potentes para la personalización de PDF.

Añadir encabezados y pies de página

Redactar texto

Fusionar PDF

Crea encabezados o pies de página de texto instanciando TextHeaderFooter, agregando tu texto, y adjuntándolo al PDF.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")

Edita texto con facilidad usando RedactTextOnAllPages para eliminar una frase en todo el documento.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")

' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")

pdf.SaveAs("redacted.pdf")

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")

' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")

pdf.SaveAs("redacted.pdf")

Combina dos archivos PDF en C# con el método Merge. Usa ReplaceTextOnAllPages en cualquier PdfDocument, nuevo o importado, para intercambiar el texto antiguo con el nuevo.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

pdf.SaveAs("replaceText.pdf")

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

pdf.SaveAs("replaceText.pdf")

Solución rápida de problemas

Edición	Solución
Falta Visual C++ Runtime	Instalación de Visual C++ Redistributable: se necesitan las versiones x86 y x64 para el motor de Chrome
Licencia no reconocida	Verifique con la propiedad `IronPdf.License.IsLicensed`. Asegúrese de que la licencia se aplica antes de cualquier operación IronPDF
Primera renderización lenta	Llame a `IronPdf.Installation.Initialize()` al inicio para preinicializar los motores de renderizado
Dependencias de Linux/Docker	Establezca `Installation.LinuxAndDockerDependenciesAutoConfig = true` para la instalación automática de dependencias

Próximos pasos

Editar PDFsVer características Organizar PDFsVer características Firmar y asegurar PDFsVer características

Preguntas Frecuentes

¿Cómo puedo configurar IronPDFEngine para la generación remota de PDF?

Para configurar IronPDFEngine para la generación remota de PDF, instala el paquete IronPdf.Slim desde NuGet y configura las configuraciones de conexión usando la clase IronPDFConnectionConfiguration. Esta configuración te permite conectar tu aplicación a la instancia de IronPDFEngine remotamente.

¿Cuáles son los principales beneficios de usar IronPDFEngine con mi aplicación?

Usar IronPDFEngine con tu aplicación permite la ejecución remota de tareas PDF, ayudando a evitar problemas de compatibilidad específicos de la plataforma, especialmente en sistemas más antiguos y plataformas móviles. También elimina la necesidad del tiempo de ejecución de .NET durante la ejecución.

¿Por qué podría elegir usar IronPDFEngine en lugar de la biblioteca PDF nativa?

Podrías elegir IronPDFEngine para ejecutar funciones PDF intensivas en rendimiento de forma remota, reduciendo problemas de compatibilidad con diferentes sistemas operativos y mejorando el rendimiento al aprovechar un renderizador idéntico a Chrome para la conversión de HTML a PDF.

¿Es compatible el escalado horizontal en IronPDFEngine?

No, IronPDFEngine actualmente no admite el escalado horizontal, lo que significa que no puede ser equilibrado en carga entre múltiples instancias debido a la forma en que se manejan los archivos binarios de PDF en la memoria del servidor.

¿Puede ejecutarse IronPDFEngine en diferentes sistemas operativos?

IronPDFEngine está diseñado para ejecutarse en sistemas Linux usando contenedores Docker. Sin embargo, los archivos binarios son específicos de la plataforma, por lo que necesitas asegurarte de usar la versión correcta para tu sistema operativo.

¿Qué debo hacer si mis salidas de PDF son diferentes al usar IronPDFEngine?

Las salidas de PDF pueden variar ligeramente debido a comportamientos diferentes del sistema operativo. Para minimizar diferencias, asegúrate de estar usando la imagen Docker correcta y verifica cualquier configuración específica del sistema operativo que pueda afectar el renderizado.

¿Cómo aseguro que mi aplicación esté usando la versión correcta de IronPDFEngine?

Para asegurar la compatibilidad, cada versión de IronPDF requiere una versión correspondiente de IronPDFEngine. Asegúrate de actualizar ambos componentes simultáneamente para evitar problemas de versiones cruzadas.

¿Cuáles son las limitaciones al usar IronPDFEngine en Windows?

Al usar IronPDFEngine en Windows, necesitas contenedores de Linux para Docker y debes asegurarte de que el puerto del servidor sea accesible. Los binarios son específicos de la plataforma y se requiere cambiar a contenedores de Linux.

¿Cómo configuro IronPDF para conectar a un servidor remoto de IronPDFEngine?

Para configurar IronPDF para un servidor remoto, usa Installation.ConnectTo IronPDFHost con el método IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer, especificando los detalles de IP y puerto del servidor.

¿Qué paquete debo usar para minimizar el tamaño de la aplicación al usar IronPDFEngine?

Deberías usar el paquete IronPdf.Slim de NuGet, ya que incluye solo los componentes necesarios para ejecutar IronPDF con IronPDFEngine, reduciendo así el tamaño de la aplicación.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

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.

...