Cómo convertir imágenes a PDF en C#

Updated: 5 de septiembre de 2026

IronPDF permite a los desarrolladores C# convertir una o varias imágenes (JPG, PNG, TIFF) en documentos PDF utilizando el método ImageToPdfConverter.ImageToPdf con comportamientos de colocación y opciones de renderización personalizables.

La conversión de imágenes a PDF combina varios archivos de imagen (como JPG, PNG o TIFF) en un único documento PDF. Este proceso crea carteras digitales, presentaciones o informes, lo que facilita compartir y almacenar colecciones de imágenes en un formato organizado y universalmente legible.

IronPDF convierte imágenes individuales o múltiples en PDF con ubicaciones y comportamientos de imagen únicos. Estos comportamientos incluyen ajustar a la página, centrar en la página y recortar la página. Además, puedes añadir encabezados y pies de página de texto y HTML usando IronPDF, aplicar marcas de agua con IronPDF, establecer tamaños de página personalizados e incluir superposiciones de fondo y primer plano.

Inicio rápido: Convertir imágenes a PDF con IronPDF

Convierte imágenes en documentos PDF usando la clase ImageToPdfConverter de IronPDF. Este ejemplo muestra cómo transformar un archivo de imagen en un PDF, lo que le permite integrar la funcionalidad de imagen a PDF en sus aplicaciones .NET C#. Con un código mínimo, se pueden convertir imágenes a PDF para crear carteras digitales o informes.

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

2Copie y ejecute este fragmento de código.

IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");

IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");

3Despliegue para probar en su entorno real

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

Flujo de trabajo mínimo (5 pasos)

Descargue la biblioteca IronPDF C# para convertir imágenes a PDF
Prepara la imagen o las imágenes que quieras convertir
Proporcione la(s) ruta(s) de la(s) imagen(es) al método estático ImageToPdf
Ajusta la colocación y el comportamiento de las imágenes en el PDF resultante
Añade texto y encabezados y pies de página HTML personalizados usando IronPDF

¿Cómo convierto una sola imagen a PDF?

Utilice el método estático ImageToPdf dentro de la clase ImageToPdfConverter para convertir una imagen a un documento PDF. Este método sólo requiere la ruta de archivo de la imagen y la convierte en un documento PDF con la ubicación y el comportamiento predeterminados de la imagen. Los formatos de imagen compatibles incluyen .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp y .pjpeg.

Antes de empezar, asegúrese de haber instalado IronPDF a través de NuGet o descargado el instalador de Windows. La biblioteca funciona sin problemas en las plataformas Windows, macOS y Linux, lo que la hace versátil para diversos entornos de desarrollo.

¿Qué formatos de imagen se admiten?

Miembros del equipo de Iron Software en uniformes morados en un evento de la empresa

IronPDF admite una amplia gama de formatos de imagen, incluidos formatos de trama como JPEG, PNG, BMP y GIF, así como formatos vectoriales como gráficos SVG. La biblioteca maneja formatos estándar y modernos como WebP y AVIF, lo que garantiza la compatibilidad con las aplicaciones web contemporáneas. Para necesidades especializadas, trabaje con archivos de iconos (.ico) y archivos de cursor (.cur).

¿Cómo escribo el código?

using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")

Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")

Para escenarios más avanzados, explore generación asíncrona de PDF para mejorar el rendimiento al procesar varias imágenes. La biblioteca también admite tamaños de papel personalizados y margenes personalizados para garantizar que las imágenes se muestren exactamente como se necesitan.

¿Qué aspecto tiene el resultado?

¿Cómo convertir varias imágenes a PDF?

Para convertir múltiples imágenes en un documento PDF, proporcione un objeto IEnumerable que contenga rutas de archivo en lugar de una única ruta de archivo. Esto genera un documento PDF con la colocación y el comportamiento de las imágenes por defecto.

Cuando trabaje con varias imágenes, tenga en cuenta las opciones de compresión de PDF disponibles para optimizar el tamaño del archivo sin sacrificar la calidad. Esto es especialmente importante a la hora de crear grandes portafolios o álbumes de fotos.

¿Cómo puedo procesar varias imágenes a la vez?

using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");

using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");

Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the PDF
pdf.SaveAs("imagesToPdf.pdf")

Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the PDF
pdf.SaveAs("imagesToPdf.pdf")

