Saltar al pie de página
USANDO IRONPDF

Cómo Convertir Imagen a PDF en C# [Tutorial de Ejemplo de Código]

Numerosas bibliotecas permiten a los desarrolladores de C# convertir imágenes en PDFs. Encontrar una biblioteca gratuita, amigable para el usuario y con buen rendimiento puede ser un desafío, ya que algunas son de pago, complejas o limitadas en funcionalidad. Entre estas bibliotecas, IronPDF se destaca como una biblioteca gratuita, eficiente y fácil de implementar para C#. Viene con documentación completa y un equipo de soporte profesional y receptivo.

IronPDF es una biblioteca .NET para generar, leer, editar y guardar archivos PDF en proyectos .NET. IronPDF permite convertir HTML a PDF para .NET 5, Core, Standard y Framework con soporte completo, incluyendo CSS3 y JS.

Echemos un vistazo a cómo crear un proyecto de ejemplo para aprender a convertir imágenes a PDF.

Crear un proyecto de Visual Studio

Para crear un nuevo proyecto, abre Microsoft Visual Studio. Se recomienda usar la versión más reciente de Visual Studio. Los pasos para crear un nuevo proyecto pueden variar entre versiones, pero el resto debería ser el mismo para cada versión.

  1. Haz clic en Crear Nuevo Proyecto.
  2. Selecciona Plantilla de Proyecto, luego selecciona la plantilla de Aplicación de Consola para esta demostración. Puedes usar cualquier otra según tus necesidades.
  3. Haz clic en Siguiente. Nombra el Proyecto.
  4. Haz clic en Siguiente y selecciona la versión del .NET Framework.
  5. Haz clic en el botón Crear.

El nuevo proyecto se creará como se muestra a continuación.

Cómo Convertir Imagen a PDF en C# [Ejemplo de Código Tutorial], Figura 1: Crear una nueva Aplicación de Consola en Visual Studio Crear una nueva Aplicación de Consola en Visual Studio

A continuación, instala el Paquete NuGet de IronPDF en este proyecto para usar sus funcionalidades. Lo interesante de IronPDF es que elimina la frustración de generar documentos PDF al no depender de APIs propietarias. Ejemplo de renderizado de HTML a PDF genera PDFs de pixel perfectos desde tipos de documentos estándares abiertos: HTML, JS, CSS, JPG, PNG, GIF y SVG. En resumen, utiliza las habilidades que los desarrolladores ya poseen.

Instalar el paquete IronPDF NuGet

Para instalar el Paquete NuGet, ve a Herramientas > Administrador de Paquetes NuGet > Consola del Administrador de Paquetes. Aparecerá la siguiente ventana:

Cómo Convertir Imagen a PDF en C# [Ejemplo de Código Tutorial], Figura 2: UI de la Consola del Administrador de Paquetes IU de la Consola del Administrador de Paquetes

A continuación, escribe el siguiente comando en la Consola del Administrador de Paquetes:

Install-Package IronPdf

Presione Enter.

Cómo Convertir Imagen a PDF en C# [Ejemplo de Código Tutorial], Figura 3: Instalar el paquete IronPdf en la Consola del Administrador de Paquetes Instalar el paquete IronPdf en la Consola del Administrador de Paquetes

Convertir un archivo de imagen en un documento PDF

El siguiente paso mostrará cómo convertir la siguiente imagen a PDF.

Imagen de ejemplo

Cómo Convertir Imagen a PDF en C# [Ejemplo de Código Tutorial], Figura 4: La imagen de ejemplo La imagen de ejemplo

Para utilizar la biblioteca, referencia la biblioteca IronPDF en el archivo program.cs. Escribe el siguiente fragmento de código al inicio del archivo.

using IronPdf;
using IronPdf;
Imports IronPdf
$vbLabelText   $csharpLabel

A continuación, escriba el siguiente código dentro de la función principal. Esto convertirá un archivo JPG a un archivo PDF.

public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);
    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");
}
public static void Main(string[] args)
{
    // Convert a single image to the PDF document
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);
    // Save the resulting PDF to the specified path
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");
}
Public Shared Sub Main(ByVal args() As String)
	' Convert a single image to the PDF document
	Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf("D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage)
	' Save the resulting PDF to the specified path
	doc.SaveAs("D:\Iron Software\ImageToPDF\bird.pdf")
End Sub
$vbLabelText   $csharpLabel

En el ejemplo de código anterior, se utiliza la clase ImageToPdfConverter proporcionada por IronPDF para la conversión de imágenes. El método ImageToPdf se puede usar para crear documentos PDF a partir de imágenes. Acepta tanto archivos de imagen como un objeto System.Drawing como entrada.

El método estático ImageToPdf convierte un único archivo de imagen en un documento PDF idéntico de dimensiones coincidentes. Toma dos argumentos: Ruta de la Imagen y Comportamiento de la Imagen (cómo se mostrará la imagen en el papel). Imaging.ImageBehavior.CropPage establecerá el tamaño del papel igual al tamaño de la imagen. El tamaño de página predeterminado es A4. Puedes configurarlo mediante la siguiente línea de código:

ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;
ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;
ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter
$vbLabelText   $csharpLabel

Se ofrecen múltiples opciones de tamaño de página, y puedes establecerlas según tus necesidades.

Convertir varias imágenes en un archivo PDF

El siguiente ejemplo convertirá imágenes JPG en un nuevo documento.

public static void Main(string[] args)
{
    // Enumerate and filter JPG files from the specified directory
    var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
                                        .Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));
    // Convert the images to a PDF document and save it
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(imageFiles);
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\JpgToPDF.pdf");
}
public static void Main(string[] args)
{
    // Enumerate and filter JPG files from the specified directory
    var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
                                        .Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));
    // Convert the images to a PDF document and save it
    PdfDocument doc = ImageToPdfConverter.ImageToPdf(imageFiles);
    doc.SaveAs(@"D:\Iron Software\ImageToPDF\JpgToPDF.pdf");
}
Public Shared Sub Main(ByVal args() As String)
	' Enumerate and filter JPG files from the specified directory
	Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))
	' Convert the images to a PDF document and save it
	Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf(imageFiles)
	doc.SaveAs("D:\Iron Software\ImageToPDF\JpgToPDF.pdf")
