C# Crear PDF - Una Guía Completa para Usar IronPDF

Introducción

Crear documentos PDF a partir de contenido HTML se ha convertido en un requisito esencial para varias aplicaciones, que van desde la generación de facturas hasta el archivado de contenido web. IronPDF es una potente y versátil biblioteca .NET que simplifica el proceso de conversión de HTML a PDF, haciendo que sea fácil para los desarrolladores crear documentos PDF de alta calidad en C#. En este artículo, exploraremos las características de IronPDF y proporcionaremos una guía paso a paso para usarlo en la creación de PDF.

Cómo crear archivos PDF en C# usando la biblioteca IronPDF

1. Crear un nuevo proyecto en Visual Studio
2. Agregar la biblioteca IronPDF desde el administrador de paquetes NuGet
3. Crear un archivo PDF simple.
4. Modificar archivos PDF.
5. Agregar encabezados y pies de página
6. Incluir hojas de estilo y scripts externos
7. Incluir imágenes y mapas de bits.
8. Conversión de archivos HTML a PDF.
9. Conversión de una URL a PDF.

Introducción a IronPDF

IronPDF es una biblioteca de .NET que permite a los desarrolladores convertir HTML a PDF fácilmente. Soporta una amplia gama de funciones, incluyendo CSS, JavaScript e incluso imágenes incrustadas. Con IronPDF, puede crear PDFs que se vean exactamente como sus páginas web en HTML, asegurando una transición sin problemas entre formatos. Esta biblioteca es particularmente útil para aplicaciones web que necesitan generar documentos PDF dinámicos sobre la marcha.

IronPDF permite a los desarrolladores integrar sin problemas la funcionalidad de PDF en aplicaciones .NET sin necesidad de gestionar manualmente las estructuras de archivos PDF. IronPDF aprovecha el motor de renderizado basado en Chrome para convertir páginas HTML (incluyendo CSS complejo, JavaScript e imágenes) en documentos PDF bien estructurados. Se puede utilizar para generar informes, facturas, libros electrónicos o cualquier tipo de documento que necesite presentarse en formato PDF.

IronPDF es versátil, ofreciendo funcionalidad que no solo renderiza PDFs sino que también proporciona una amplia gama de opciones de manipulación de PDFs como edición, manejo de formularios, encriptación y más.

Características principales de IronPDF C# para crear archivos PDF

1. Conversión de HTML a PDF

• Renderizado de HTML: IronPDF puede convertir documentos HTML o páginas web (incluyendo HTML con CSS, imágenes y JavaScript) directamente en un documento PDF con solo unas pocas líneas, siendo ideal para generar PDFs a partir de contenido web dinámico.

• Soporte para HTML/CSS Moderno: IronPDF maneja HTML5, CSS3 y JavaScript modernos, asegurando que su contenido basado en la web se interprete con precisión como un PDF, preservando el diseño, las fuentes y los elementos interactivos.

• Renderizado Avanzado: Utiliza el motor de renderizado de Chrome (vía Chromium) para una generación de PDF precisa y de alta calidad, haciéndolo más confiable que muchas otras bibliotecas de HTML a PDF.

• URL de Sitio Web a PDF: IronPDF puede tomar una URL de cadena del sitio web como entrada y convertirla a PDF.

2. Encabezados y pies de página personalizados

• IronPDF permite a los desarrolladores agregar encabezados y pies de página personalizados a los documentos PDF, que pueden incluir contenido dinámico como números de página, título del documento o texto personalizado.

• Los encabezados y pies de página se pueden agregar a páginas individuales o como elementos consistentes en todo el documento.

3. Soporte para JavaScript en PDF

• IronPDF permite la ejecución de JavaScript dentro del contenido HTML antes de la generación del PDF. Esto permite la representación de contenido dinámico, como cálculos de formularios o interactividad en los PDFs generados.

4. Editar PDFs existentes

• IronPDF proporciona la capacidad de editar PDFs existentes. Puede modificar texto, imágenes y agregar anotaciones a archivos PDF existentes. Esta función es útil para marcar documentos, agregar firmas o actualizar contenido dentro de archivos PDF.