¿Qué aspecto tiene el PDF de varias imágenes?

Mi biblioteca favorita de este tipo es IronPDF. Permite una manipulación rápida y eficiente de archivos PDF. También tiene muchas funciones valiosas, como exportar al formato PDF/A y firmar documentos PDF digitalmente.

Milan Jovanovic

Microsoft MVP

Ver estudio de caso

IronOCR significa que podemos ahorrar $40,000 anualmente en el procesamiento manual, mientras mejoramos la productividad y liberamos recursos para tareas de alto impacto. Lo recomendaría encarecidamente.

Brent Matzelle

Director de Tecnología, OPYN

Ver estudio de caso

¿Cómo puedo controlar la colocación y el comportamiento de las imágenes?

IronPDF ofrece varias opciones de colocación y comportamiento de las imágenes. Puede centrar la imagen en la página o ajustarla al tamaño de la página manteniendo su relación de aspecto. Todas las imágenes y comportamientos disponibles son:

TopLeftCornerOfPage: La imagen se coloca en la esquina superior izquierda de la página.
TopRightCornerOfPage: La imagen se coloca en la esquina superior derecha de la página.
CenteredOnPage: La imagen está centrada en la página.
FitToPageAndMaintainAspectRatio: La imagen se ajusta a la página manteniendo su proporción original.
BottomLeftCornerOfPage: La imagen se coloca en la esquina inferior izquierda de la página.
BottomRightCornerOfPage: La imagen se coloca en la esquina inferior derecha de la página.
FitToPage: La imagen se ajusta a la página.
CropPage: La página se ajusta para adaptarse a la imagen.

Estas opciones de colocación funcionan a la perfección con las funciones orientación y rotación de página de IronPDF, lo que permite crear documentos de aspecto profesional independientemente de las dimensiones de la imagen.

¿Cómo aplico comportamientos de imagen en el código?

using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");

Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF with image behavior of centered on page
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")

Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF with image behavior of centered on page
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")

¿Cuáles son las diferencias visuales entre los comportamientos de imagen?

`Esquina superior izquierda de la página`	`Esquina superior derecha de la página`
`CenteredOnPage`	`FitToPageAndMaintainAspectRatio`
`BottomLeftCornerOfPage`	`BottomRightCornerOfPage`
`FitToPage`	`CropPage`

¿Cómo personalizar las opciones de renderizado de PDF?

El método estático ImageToPdf convierte imágenes importándolas como etiquetas <img> HTML y luego convirtiendo el HTML a PDF. Esto le permite pasar el objeto ChromePdfRenderOptions como un tercer parámetro para personalizar el proceso de renderización directamente.

Este enfoque proporciona acceso a todas las potentes opciones de renderizado disponibles en IronPDF, incluida la ejecución de JavaScript, los tipos de medios CSS y la configuración de la ventana gráfica. Incluso puede incorporar fuentes e iconos web para mejorar el atractivo visual del documento.

¿Cómo añado cabeceras y estilos personalizados?

using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");

using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");

Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

' Convert an image to a PDF with custom header
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, options:= options)

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")

Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

' Convert an image to a PDF with custom header
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, options:= options)

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")

Para requisitos de encabezado y pie de página más complejos, explore nuestra completa guía sobre Cabezados y pies de página HTML. También puede añadir números de página a sus PDF basados en imágenes para una mejor organización.

¿Qué aspecto tiene el resultado personalizado?

¿Cómo gestionar el rendimiento y las grandes colecciones de imágenes?

Cuando se trabaja con grandes colecciones de imágenes o imágenes de alta resolución, se deben aplicar técnicas async y multithreading para mejorar el rendimiento. Para aplicaciones empresariales, explore las estrategias de optimización del rendimiento de IronPDF para garantizar un funcionamiento sin problemas incluso con cargas de trabajo considerables.

Además, cuando trabajes con imágenes almacenadas en servicios en la nube, consulta nuestra guía sobre incorporación de imágenes de Azure Blob Storage para una integración perfecta en la nube.

¿Cómo puedo volver a convertir archivos PDF en imágenes?

Para convertir o rasterizar un documento PDF en imágenes, consulte nuestra guía sobre cómo rasterizar PDF en imágenes.

