C# Añadir Imagen a PDF (Tutorial para Desarrolladores)

Introducción

Desde el punto de vista de un desarrollador, añadir imágenes a documentos PDF mediante programación es una tarea difícil debido a la variedad de formatos de imagen y a la complejidad de su manipulación. Por lo tanto, se recomienda la biblioteca IronPDF C# para añadir imágenes al documento PDF mediante programación. Exploremos qué es IronPDF y cómo utilizarlo eficazmente.

IronPDF: C# Biblioteca PDF

La biblioteca IronPDF C# es una biblioteca PDF escrita en C# y orientada al modelo de objetos PDF. Esta biblioteca proporciona al desarrollador una forma de crear, editar y guardar archivos PDF sin necesidad de mantener una estrecha relación con API específicas como Acrobat de Adobe. La biblioteca IronPDF C# puede utilizarse cuando no se desea utilizar Adobe Acrobat u otro software individual.

Esta biblioteca asiste a los desarrolladores con muchas herramientas para crear, editar archivos PDF con C# y guardar archivos PDF, además de ofrecer características que otras bibliotecas PDF de .NET no ofrecen. Muchos desarrolladores prefieren la biblioteca de C# de IronPDF porque ofrece todo lo que buscan en una biblioteca PDF para plataformas Windows, Linux y macOS, ¡y sin ningún costo! IronPDF añade constantemente funciones y amplía sus servicios para convertirlo en la mejor utilidad para sus necesidades de PDF. La biblioteca sobresale más allá de los requisitos básicos para aquellos que necesitan explorar, buscar, encontrar, extraer datos de archivos PDF o crear archivos PDF. Veamos cómo se utiliza IronPDF para añadir imágenes a un documento PDF.

Crear o Abrir Proyecto C

Para añadir imágenes a un documento PDF, se recomienda utilizar la última versión de Visual Studio para crear un proyecto en C# y disfrutar de una experiencia sin problemas.

• Abre Visual Studio.

  

  Interfaz de inicio de Visual Studio

• Haga clic en el botón "Crear un nuevo proyecto".

• Seleccione "Aplicación de consola C#" de las plantillas de proyecto y haga clic en el botón Siguiente. Puede elegir una plataforma en función de sus necesidades.

  

  Crear una aplicación de consola en Visual Studio

• A continuación, dale un nombre a tu proyecto y haz clic en el botón Siguiente.

• Elija la versión de .NET Framework objetivo >= .NET Core 3.1 y haga clic en el botón Create.

  Siguiendo los pasos anteriores, podrá crear un nuevo proyecto C# fácilmente. Puede utilizar un proyecto C# ya existente. Basta con abrir el proyecto e instalar la biblioteca IronPDF.

Instalar la biblioteca IronPDF

La biblioteca IronPDF puede instalarse de varias formas.

• Usando el Administrador de Paquetes NuGet
• Usando la Consola del Administrador de Paquetes

Uso del gestor de paquetes NuGet

Para instalar la biblioteca utilizando NuGet Package Manager, siga los pasos que se indican a continuación:

• Vaya a Herramientas > Administrador de paquetes NuGet > Administrar paquetes NuGet para la solución desde las opciones del menú principal.

  

  Navegar al Administrador de Paquetes NuGet

• Se abrirá la ventana del Gestor de paquetes NuGet. Vaya a la pestaña Examinar y busque IronPDF. Seleccione la biblioteca IronPDF y haga clic en el botón "Instalar".

  

  Instale el paquete IronPdf desde el Administrador de paquetes NuGet

Uso de la consola del gestor de paquetes

A continuación se indican los pasos para instalar la biblioteca IronPDF utilizando la consola.

• Vaya a la Consola del Administrador de Paquetes (generalmente ubicada en la parte inferior de Visual Studio).
• Escriba el siguiente comando para iniciar la instalación de la librería IronPDF.

Install-Package IronPdf

Se iniciará la instalación y podrás ver el progreso de la misma. Tras la instalación, podrá utilizar la biblioteca IronPDF en su proyecto muy rápidamente.

La biblioteca ha sido instalada, y ahora es el momento de escribir el código para añadir imágenes al documento PDF. Empezando por importar el espacio de nombres IronPDF. Por lo tanto, escriba la siguiente línea en su archivo de código:

using IronPdf;

using IronPdf;

Imports IronPdf

Añadir mapas de bits e imágenes al documento PDF

