USO DE IRONPDF

Visor de PDF C# Aplicación Windows (Tutorial)

Actualizado 21 de agosto, 2024
Compartir:

En la era digital actual, los archivos PDF se han convertido en una parte esencial de nuestra rutina diaria. Se utilizan en muchos campos, como la educación, la empresa, el uso personal, etc. Los archivos PDF pueden contener una gran cantidad de datos, incluyendo texto, imágenes y tablas, lo que los convierte en un formato ideal para compartir y presentar datos.

Sin embargo, mostrar documentos PDF en una aplicación Windows Forms puede resultar complicado. Este artículo le mostrará cómo crear una sencilla aplicación de visor de PDF utilizando IronPDF, una biblioteca de PDF en C# para desarrolladores .NET.

¿Qué es IronPDF?

IronPDF es una biblioteca de C# que permite a los desarrolladores crear, editar y mostrar archivos PDF en sus aplicaciones .NET. Permite a los usuarios convertir HTML, imágenes y SVG en documentos PDF y viceversa. IronPDF es fácil de usar y ofrece a los desarrolladores una amplia gama de funciones para manipular archivos PDF.

Requisitos

Para crear una aplicación de visor de PDF, necesitará las siguientes herramientas y paquetes:

Visual Studio: Un IDE de desarrollo de software(Entorno de desarrollo integrado) utilizado para crear aplicaciones Windows Forms.

IronPDF: Un paquete NuGet que proporciona funcionalidad para leer, crear y manipular documentos PDF.

Visor de PDF Aplicación C# Windows (Tutorial), Figura 1: HTML a PDF

De HTML a PDF

Pasos para crear una aplicación Windows de visor de PDF con IronPDF

Paso 1 Crear una nueva aplicación Windows Forms en Visual Studio

Para crear una nueva aplicación Windows Forms, inicie Visual Studio y haga clic en "Crear un nuevo proyecto". A continuación, seleccione "Windows Forms App(.NET Framework)" de la lista de plantillas de proyecto.

Visor PDF C# Aplicación Windows(Tutorial), Figura 2: Visual Studio Code

Código Visual Studio

A continuación, introduzca un nombre para su proyecto y haga clic en el botón Crear. Esto creará un nuevo proyecto de Aplicación Windows Forms en Visual Studio.

Paso 2 Instalar IronPDF

Uso del gestor de paquetes NuGet

Para instalar IronPDF, haga clic con el botón derecho en su proyecto en el explorador de soluciones y seleccione "Administrar paquetes NuGet" Esto abrirá el gestor de paquetes NuGet, donde puede buscar IronPDF.

Visor PDF C# Aplicación Windows(Tutorial), Figura 3: Gestor de paquetes NuGet

Gestor de paquetes NuGet

Uso de la consola del gestor de paquetes NuGet

Un método alternativo es instalarlo a través de la consola del gestor de paquetes NuGet. Para ello, ejecute el siguiente comando en la consola:

Install-Package IronPdf

Una vez que haya encontrado IronPDF, haga clic en el botón "Instalar" para añadirlo a su proyecto. Esto instalará IronPDF y todas sus dependencias.

Paso 3 Añada un RichTextBox a su formulario

Añadiremos un RichTextBox en nuestro formulario. Este RichTextBox se utilizará para mostrar el contenido del PDF. Un RichTextBox es un contenedor que permite mostrar o editar contenido de texto enriquecido, incluidos párrafos, hipervínculos, etc. También puede utilizar un RichTextBox para mostrar contenido PDF, aunque es posible que no conserve todo el formato del documento PDF original.

Así es como puede añadir un RichTextBox a su archivo de diseño CS:

  1. En la caja de herramientas(normalmente situado en el lateral del IDE de Visual Studio)Amplíe la sección "Controles comunes".

  2. Busque el control "RichTextBox" y haga clic sobre él.

  3. Vuelva a su formulario en el Diseñador, y debería ver que su cursor ha cambiado a una cruz. Haga clic y arrastre para crear un nuevo RichTextBox en el formulario.

  4. Puede ajustar el tamaño y la posición del RichTextBox seleccionándolo y arrastrando las esquinas o los bordes.

  5. En la ventana Propiedades(normalmente situado al otro lado del IDE)puede definir las propiedades del RichTextBox, como su nombre(para que puedas hacer referencia a él en tu código).

    Visor PDF C# Aplicación Windows(Tutorial), Figura 4: Acceso al RickTextBox en Form1

    Accede al RickTextBox en Form1