• La extracción y modificación de texto le permiten manipular contenido dentro de un documento PDF de manera programática.

5. Combinar y dividir PDFs

• IronPDF le permite combinar múltiples archivos PDF en un solo documento o dividir un PDF grande en archivos más pequeños, ideal para flujos de trabajo donde los documentos deben ser combinados o desglosados en partes más manejables.

6. Soporte para formularios interactivos

• Puede crear, rellenar y manipular formularios PDF usando IronPDF. Proporciona soporte completo para formularios interactivos (como campos de texto, casillas de verificación y botones de opción) y le permite prellenar formularios con datos.

7. Manipulación de páginas

• IronPDF ofrece métodos para manipular páginas individuales dentro de un documento PDF, como rotar páginas, eliminar páginas o reordenarlas.

8. Seguridad y encriptación

• IronPDF le permite aplicar protección por contraseña y cifrado a los PDFs, asegurando que sus documentos estén seguros. Puede establecer permisos de usuario para evitar la impresión, copia o edición del PDF.

9. Marca de agua y marcado

• Agregar marcas de agua a los documentos PDF es fácil con IronPDF. Puede superponer texto o imágenes como marcas de agua en las páginas, proporcionando protección contra copias o distribución no autorizadas de sus documentos.

10. Extracción de texto e imágenes

• IronPDF permite la extracción de texto e imágenes de documentos PDF, permitiendo a los desarrolladores extraer datos para su procesamiento o reutilización.

11. Soporte para Unicode y multilingüe

• IronPDF tiene un soporte Unicode robusto, lo que significa que puede manejar caracteres y fuentes internacionales, haciendo que sea ideal para generar PDFs en múltiples idiomas.

12. Optimizado para rendimiento

• IronPDF está optimizado para el rendimiento, capaz de manejar documentos PDF grandes y altos volúmenes de solicitudes. La biblioteca asegura una rápida y eficiente generación de PDFs incluso con grandes conjuntos de datos o imágenes.

13. API y herramientas amigables para desarrolladores

• IronPDF viene con una API completa y fácil de usar. Los desarrolladores pueden comenzar rápidamente usando llamadas de métodos simples para realizar tareas complejas.

14. Soporte multiplataforma

• IronPDF es compatible entre plataformas, lo que significa que puede ser usado tanto en entornos Windows como Linux, permitiendo generar y manipular PDFs en diferentes sistemas operativos.

Paso 1: crear un nuevo proyecto de Visual Studio

Ahora vamos a comenzar creando un nuevo proyecto, abra Visual Studio y cree un nuevo proyecto como se indica a continuación.

Seleccione crear aplicación de consola.

Proporciona el nombre y la ubicación del proyecto.

Seleccione versión de .NET

Crear un nuevo proyecto.

Paso 2: Agregue la biblioteca IronPDF desde el administrador de paquetes NuGet

Usando el Administrador de Paquetes NuGet en la aplicación de consola de Visual Studio puede usar el siguiente comando para agregar la biblioteca NuGet de IronPDF.

Además, IronPDF se puede instalar usando el Administrador de Paquetes Visual Studio.

Paso 3: Crea un archivo PDF simple.

