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

Crear o abrir un proyecto C

Para agregar imágenes a un documento PDF, se recomienda la última versión de Visual Studio para crear un proyecto C# para una experiencia fluida.

• Abre Visual Studio.

UI de inicio de Visual Studio

• Haga clic en el botón "Crear un Nuevo Proyecto".
• Seleccione "Aplicación Consola C#" de las plantillas de Proyecto y haga clic en el botón Siguiente. Puede elegir una plataforma según 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 el Framework .NET Objetivo >= versión de .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 usar un proyecto C# ya existente. Simplemente abra el proyecto e instale la biblioteca IronPDF.

Instalar la biblioteca IronPDF

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

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

Hay múltiples formas de agregar imágenes a documentos PDF usando IronPDF: usar un archivo de imagen directo, convertir imágenes a bytes, o usar System.Drawing.Bitmap. Además, la biblioteca IronPDF soporta múltiples formatos de imagen.

Veamos un ejemplo:

using IronPdf;
using System.IO;
using System.Drawing;

class PDFImageAdder
{
    /* This method demonstrates how to convert an image file to a PDF document in C# */
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Read the PNG image file into binary format
        var pngBinaryData = File.ReadAllBytes("embed_me.png");

        // Convert image binary data to base64 for embedding in HTML
        var ImgDataURI = "data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

        // Embed the image as a base64 data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{ImgDataURI}'>";

        // Render the HTML as a PDF document
        using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the rendered PDF document
        pdfdoc.SaveAs("embedded_example_1.pdf");
    }
}

using IronPdf;
using System.IO;
using System.Drawing;

class PDFImageAdder
{
    /* This method demonstrates how to convert an image file to a PDF document in C# */
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Read the PNG image file into binary format
        var pngBinaryData = File.ReadAllBytes("embed_me.png");

        // Convert image binary data to base64 for embedding in HTML
        var ImgDataURI = "data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

        // Embed the image as a base64 data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{ImgDataURI}'>";

        // Render the HTML as a PDF document
        using var pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the rendered PDF document
        pdfdoc.SaveAs("embedded_example_1.pdf");
    }
}

Imports IronPdf
Imports System.IO
Imports System.Drawing

Friend Class PDFImageAdder
	' This method demonstrates how to convert an image file to a PDF document in C# 
	Shared Sub Main(ByVal args() As String)
		' Initialize IronPdf Renderer
		Dim renderer = New IronPdf.ChromePdfRenderer()

		' Read the PNG image file into binary format
		Dim pngBinaryData = File.ReadAllBytes("embed_me.png")

		' Convert image binary data to base64 for embedding in HTML
		Dim ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(pngBinaryData)

		' Embed the image as a base64 data URI in an HTML <img> tag
		Dim ImgHtml = $"<img src='{ImgDataURI}'>"

		' Render the HTML as a PDF document
		Dim pdfdoc = renderer.RenderHtmlAsPdf(ImgHtml)

		' Save the rendered PDF document
		pdfdoc.SaveAs("embedded_example_1.pdf")
	End Sub
End Class

Este programa cargará primero la imagen. La función ReadAllBytes convierte la imagen en formato de bytes en el código anterior. Después de eso, los datos de la imagen se codificarán en base64 y se colocarán en una etiqueta HTML <img> como cadena. Después de eso, la cadena HTML se renderizará en un PDF usando la función del método RenderHtmlAsPdf. Creará una página PDF en el documento PDF.

El próximo ejemplo mostrará cómo usar una imagen Bitmap en el documento PDF. IronPDF tiene un método útil para incrustar una System.Drawing.Image en un documento HTML, que luego puede renderizarse como PDF. Visite el siguiente API de ImageUtilities para entender más sobre ello. El siguiente código mostrará cómo funciona:

using IronPdf;
using System.Drawing;

class PDFImageAdder
{
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Create a Bitmap image
        Bitmap MyImage = new Bitmap("Path-to-Your-Image");

        // Convert the Bitmap image to a Data URI
        string DataURI = IronPdf.Util.ImageToDataUri(MyImage);

        // Embed the image as a Data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{DataURI}'>";

        // Render the HTML to PDF
        using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the PDF document
        pdfdoc2.SaveAs("embedded_example_2.pdf");
    }
}

using IronPdf;
using System.Drawing;

class PDFImageAdder
{
    static void Main(string[] args)
    {
        // Initialize IronPdf Renderer
        var renderer = new IronPdf.ChromePdfRenderer();

        // Create a Bitmap image
        Bitmap MyImage = new Bitmap("Path-to-Your-Image");

        // Convert the Bitmap image to a Data URI
        string DataURI = IronPdf.Util.ImageToDataUri(MyImage);

        // Embed the image as a Data URI in an HTML <img> tag
        var ImgHtml = $"<img src='{DataURI}'>";

        // Render the HTML to PDF
        using var pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml);

        // Save the PDF document
        pdfdoc2.SaveAs("embedded_example_2.pdf");
    }
}

Imports IronPdf
Imports System.Drawing

Friend Class PDFImageAdder
	Shared Sub Main(ByVal args() As String)
		' Initialize IronPdf Renderer
		Dim renderer = New IronPdf.ChromePdfRenderer()

		' Create a Bitmap image
		Dim MyImage As New Bitmap("Path-to-Your-Image")

		' Convert the Bitmap image to a Data URI
		Dim DataURI As String = IronPdf.Util.ImageToDataUri(MyImage)

		' Embed the image as a Data URI in an HTML <img> tag
		Dim ImgHtml = $"<img src='{DataURI}'>"

		' Render the HTML to PDF
		Dim pdfdoc2 = renderer.RenderHtmlAsPdf(ImgHtml)

		' Save the PDF document
		pdfdoc2.SaveAs("embedded_example_2.pdf")
	End Sub
End Class

En el código anterior, la función ImageToDataUri se usa para convertir una imagen en formato URI. La imagen luego se dibuja en el documento PDF usando la función RenderHtmlAsPdf. Esto se aplica a múltiples 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 del PDF con contraseñas, y añadir marcas de agua en archivos PDF, e incluso manejar formularios PDF programáticamente.