1. IronPDF
  2. Guías
  3. Imágenes (jpg, png, svg, gif, etc.)
Cómo agregar imágenes a PDFs en C#

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

Curtis Chau
Curtis Chau
Actualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Insertar una imagen en un PDF significa colocar la imagen directamente dentro del archivo PDF, asegurando que esté auto contenido y no dependa de fuentes externas. Esto permite que el PDF muestre la imagen perfectamente, incluso sin conexión a internet o archivos externos.

IronPDF es capaz de renderizar cadenas HTML, archivos y URLs web a PDF. Al usar este método, las imágenes se pueden insertar en HTML y luego convertirlas en un documento PDF.

Inicio rápido: Incruste imágenes en PDFs fácilmente

Comience a incrustar imágenes en sus archivos PDF utilizando IronPDF en .NET C#. Convirtiendo su imagen a una cadena Base64 e incorporándola en una etiqueta HTML <img>, puede generar un PDF auto contenido que no requiere archivos externos. Este método asegura que sus imágenes se muestren perfectamente sin la necesidad de acceso a internet, haciendo que el proceso sea rápido y sencillo.

Nuget IconEmpieza a crear PDF con NuGet ahora:

  1. Instalar IronPDF con el gestor de paquetes NuGet

    PM > Install-Package IronPdf

  2. Copie y ejecute este fragmento de código.

    new IronPdf.ChromePdfRenderer()
     .RenderHtmlAsPdf("<img src='data:image/png;base64," + Convert.ToBase64String(File.ReadAllBytes("logo.png")) + "'>")
     .SaveAs("image‑embedded.pdf");

  3. Despliegue para probar en su entorno real

    Empieza a utilizar IronPDF en tu proyecto hoy mismo con una prueba gratuita
    arrow pointer

Flujo de trabajo mínimo (5 pasos)

  1. Descargar la biblioteca IronPDF C#
  2. Prepara el archivo de imagen para ser incrustado
  3. Utilice la etiqueta img para incrustar imágenes en HTML
  4. Renderiza el HTML a PDF usando el método RenderHtmlAsPdf
  5. Incrusta la imagen usando codificación Base64


Embeber imagen en PDF Ejemplo

Para insertar una imagen en un PDF, primero debe incluir la imagen en HTML usando la etiqueta <img>. Luego, use el método RenderHtmlAsPdf para convertir el HTML a PDF. Si tiene un PDF existente, puede estampar la imagen en el documento PDF usando ya sea un estampador de imagen o un tutorial de estampado HTML.

: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")
$vbLabelText   $csharpLabel

Embed con ejemplo Base64

Para usar base64 para insertar una imagen en HTML, primero debe obtener los datos binarios de la imagen, ya sea leyendo el archivo de imagen o recibiéndolo a través de una solicitud de red. Use el método Convert.ToBase64String en Microsoft .NET para convertir los datos binarios a base64. Construya la etiqueta de imagen en HTML usando "data:image/svg+xml;base64," antes de los datos base64. Es posible que haya notado que el tipo de imagen se especifica antes de los datos base64. Visite los MDN Web Docs sobre formatos de imagen para obtener más información sobre los tipos de formatos de imagen.

: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")
$vbLabelText   $csharpLabel

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

Preguntas Frecuentes

¿Cómo puedo agregar imágenes a PDFs usando C#?

Puedes agregar imágenes a PDFs en C# usando IronPDF. Primero, descarga la biblioteca de IronPDF C#. Luego, prepara el archivo de imagen e incrústalo en HTML usando la etiqueta <img>. Finalmente, usa el método RenderHtmlAsPdf para convertir el HTML a un PDF.

¿Cuál es la ventaja de usar la codificación Base64 para imágenes en PDFs?

La codificación Base64 te permite incrustar datos de imagen directamente en HTML. Esto significa que las imágenes pueden mostrarse en PDFs sin requerir archivos de imagen separados o solicitudes de red, asegurando que el PDF sea autónomo.

¿Puedo agregar imágenes a un documento PDF existente?

Sí, puedes agregar imágenes a un PDF existente estampándolas en el documento. IronPDF ofrece tutoriales para usar tanto un estampador de imagen como un estampador HTML para lograr esto.

¿Cuál es el proceso para convertir datos binarios de imagen a Base64?

Para convertir datos binarios de imagen a Base64, usa el método Convert.ToBase64String de Microsoft .NET. Una vez convertido, puedes incrustar la cadena Base64 en una etiqueta <img> en HTML y renderizarla a PDF usando IronPDF.

¿Las imágenes incrustadas en PDFs requieren conexión a Internet para mostrarse?

No, una vez que las imágenes están incrustadas en PDFs, no requieren conexión a Internet para mostrarse. Esto se debe a que las imágenes están contenidas dentro del propio archivo PDF.

¿Cómo puedo incrustar una imagen en un PDF usando HTML e IronPDF?

Para incrustar una imagen en un PDF usando HTML, incluye la imagen en un archivo HTML usando la etiqueta <img>. Luego, emplea el método RenderHtmlAsPdf de IronPDF para convertir ese HTML en un documento PDF.

¿Dónde puedo aprender más sobre formatos de imagen para usar en incrustación Base64?

Para más información sobre tipos de formato de imagen para incrustación Base64, puedes consultar los MDN Web Docs sobre formatos de imagen. Este recurso proporciona información detallada sobre diferentes tipos de imagen y su uso.

¿IronPDF es totalmente compatible con .NET 10 al trabajar con imágenes y renderizado HTML?

Sí. IronPDF es totalmente compatible con .NET 10, incluyendo sus funciones de incrustación de imágenes y renderizado de HTML a PDF. Admite recursos externos como imágenes, CSS y JavaScript, y funciona de inmediato en proyectos .NET 10.

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

Leer más
Revisado por
Jeff Fritz
Jeffrey T. Fritz
Gerente Principal de Programas - Equipo de la Comunidad .NET
Jeff también es Gerente Principal de Programas para los equipos de .NET y Visual Studio. Es el productor ejecutivo de la serie de conferencias virtuales .NET Conf y anfitrión de 'Fritz and Friends', una transmisión en vivo para desarrolladores que se emite dos veces a la semana donde habla sobre tecnología y escribe código junto con la audiencia. Jeff escribe talleres, presentaciones, y planifica contenido para los eventos de desarrolladores más importantes de Microsoft, incluyendo Microsoft Build, Microsoft Ignite, .NET Conf y la Cumbre de Microsoft MVP.
¿Listo para empezar?
Nuget Descargas 16,493,056 | Version: 2025.11 recién lanzado