Genere documentos PDF con facilidad usando la biblioteca IronPDF. Ahora comencemos con un archivo PDF simple en blanco.

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a new PDF document with specific dimensions (270x270 points)
        PdfDocument pdf = new PdfDocument(270, 270);

        // Save the blank PDF document to disk
        pdf.SaveAs("simple.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a new PDF document with specific dimensions (270x270 points)
        PdfDocument pdf = new PdfDocument(270, 270);

        // Save the blank PDF document to disk
        pdf.SaveAs("simple.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Set your IronPDF license key
		IronPdf.License.LicenseKey = "your key"

		' Create a new PDF document with specific dimensions (270x270 points)
		Dim pdf As New PdfDocument(270, 270)

		' Save the blank PDF document to disk
		pdf.SaveAs("simple.pdf")
	End Sub
End Class

Paso 4: Modificar archivos PDF

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Load the existing PDF document
        var pdf = new PdfDocument("simple.pdf");

        // Create a renderer for converting HTML to PDF
        var renderer = new ChromePdfRenderer();

        // Render HTML content as a PDF
        var pagePdf = renderer.RenderHtmlAsPdf("<h1>Awesome IronPDF Library</h1>");

        // Prepend the rendered page as the first page of the existing PDF
        pdf.PrependPdf(pagePdf);

        // Save the modified PDF with a new filename
        pdf.SaveAs("simple_WithTitle.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Load the existing PDF document
        var pdf = new PdfDocument("simple.pdf");

        // Create a renderer for converting HTML to PDF
        var renderer = new ChromePdfRenderer();

        // Render HTML content as a PDF
        var pagePdf = renderer.RenderHtmlAsPdf("<h1>Awesome IronPDF Library</h1>");

        // Prepend the rendered page as the first page of the existing PDF
        pdf.PrependPdf(pagePdf);

        // Save the modified PDF with a new filename
        pdf.SaveAs("simple_WithTitle.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Set your IronPDF license key
		IronPdf.License.LicenseKey = "your key"

		' Load the existing PDF document
		Dim pdf = New PdfDocument("simple.pdf")

		' Create a renderer for converting HTML to PDF
		Dim renderer = New ChromePdfRenderer()

		' Render HTML content as a PDF
		Dim pagePdf = renderer.RenderHtmlAsPdf("<h1>Awesome IronPDF Library</h1>")

		' Prepend the rendered page as the first page of the existing PDF
		pdf.PrependPdf(pagePdf)

		' Save the modified PDF with a new filename
		pdf.SaveAs("simple_WithTitle.pdf")
	End Sub
End Class

Paso 5: Agregar encabezados y pies de página

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a new HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Define the HTML content
        string htmlContent = "<html><body><h1>IronPDF: An Awesome PDF Generation Library</h1><h2>Report</h2><p>This is a sample report.</p></body></html>";

        // Define headers and footers as HTML
        string headerHtml = "<div style='text-align: right;'>Page {page} of {total-pages}</div>";
        string footerHtml = "<div style='text-align: center;'>Confidential</div>";

        // Convert the HTML content to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Add headers and footers to the PDF document
        pdfDocument.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
        {
            HtmlHeader = new HtmlHeaderFooter() { HtmlFragment = headerHtml },
            HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = footerHtml }
        });

        // Save the PDF document with headers and footers
        pdfDocument.SaveAs("report.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a new HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Define the HTML content
        string htmlContent = "<html><body><h1>IronPDF: An Awesome PDF Generation Library</h1><h2>Report</h2><p>This is a sample report.</p></body></html>";

        // Define headers and footers as HTML
        string headerHtml = "<div style='text-align: right;'>Page {page} of {total-pages}</div>";
        string footerHtml = "<div style='text-align: center;'>Confidential</div>";

        // Convert the HTML content to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Add headers and footers to the PDF document
        pdfDocument.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
        {
            HtmlHeader = new HtmlHeaderFooter() { HtmlFragment = headerHtml },
            HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = footerHtml }
        });

        // Save the PDF document with headers and footers
        pdfDocument.SaveAs("report.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Set your IronPDF license key
		IronPdf.License.LicenseKey = "your key"

		' Create a new HtmlToPdf renderer
		Dim renderer = New ChromePdfRenderer()

		' Define the HTML content
		Dim htmlContent As String = "<html><body><h1>IronPDF: An Awesome PDF Generation Library</h1><h2>Report</h2><p>This is a sample report.</p></body></html>"

		' Define headers and footers as HTML
		Dim headerHtml As String = "<div style='text-align: right;'>Page {page} of {total-pages}</div>"
		Dim footerHtml As String = "<div style='text-align: center;'>Confidential</div>"

		' Convert the HTML content to a PDF document
		Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

		' Add headers and footers to the PDF document
		pdfDocument.AddHtmlHeadersAndFooters(New ChromePdfRenderOptions With {
			.HtmlHeader = New HtmlHeaderFooter() With {.HtmlFragment = headerHtml},
			.HtmlFooter = New HtmlHeaderFooter() With {.HtmlFragment = footerHtml}
		})

		' Save the PDF document with headers and footers
		pdfDocument.SaveAs("report.pdf")
	End Sub
End Class

Paso 6: Inclusión de hojas de estilo y scripts externos

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Define the HTML content with links to external CSS and JS files
        string htmlContent = @"
        <html>
            <head>
                <link rel='stylesheet' type='text/css' href='styles.css'>
                <script src='script.js'></script>
            </head>
            <body>
                <h1>IronPDF: An Awesome PDF Generation Library</h1>
                <h2>Styled Content</h2>
                <p id='dynamic-text'>This content is styled using an external CSS file and JavaScript.</p>
            </body>
        </html>";

        // Create a PDF renderer instance
        var renderer = new ChromePdfRenderer();

        // Render HTML content to a PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to disk
        pdfDocument.SaveAs("awesomeIronPDF_styled_content.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Define the HTML content with links to external CSS and JS files
        string htmlContent = @"
        <html>
            <head>
                <link rel='stylesheet' type='text/css' href='styles.css'>
                <script src='script.js'></script>
            </head>
            <body>
                <h1>IronPDF: An Awesome PDF Generation Library</h1>
                <h2>Styled Content</h2>
                <p id='dynamic-text'>This content is styled using an external CSS file and JavaScript.</p>
            </body>
        </html>";

        // Create a PDF renderer instance
        var renderer = new ChromePdfRenderer();

        // Render HTML content to a PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to disk
        pdfDocument.SaveAs("awesomeIronPDF_styled_content.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Set your IronPDF license key
		IronPdf.License.LicenseKey = "your key"

		' Define the HTML content with links to external CSS and JS files
		Dim htmlContent As String = "
        <html>
            <head>
                <link rel='stylesheet' type='text/css' href='styles.css'>
                <script src='script.js'></script>
            </head>
            <body>
                <h1>IronPDF: An Awesome PDF Generation Library</h1>
                <h2>Styled Content</h2>
                <p id='dynamic-text'>This content is styled using an external CSS file and JavaScript.</p>
            </body>
        </html>"

		' Create a PDF renderer instance
		Dim renderer = New ChromePdfRenderer()

		' Render HTML content to a PDF
		Dim pdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

		' Save the PDF to disk
		pdfDocument.SaveAs("awesomeIronPDF_styled_content.pdf")
	End Sub
End Class

/* styles.css */
body {
    font-family: Arial, sans-serif;
    margin: 20px;
}
h1 {
    color: #007BFF;
}
p {
    font-size: 14px;
    line-height: 1.6;
}

// script.js
document.addEventListener('DOMContentLoaded', function() {
    var dynamicText = document.getElementById('dynamic-text');
    dynamicText.textContent = "This content has been modified by JavaScript.";
});

// script.js
document.addEventListener('DOMContentLoaded', function() {
    var dynamicText = document.getElementById('dynamic-text');
    dynamicText.textContent = "This content has been modified by JavaScript.";
});

Paso 7: Incluir imágenes y mapas de bits.

using IronPdf;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a PDF renderer instance
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Import image file as bytes
        byte[] base64Bytes = File.ReadAllBytes("image.jpg"); // Use your own image file here

        // Convert image bytes to Base64 string
        string imgDataUri = @"data:image/png;base64," + Convert.ToBase64String(base64Bytes);

        // Create HTML content with the embedded Base64 image
        string imgHtml = $"<img src='{imgDataUri}'>";

        // Render HTML content to a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(imgHtml);

        // Save the PDF with the embedded image
        pdf.SaveAs("embedded_sample.pdf");
    }
}

using IronPdf;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a PDF renderer instance
        ChromePdfRenderer renderer = new ChromePdfRenderer();

        // Import image file as bytes
        byte[] base64Bytes = File.ReadAllBytes("image.jpg"); // Use your own image file here

        // Convert image bytes to Base64 string
        string imgDataUri = @"data:image/png;base64," + Convert.ToBase64String(base64Bytes);

        // Create HTML content with the embedded Base64 image
        string imgHtml = $"<img src='{imgDataUri}'>";

        // Render HTML content to a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(imgHtml);

        // Save the PDF with the embedded image
        pdf.SaveAs("embedded_sample.pdf");
    }
}