Paso 4 Añadir un botón para seleccionar PDF

Ahora tenemos que añadir un botón, que ayudará a seleccionar un archivo PDF utilizando la ventana Examinar.

Visor PDF C# Aplicación Windows(Tutorial), Figura 5: Añadir un nuevo Botón al Formulario1

Añadir un nuevo Botón al Formulario1

Paso 4 Añadir código detrás del botón

Ahora haz doble clic en el botón. Se abrirá el archivo de código fuente. En primer lugar, tendrás que añadir la siguiente sentencia using al principio de tu archivo Form1.cs:

using IronPdf;
using IronPdf;
Imports IronPdf
VB   C#

Paso 5 Crear un evento para gestionar la carga de archivos PDF

El código proporcionado es un controlador de eventos para un evento de clic de botón en una aplicación Windows Forms que utiliza la biblioteca IronPDF para cargar un archivo PDF y extraer su contenido de texto.

private void openBtn_Click(object sender, EventArgs e)
{
    var openFileDialog = new OpenFileDialog();
    openFileDialog.Filter = "PDF files (*.pdf)
*.pdf
All files (*.*)
*.*";
    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        try 
        {
            License.LicenseKey = "YourKey";
            var pdf = PdfDocument.FromFile(openFileDialog.FileName);
            pdfData.Text = pdf.ExtractAllText();
        }
        catch (Exception ex)
        {
            MessageBox.Show("An error occurred while processing the PDF file: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }

    }
}
private void openBtn_Click(object sender, EventArgs e)
{
    var openFileDialog = new OpenFileDialog();
    openFileDialog.Filter = "PDF files (*.pdf)
*.pdf
All files (*.*)
*.*";
    if (openFileDialog.ShowDialog() == DialogResult.OK)
    {
        try 
        {
            License.LicenseKey = "YourKey";
            var pdf = PdfDocument.FromFile(openFileDialog.FileName);
            pdfData.Text = pdf.ExtractAllText();
        }
        catch (Exception ex)
        {
            MessageBox.Show("An error occurred while processing the PDF file: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }

    }
}
Private Sub openBtn_Click(ByVal sender As Object, ByVal e As EventArgs)
	Dim openFileDialog As New OpenFileDialog()
	openFileDialog.Filter = "PDF files (*.pdf) *.pdf All files (*.*) *.*"
	If openFileDialog.ShowDialog() = DialogResult.OK Then
		Try
			License.LicenseKey = "YourKey"
			Dim pdf = PdfDocument.FromFile(openFileDialog.FileName)
			pdfData.Text = pdf.ExtractAllText()
		Catch ex As Exception
			MessageBox.Show("An error occurred while processing the PDF file: " & ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
		End Try

	End If
End Sub
VB   C#

Aquí tienes un desglose detallado del código:

Este es el manejador de eventos para el evento 'Click' de un botón llamado 'openBtn'. Cada vez que se pulsa este botón, se activa este método.

private void openBtn_Click(object sender, EventArgs e)
private void openBtn_Click(object sender, EventArgs e)
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'private void openBtn_Click(object sender, EventArgs e)
VB   C#

Esta línea inicializa una nueva instancia de la clase OpenFileDialog, que es un diálogo estándar que permite al usuario abrir un archivo.

var openFileDialog = new OpenFileDialog();
var openFileDialog = new OpenFileDialog();
Dim openFileDialog As New OpenFileDialog()
VB   C#

Esta línea establece la propiedad Filter del OpenFileDialog para mostrar sólo archivos PDF y todos los tipos de archivo en el cuadro de diálogo de archivo.

openFileDialog.Filter = "PDF files (*.pdf)
*.pdf
All files (*.*)
*.*";
openFileDialog.Filter = "PDF files (*.pdf)
*.pdf
All files (*.*)
*.*";
openFileDialog.Filter = "PDF files (*.pdf) *.pdf All files (*.*) *.*"
VB   C#

El ShowDialog()muestra elOpenFileDialogal usuario. Si el usuario selecciona un archivo y hace clic en el botón "Abrir" del cuadro de diálogo,ShowDialog()devuelve DialogResult.OK. Esta línea comprueba si el usuario ha hecho precisamente eso.

if (openFileDialog.ShowDialog() == DialogResult.OK)
if (openFileDialog.ShowDialog() == DialogResult.OK)
If openFileDialog.ShowDialog() = DialogResult.OK Then
VB   C#

Si el usuario selecciona un fichero y pulsa 'Abrir', esta línea obtiene la ruta del fichero seleccionado de la propiedad FileName del OpenFileDialog. A continuación, utiliza elDesdeArchivo método delDocumentoPdf de la biblioteca IronPDF para crear un nuevo objeto PdfDocument que represente el archivo PDF seleccionado.

var pdf = PdfDocument.FromFile(openFileDialog.FileName);
var pdf = PdfDocument.FromFile(openFileDialog.FileName);
Dim pdf = PdfDocument.FromFile(openFileDialog.FileName)
VB   C#

Esta línea llama alExtraerTodoTexto en el objeto PdfDocument para extraer todo el texto del archivo PDF. A continuación, asigna el texto extraído a la propiedad Text de un control llamado pdfData, que presumiblemente es un TextBox o control similar que puede mostrar texto.

pdfData.Text = pdf.ExtractAllText();
pdfData.Text = pdf.ExtractAllText();
pdfData.Text = pdf.ExtractAllText()
VB   C#

En resumen, este método abre un diálogo de archivo para que el usuario seleccione un archivo PDF. Si el usuario selecciona un archivo y hace clic en 'Abrir', el método carga el archivo PDF, extrae todo el texto del mismo y muestra el texto extraído en un control.

Paso 6 Cree y ejecute la aplicación

Una vez que haya completado todos los pasos anteriores, puede crear y ejecutar su aplicación de visor de PDF. Para ello, haga clic en el menú "Crear" de Visual Studio y seleccione "Crear solución". Después de construir la solución, puede ejecutar la aplicación pulsando la tecla "F5" o haciendo clic en el botón "Inicio" de la barra de herramientas.

Cuando se inicie la aplicación, debería ver un formulario con RichTextBox y un botón. Para abrir un archivo PDF, haz clic en el botón "Abrir PDF", selecciona un archivo PDF de tu ordenador y haz clic en el botón "Abrir".

Visor PDF C# Aplicación Windows(Tutorial), Figura 6: Ejecutar la aplicación

**Ejecutar la aplicación

Una vez seleccionado el archivo PDF, su contenido aparecerá en la RichTextBox.

Visor PDF C# Aplicación Windows(Tutorial), Figura 7: Mostrar el contenido del texto después de seleccionar un archivo PDF

Visualizar el contenido del texto tras seleccionar un archivo PDF

Aprende a utilizar el visor de PDF en MAUI visitando la página "Tutorial de visualización de PDF en MAUI".

Conclusión

Siguiendo estos pasos, puede crear una sencilla aplicación de visor de PDF que permita a los usuarios ver contenido en PDF. Con la biblioteca IronPDF, también puede añadir funciones más avanzadas, como la búsqueda de texto,añadir anotaciones a PDFyimprimir documentos PDF así comoCifrado y descifrado de PDF yedición de formularios PDF.

Recuerde que esto es sólo un simple ejemplo de lo que puede hacer con IronPDF. Puede experimentar con diferentes controles, propiedades y eventos para crear su aplicación de visor de PDF personalizada que satisfaga sus necesidades específicas.

Si está interesado en obtener más información sobre IronPDF, asegúrese de consultar la página webDocumentación de IronPDFel objetivo es proporcionar información detallada sobre cómo utilizar la biblioteca e incluir numerosos ejemplos y tutoriales.

Para utilizar IronPDF en su aplicación, debe disponer de una clave de licencia válida. Puede obtener una clave de licencia comprando unlicencia del sitio web de IronPDF. Las licencias cuestan a partir de $749 y también se puede disfrutar de una versión de prueba gratuita.

< ANTERIOR
Cómo leer una tabla PDF en C#
SIGUIENTE >
Cómo convertir Word a PDF en C# (Tutorial)

¿Listo para empezar? Versión: 2024.12 acaba de salir

Descarga gratuita de NuGet Descargas totales: 11,622,374 Ver licencias >