Cómo añadir imágenes en PDF usando C#

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: Biblioteca PDF C

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 ayuda a los desarrolladores con un montón de herramientas para crear, edición y guardar archivos PDF y funciones que otras bibliotecas PDF .NET no ofrecen. Muchos desarrolladores prefieren la biblioteca IronPDF C# porque ofrece todo lo que buscan en una biblioteca PDF en plataformas Windows, Linux y MacOS, y sin coste alguno.! IronPDF añade constantemente funciones y amplía sus servicios para convertirlo en la mejor utilidad para sus necesidades de PDF. La biblioteca va más allá de los requisitos básicos para quienes necesitan navegar, buscar, encontrar, extraer datos o crear archivos PDF. Veamos cómo se utiliza IronPDF para añadir imágenes a un documento PDF.

Crear o abrir un 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.

  

  Inicio de la interfaz de usuario 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 pulse 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, dé un nombre a su proyecto y haga clic en el botón Siguiente.

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

  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.

• **Utilización del gestor de paquetes NuGet
• Usando la Consola del Gestor 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 paquete NuGet para solución en las opciones del menú principal.

  

  Navegue hasta el Gestor de paquetes NuGet.

• Se abrirán las ventanas 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".

  

  Instalar el paquete IronPdf desde el gestor 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 gestor de paquetes (situado normalmente 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

Hay varias formas de añadir imágenes a documentos PDF con IronPDF: utilizar 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á primero la imagen. La función ReadAllBytes convierte la imagen en formato 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. A continuación, la cadena HTML se convertirá en PDF mediante la función RenderHtmlAsPdf función. 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 a un documento HTML que luego puede ser renderizado como un PDF. Visite Enlace API sobre ImageUtilities para saber más al respecto. El siguiente código muestra cómo funciona:

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

//System.Drawing.BitMap MiImagen

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 MiImagen

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 MiImagen

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, se utiliza la función ImageToDataUri para convertirla en URI y, a continuación, 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 representación de gráficos en PDF, añadir códigos de barras, mejorar la seguridad con contraseñas y marca de agua e incluso gestión de formularios PDF mediante programación.

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 puede activar el versión de prueba gratuita para la producción sin ningún detalle 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. Comprar ahora! Visite nuestra página de licencias para más detalles.