Existen múltiples formas de añadir imágenes a documentos PDF utilizando IronPDF: usar un archivo de imagen directo, convertir imágenes a bytes o utilizar System.Drawing.Bitmap. Además, la biblioteca IronPDF admite múltiples formatos de imagen.

Echemos un vistazo:

using IronPdf;
using System.IO;
using System.Drawing;
/* Example 1: From an Image File or Bytes*/

static void Main(string [] args)
{
    var renderer = new IronPdf.ChromePdfRenderer();

    var pngBinaryData = File.ReadAllBytes("embed_me.png");

    var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(base64bytes);
    var ImgHtml = $"<img src='{ImgDataURI}'>";

    using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);
    pdfdoc.SaveAs("embeded_example_1.pdf");
}

using IronPdf;
using System.IO;
using System.Drawing;
/* Example 1: From an Image File or Bytes*/

static void Main(string [] args)
{
    var renderer = new IronPdf.ChromePdfRenderer();

    var pngBinaryData = File.ReadAllBytes("embed_me.png");

    var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(base64bytes);
    var ImgHtml = $"<img src='{ImgDataURI}'>";

    using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);
    pdfdoc.SaveAs("embeded_example_1.pdf");
}

Imports IronPdf
Imports System.IO
Imports System.Drawing
' Example 1: From an Image File or Bytes

Shared Sub Main(ByVal args() As String)
	Dim renderer = New IronPdf.ChromePdfRenderer()

	Dim pngBinaryData = File.ReadAllBytes("embed_me.png")

	Dim ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(base64bytes)
	Dim ImgHtml = $"<img src='{ImgDataURI}'>"

	Dim pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml)
	pdfdoc.SaveAs("embeded_example_1.pdf")
End Sub

Este programa cargará la imagen primero. La función ReadAllBytes convierte la imagen en formato de bytes en el código anterior. Después, los datos de la imagen se codificarán en base64 y se colocarán en una etiqueta HTML como cadena. Después de eso, la cadena HTML será renderizada a PDF utilizando la función RenderHtmlAsPdf method. Creará una página PDF en el documento PDF.

El siguiente ejemplo mostrará cómo utilizar la imagen Bitmap en el documento PDF. IronPDF tiene un método beneficioso para incrustar un System.Drawing.Image en un documento HTML que luego puede ser renderizado como un PDF. Visite la siguiente API de ImageUtilities para comprender más al respecto. El siguiente código muestra cómo funciona:

/* Example 2: From a System.Drawing.Bitmap */

//System.Drawing.BitMap MyImage

string DataURI =  IronPdf.Util.ImageToDataUri(MyImage);
var ImgHtml = $"<img src='{DataURI}'>";
using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);
pdfdoc2.SaveAs("emeded_example_2.pdf");

/* Example 2: From a System.Drawing.Bitmap */

//System.Drawing.BitMap MyImage

string DataURI =  IronPdf.Util.ImageToDataUri(MyImage);
var ImgHtml = $"<img src='{DataURI}'>";
using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);
pdfdoc2.SaveAs("emeded_example_2.pdf");

' Example 2: From a System.Drawing.Bitmap 

'System.Drawing.BitMap MyImage

Dim DataURI As String = IronPdf.Util.ImageToDataUri(MyImage)
Dim ImgHtml = $"<img src='{DataURI}'>"
Dim pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml)
pdfdoc2.SaveAs("emeded_example_2.pdf")

En el código anterior, la función ImageToDataUri se utiliza para convertirlo en URI y luego el operador dibuja la imagen en un documento PDF utilizando la función RenderHtmlAsPdf. Esto se aplica a varias imágenes.

Además, IronPDF también es capaz de renderizar gráficos en PDFs, agregar códigos de barras a documentos PDF, mejorar la seguridad de PDF con contraseñas y marcar archivos PDF con marcas de agua, e incluso manejar formularios PDF programáticamente.

Licencias

IronPDF es una excelente biblioteca PDF que le ayuda a crear y personalizar archivos PDF, y está disponible para su compra hoy mismo. Sin embargo, IronPDF es totalmente gratuito para fines de desarrollo. También puedes activar la versión de prueba gratuita para producción sin necesidad de proporcionar ningún dato de pago. Después de comprar IronPDF, Iron Software le hace una fantástica oferta para adquirir cinco paquetes de Iron Software por el precio de sólo dos. ¡Sí! Ha oído bien: puede adquirir un paquete de cinco productos de Iron Software por el precio de sólo dos. ¡Cómpralo ahora! Visite la página de licencias de IronPDF para más detalles.