End Sub
$vbLabelText   $csharpLabel

En el código anterior, System.IO.Directory.EnumerateFiles recupera todos los archivos disponibles en la carpeta especificada. La cláusula Where filtra todas las imágenes JPG de esa carpeta y las almacena en la colección imageFiles. Si tienes PNG u otro formato de imagen, puedes añadirlo a la consulta Where.

La siguiente línea tomará todas las imágenes y las combinará en un único documento PDF.

Imprimir archivo PDF

El siguiente fragmento de código imprimirá el documento:

doc.Print();
doc.Print();
doc.Print()
$vbLabelText   $csharpLabel

El método Print proporcionado por la clase PdfDocument imprimirá el documento usando la impresora predeterminada. También proporciona una opción para cambiar el nombre de la impresora y otras configuraciones. Para más detalles sobre la impresión de documentos, visita este ejemplo de impresión de PDF.

Resumen

Este tutorial mostró una manera muy fácil de convertir imágenes en un archivo PDF con ejemplos de código, ya sea convirtiendo una sola imagen en un PDF o combinando múltiples imágenes en un solo archivo PDF. Además, también explicó cómo imprimir documentos con una sola línea de código.

Además, algunas de las características importantes de IronPDF incluyen:

Hay múltiples características útiles e interesantes proporcionadas por IronPDF, por favor visita esta página principal de IronPDF para más detalles.

IronPDF es parte de la suite de Iron Software. El Iron Suite incluye productos adicionales interesantes como IronXL, IronBarcode, IronOCR, e IronWebscraper, y todos estos productos son extremadamente útiles. Puede ahorrar hasta un 250% al comprar la suite completa de Iron, ya que actualmente puede obtener los cinco productos por el precio de solo dos. Por favor visita la página de detalles de licencias para más detalles.

Preguntas Frecuentes

¿Cómo puedo convertir una imagen a un PDF en C#?

Puedes convertir una imagen a un PDF en C# usando el método ImageToPdf de IronPDF. Este método te permite especificar la ruta de la imagen y los ajustes deseados de salida en PDF.

¿Se pueden convertir múltiples imágenes en un solo archivo PDF?

Sí, IronPDF te permite convertir múltiples imágenes en un solo archivo PDF utilizando el método ImageToPdf, donde proporcionas una colección de archivos de imagen.

¿Qué formatos de imagen son compatibles con la conversión a PDF?

IronPDF soporta la conversión de varios formatos de imagen como JPG, PNG, GIF y SVG en documentos PDF.

¿Cómo establezco el tamaño de página al convertir una imagen a un PDF?

Para establecer el tamaño de página durante la conversión, usa la propiedad PaperSize dentro de la clase ImageToPdfConverter para seleccionar un tamaño estándar como Carta o A4.

¿Es posible imprimir un documento PDF creado con IronPDF?

Sí, IronPDF incluye un método Print dentro de la clase PdfDocument que te permite imprimir documentos PDF utilizando configuraciones de impresora predeterminadas o especificadas.

¿Qué características adicionales ofrece IronPDF?

IronPDF proporciona características adicionales como generar PDFs desde URLs, encriptar y desencriptar PDFs, fusionar archivos PDF y crear y editar formularios PDF.

¿Cómo instalo IronPDF en un proyecto de Visual Studio?

Para instalar IronPDF en un proyecto de Visual Studio, abre la Consola de Administrador de Paquetes y ejecuta el comando Install-Package IronPdf.

¿Cuáles son las ventajas de usar IronPDF para la generación de PDFs?

IronPDF ofrece una API simple, eficiente y bien documentada para la generación de PDFs sin depender de APIs propietarias. También proporciona soporte profesional y maneja varias tareas de PDF de manera efectiva.

¿IronPDF es compatible con .NET 10 y cómo lo uso para la conversión de imágenes a PDF en un proyecto .NET 10?

Sí. IronPDF es totalmente compatible con .NET 10 y permite convertir imágenes a PDF en proyectos .NET 10 de forma predeterminada. Para usarlo, instale el paquete NuGet IronPdf en su proyecto .NET 10 y, a continuación, invoque métodos como ImageToPdfConverter.ImageToPdf("path/to/image.png") para convertir una sola imagen, o pase un IEnumerable de rutas de imagen para convertir varias imágenes. También puede especificar opciones como ImageBehavior o de renderizado mediante ChromePdfRenderOptions para personalizarlo. Esto funciona igual que en versiones anteriores de .NET.

Curtis Chau
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 ...

Leer más