Imports IronPdf
Imports System
Imports System.IO

Friend Class Program
	Shared Sub Main()
		' Set your IronPDF license key
		IronPdf.License.LicenseKey = "your key"

		' Create a PDF renderer instance
		Dim renderer As New ChromePdfRenderer()

		' Import image file as bytes
		Dim base64Bytes() As Byte = File.ReadAllBytes("image.jpg") ' Use your own image file here

		' Convert image bytes to Base64 string
		Dim imgDataUri As String = "data:image/png;base64," & Convert.ToBase64String(base64Bytes)

		' Create HTML content with the embedded Base64 image
		Dim imgHtml As String = $"<img src='{imgDataUri}'>"

		' Render HTML content to a PDF
		Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(imgHtml)

		' Save the PDF with the embedded image
		pdf.SaveAs("embedded_sample.pdf")
	End Sub
End Class

Paso 8: Conversión de archivos HTML a PDF.

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from an existing HTML file using C#
        var pdf = renderer.RenderHtmlFileAsPdf("sample.html");

        // Export to a file or Stream
        pdf.SaveAs("output.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from an existing HTML file using C#
        var pdf = renderer.RenderHtmlFileAsPdf("sample.html");

        // Export to a file or Stream
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Instantiate Renderer
		Dim renderer = New ChromePdfRenderer()

		' Create a PDF from an existing HTML file using C#
		Dim pdf = renderer.RenderHtmlFileAsPdf("sample.html")

		' Export to a file or Stream
		pdf.SaveAs("output.pdf")
	End Sub
End Class

Paso 9: Conversión de URL a PDF.

El siguiente fragmento de código demuestra el uso de IronPDF para convertir URL a PDF.

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from a URL or local file path
        var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");

        // Export to a file or Stream
        pdf.SaveAs("url.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from a URL or local file path
        var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");

        // Export to a file or Stream
        pdf.SaveAs("url.pdf");
    }
}

