Cómo añadir imágenes a archivos PDF en C# con IronPDF

¿Por qué funciona mejor el método RenderHtmlAsPdf?

El método RenderHtmlAsPdf aprovecha el motor de renderizado de Chrome de IronPDF para convertir el contenido HTML, incluidas las imágenes, en formato PDF conservando el diseño y el estilo. Este método es compatible con diseños CSS responsivos y garantiza que las imágenes se muestren tal y como aparecen en un navegador web. Para diseños complejos, consulte nuestra guía sobre formateo HTML perfecto.

¿Qué formatos de imagen se admiten?

IronPDF es compatible con los principales formatos de imagen, incluidos PNG, JPG, SVG, GIF y BMP, al incrustarlos mediante la conversión a HTML. La biblioteca maneja gráficos SVG con eficacia para ilustraciones vectoriales escalables. Cuando trabaje con formatos diferentes, asegúrese de que su HTML especifica correctamente el tipo de imagen en el atributo src o en la URI de datos Base64.

¿Cuándo debo utilizar una URL directa frente a la codificación Base64?

Utilice URL directas cuando las imágenes estén alojadas en línea y el tamaño del archivo sea un problema. Elija la codificación Base64 para PDF autónomos que no requieran acceso a Internet. Para imágenes almacenadas en servicios en la nube, consulte nuestra guía sobre incrustación de imágenes de Azure Blob Storage. Esta decisión afecta tanto al tamaño del archivo como a la portabilidad de los PDF generados.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

¿Por qué utilizar la codificación Base64 para las imágenes?

La codificación Base64 crea PDF autónomos que no dependen de recursos externos, lo que garantiza que las imágenes se muestren siempre sin conexión a Internet o cuando los archivos de imagen originales se mueven o eliminan. Esta técnica es útil cuando se crean archivos PDF en aplicaciones de Blazor Server o cuando se despliega en Azure, donde el acceso a archivos externos puede estar restringido. Las imágenes codificadas pasan a formar parte de la cadena HTML, lo que las hace ideales para conversiones de cadenas HTML a PDF.

¿Cuáles son las consideraciones de rendimiento?

La codificación Base64 aumenta el tamaño del archivo en aproximadamente un 33%, pero elimina las dependencias externas, por lo que resulta ideal para fines de archivo o entornos de red restringidos. Cuando el rendimiento sea crítico, considere el uso de async PDF generation para manejar múltiples conversiones de imagen simultáneamente. Para operaciones a gran escala, consulte nuestra guía de optimización del rendimiento para maximizar el rendimiento.

¿Cómo manejar archivos de imagen de gran tamaño?

En el caso de imágenes grandes, comprímalas antes de codificarlas en Base64 para minimizar el tamaño del archivo PDF, o utilice URL externas si el tamaño del archivo es crítico. IronPDF ofrece funciones de compresión de PDF que pueden reducir el tamaño de los archivos hasta en un 75%. Cuando trabaje con varias imágenes, optimice la configuración de renderizado para obtener el mejor equilibrio entre calidad y tamaño de archivo.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

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

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