Paso 1: Configuración del proyecto de Visual Studio para la generación de PDF en C

El primer paso es crear un proyecto de Visual Studio. Para este tutorial, utilizaremos la plantilla Windows Forms App, pero IronPDF funciona perfectamente con aplicaciones Web (ASP.NET), aplicaciones de consola, WPF, etc.

Abre Visual Studio.

Haz clic en "Crear Nuevo Proyecto".

Seleccione "Windows Forms App (.NET Framework o .NET Core)" en las plantillas y, a continuación, haga clic en "Siguiente". Aparecerá la siguiente ventana. Ponle un nombre a tu proyecto (por ejemplo, MyCSharpPdfGenerator).

Nombre del proyecto

A continuación, haz clic en "Siguiente". En el menú desplegable, elija el .NET Framework que desee (IronPDF admite una amplia gama).

Selección de .NET Framework

Haga clic en el botón 'Crear'. El proyecto estará creado y listo para el siguiente paso.

Paso 2: Instalación de la biblioteca IronPDF C# - Su clave para la generación de PDF

IronPDF se añade fácilmente a su proyecto utilizando NuGet. Esta es la forma recomendada de asegurarse de que se dispone de la última versión y de todas las dependencias necesarias.

Install-Package IronPdf

Paso 3: Diseño de una interfaz de formulario de Windows sencilla (opcional)

En este tutorial, crearemos una interfaz de usuario básica para activar la generación de PDF. Si está creando una aplicación web o de consola, integrará la lógica de IronPDF directamente en sus controladores, servicios o clases.

Vaya a la ToolBox de Visual Studio (Ver > ToolBox). Arrastre y suelte los siguientes controles en su superficie de diseño Form1:

• Un Label (por ejemplo, para titular su aplicación "Demostración del generador de PDF en C#").
• Un RichTextBox (llámelo PdfText) para ingresar HTML/texto.
• Un TextBox (nómbrelo URL) para ingresar una URL.

• Dos controles Button.

  • Establezca el texto del primer botón en "Generar PDF desde texto" (nómbrelo GeneratePDFFromTextButton).
  • Establezca el texto del segundo botón en "Generar PDF desde URL" (nómbrelo GeneratePDFFromURLButton).

Paso 4: Escribir código en C# para generar archivos PDF a partir de texto/HTML

Ahora, añadamos la lógica de C#. Haga doble clic en el botón "Generar PDF desde texto" (GeneratePDFFromTextButton) en el diseñador de formularios. Esto creará un método controlador de eventos en su archivo Form1.cs.

Primero, agregue el espacio de nombres IronPDF en la parte superior de su archivo Form1.cs:

using IronPdf;

using IronPdf;

Luego, implemente el controlador de eventos click del botón. Este código tomará texto (que puede ser texto simple o HTML) de RichTextBox y lo convertirá en un documento PDF.

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

Explicación del código de generación de PDF de C#:

• IronPdf.License.LicenseKey: Es una buena práctica configurar su clave de licencia de IronPDF . Si tiene una, descomente la línea y reemplace "YourLicenseKey..." con su clave real. IronPDF funciona sin clave de licencia, pero los documentos tendrán una marca de agua después del periodo de prueba.
• SaveFileDialog: Esto proporciona un cuadro de diálogo estándar de Windows para que el usuario elija la ubicación de guardado y el nombre de archivo para su PDF.
• ChromePdfRenderer: Este es el corazón de la capacidad de HTML a PDF de IronPDF. Utiliza un motor Chromium integrado para lograr la máxima fidelidad.
• RenderHtmlAsPdf(PdfText.Text): Esta única llamada de método toma el contenido de la cadena de su RichTextBox (que puede ser HTML enriquecido) y lo convierte en un objeto de documento PDF.
• SaveAs(filename): Este método guarda el documento PDF generado en la ruta especificada por el usuario.
• El uso de la declaración using para pdfDocument garantiza que los recursos se administren correctamente.

Observe cómo IronPDF simplifica una tarea potencialmente compleja como la conversión de HTML a PDF en sólo un par de líneas clave de código. Esta es una ventaja significativa para los desarrolladores que necesitan generar PDF C# de forma rápida y fiable.

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

Paso 5: Escribir código en C# para generar archivos PDF a partir de una URL

Otro requisito habitual es generar un PDF a partir de una página web. IronPDF hace que esto sea así de sencillo. Haga doble clic en el botón "Generar PDF DESDE URL" (GeneratePDFFromURLButton) en el diseñador de formularios para crear su controlador de evento de clic.

Añada el siguiente código C#:

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

Explicación:

• URL.Text: Esto toma la cadena URL del control TextBox en su formulario.
• RenderUrlAsPdf(URL.Text): Este poderoso método IronPDF navega a la URL dada, renderiza su contenido (incluyendo HTML, CSS, JavaScript e imágenes) y lo convierte en un documento PDF.
• Se incluye el manejo de errores (try-catch) para mayor robustez, ya que pueden ocurrir problemas de red o URL no válidas.

Conclusión: Simplifique su generación de PDF en C# con IronPDF

Como demuestra este tutorial, IronPDF proporciona una solución muy potente y sencilla para todas sus necesidades de generación de PDF en C#. Tanto si está convirtiendo páginas HTML complejas con CSS y JavaScript intrincados, como si está generando informes dinámicos a partir de datos, creando PDF a partir de URL en directo o necesita sólidas capacidades de edición de PDF dentro de sus aplicaciones .NET, IronPDF ofrece las herramientas y el rendimiento necesarios para realizar el trabajo de forma eficiente.

Cuando generas proyectos PDF en C#, a menudo tienes que elegir entre bibliotecas gratuitas que pueden tener limitaciones en cuanto a fidelidad de representación o conjuntos de funciones, o soluciones más complejas que requieren un código repetitivo importante. IronPDF se distingue por ser una biblioteca PDF .NET completa y con soporte comercial que agiliza el desarrollo, garantiza un resultado de alta calidad y proporciona un amplio conjunto de funciones que van más allá de la creación básica de PDF.

¿Preparado para experimentar la mejor forma de generar y manipular archivos PDF en C#?

• Inicie hoy mismo su prueba GRATUITA de IronPDF
• Documentación detallada y más ejemplos
• Ver opciones de licencia
• Descubra Iron Suite: Obtenga más herramientas .NET por menos (Iron Suite incluye varias bibliotecas .NET, lo que ofrece un gran valor si trabaja con otros formatos de documentos o tareas)

Al elegir IronPDF, está equipando sus proyectos de C# con un motor líder de generación y manipulación de PDF, ahorrando un valioso tiempo de desarrollo y garantizando documentos PDF de calidad profesional y con píxeles perfectos en todo momento. Obtenga más información sobre la conversión de HTML a PDF en C# con esta guía detallada.