Imports IronPdf

Friend Class Program
	Shared Sub Main()
		' Instantiate Renderer
		Dim renderer = New ChromePdfRenderer()

		' Create a PDF from a URL or local file path
		Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/")

		' Export to a file or Stream
		pdf.SaveAs("url.pdf")
	End Sub
End Class

Casos de uso de IronPDF

IronPDF es una potente biblioteca para trabajar con PDFs en C#. Permite a los desarrolladores generar, modificar y manipular documentos PDF fácilmente. A continuación se presentan algunos casos de uso comunes de IronPDF en aplicaciones C#:

Información de licencia (versión de prueba disponible)

IronPDF ofrece una prueba gratuita. Colóquelo antes de usar la biblioteca de la siguiente manera:

IronPdf.License.LicenseKey = "your key";

IronPdf.License.LicenseKey = "your key";

IronPdf.License.LicenseKey = "your key"

Conclusión

IronPDF, la biblioteca .NET PDF, hace que la generación de PDFs en C# sea simple y poderosa. Ya sea que esté generando facturas, informes u otros tipos de documentos, IronPDF ofrece características robustas como conversión de HTML a PDF, encabezados y pies de página personalizados, edición de PDF, manejo de formularios y más. Proporciona una forma sin complicaciones de trabajar con PDFs.

Con IronPDF, puede crear PDFs de alta calidad sin esfuerzo en C#, permitiéndole centrarse en ofrecer una gran funcionalidad a sus usuarios en lugar de preocuparse por las complejidades del formateo de documentos. Ya sea trabajando con contenido web dinámico o creando informes estáticos, IronPDF es una solución confiable para sus necesidades de PDF.