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 contenido HTML, incluidas las imágenes, en formato PDF mientras preserva 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. Al trabajar con diferentes formatos, asegúrate de que tu HTML especifique correctamente el tipo de imagen en el atributo src o 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");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private html As String = "<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Render HTML to PDF
Private pdf As PdfDocument = 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");

Imports IronPdf
Imports System
Imports System.IO

Private renderer As New ChromePdfRenderer()

' Import image file binary data
Private binaryData() As Byte = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg")

' Convert the binary data to base 64
Private imgDataUri As String = Convert.ToBase64String(binaryData)

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

' Convert HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

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

Logotipos corporativos en facturas Facturae

Los logotipos en formato PNG o SVG se incrustan como Base64 en la plantilla HTML de la factura antes de llamar a RenderHtmlAsPdf. Este enfoque garantiza que el PDF de la factura sea completamente autónomo —sin rutas de archivo locales ni URLs externas— lo que es imprescindible para flujos Facturae donde el documento debe ser reproducible en auditorías AEAT años después de su emisión.

Códigos QR de verificación AEAT en facturas VeriFactu

La normativa VeriFactu exige que cada factura incluya un código QR de verificación que permita al receptor validar la factura en la sede electrónica de la AEAT. Este QR, generado programáticamente a partir del hash de la factura, se incrusta habitualmente como imagen Base64 en la sección inferior de la plantilla HTML antes de la conversión a PDF con IronPDF. El patrón de integración es idéntico al de cualquier imagen Base64: convertir los bytes del QR a Base64 con Convert.ToBase64String e incluirlos en una etiqueta <img> con el tipo data:image/png;base64,.

Para flujos completos de generación de facturas con firma PAdES o integración del XML Facturae, consulta las guías específicas de IronPDF para firma electrónica y formatos de facturación electrónica.

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