¿Listo para ver qué más puedes hacer? Consulta nuestra página de tutoriales aquí: Convertir PDFs

Preguntas Frecuentes

¿Qué formatos de imagen se pueden convertir a PDF?

IronPDF admite una amplia gama de formatos de imagen para la conversión de PDF, incluidos .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp y .pjpeg. Esto incluye tanto formatos de trama como JPEG, PNG, BMP y GIF, como formatos vectoriales como gráficos SVG.

¿Cómo convierto una sola imagen a PDF en C#?

Para convertir una sola imagen a PDF utilizando IronPDF, utilice el método estático ImageToPdf dentro de la clase ImageToPdfConverter. Simplemente proporcione la ruta del archivo de su imagen: IronPdf.ImageToPdfConverter.ImageToPdf("ruta/a/imagen.png").SaveAs("imagenaPdf.pdf"). Esta solución de una sola línea convierte su imagen en un documento PDF con la colocación y el comportamiento predeterminados.

¿Puedo convertir varias imágenes en un solo documento PDF?

Sí, IronPDF permite convertir varias imágenes (JPG, PNG, TIFF) en un único documento PDF mediante el método ImageToPdfConverter.ImageToPdf. Esto es perfecto para crear portafolios digitales, presentaciones o informes en los que necesite combinar varios archivos de imagen en un formato PDF organizado y de lectura universal.

¿Qué opciones de personalización están disponibles al convertir imágenes a PDF?

IronPDF ofrece amplias opciones de personalización, como la colocación y el comportamiento únicos de las imágenes (ajuste a la página, centrado, recorte), la adición de encabezados y pies de página de texto y HTML, la aplicación de marcas de agua, la configuración de tamaños de página personalizados y la inclusión de superposiciones de fondo y primer plano. Estas funciones le permiten crear documentos PDF de aspecto profesional a partir de sus imágenes.

¿Qué plataformas admite la función de conversión de imágenes a PDF?

La conversión de imágenes a PDF de IronPDF funciona a la perfección en plataformas Windows, macOS y Linux, lo que la hace versátil para diversos entornos de desarrollo. Puede instalarlo a través de NuGet o descargar el instalador de Windows para empezar en su plataforma preferida.

¿Cómo puedo controlar la ubicación de las imágenes al convertirlas a PDF?

IronPDF proporciona colocaciones y comportamientos de imagen únicos que incluyen el ajuste a la página, el centrado en la página y el recorte de la página. Estos comportamientos de exportación de imágenes le proporcionan un control preciso sobre cómo aparecen sus imágenes en el documento PDF final, garantizando una presentación profesional de su contenido visual.

What are the rendering customization options available in IronPDF?

IronPDF allows you to use the `ChromePdfRenderOptions` object to customize the rendering process. This includes options like JavaScript execution, CSS media types, and custom headers. You can also incorporate web fonts and icons for a more polished document.

Is it possible to convert a PDF back to an image using IronPDF?

Yes, IronPDF supports converting or rasterizing PDF documents back into images. This can be useful for various applications that require different formats for distribution or presentation.

Can IronPDF work on different operating systems?

IronPDF is versatile and can operate across Windows, macOS, and Linux environments, making it an excellent choice for various development platforms.

How do I optimize PDF size when combining multiple images using IronPDF?

IronPDF offers PDF compression options to optimize the file size when merging multiple images. It's especially useful when creating large digital portfolios or photo albums, ensuring quality is maintained without large file sizes.

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.

...

¿Listo para empezar?

Nuget Downloads 21,105,021|Versión:2026.9recién publicada

Descarga Gratis de NuGet

Descargas totales: 21,105,021

Ver Licencias

Cómo convertir imágenes a un PDF en C#

Ver en GitHub

Instalar con NuGet

Versión: 2026.9

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

En el Explorador de Soluciones, haga clic derecho en Referencias, Administrar Paquetes NuGet
Seleccione Examinar y busque "IronPDF"
Seleccione el paquete e instale

Descargar DLL

Versión: 2026.9

o descargue el Instalador de Windows aquí.

Descargue y descomprima IronPDF en una ubicación como ~/Libs dentro del directorio de su solución
En el Explorador de Soluciones de Visual Studio, haga clic derecho en Referencias. Seleccione Examinar, "IronPDF.dll"

Licencias desde $999