Adicionar imagem a um PDF em C# (Tutorial para desenvolvedores)

Criar ou abrir um projeto C

Para adicionar imagens a um documento PDF, recomenda-se a versão mais recente do Visual Studio para criar um projeto em C# e obter uma experiência mais fluida.

• Abra o Visual Studio.

Interface do usuário do Visual Studio iniciando

• Clique no botão "Criar um novo projeto".
• Selecione "Aplicativo de console C#" nos modelos de projeto e clique no botão Avançar . Você pode escolher uma plataforma de acordo com suas necessidades.

Criar um aplicativo de console no Visual Studio

Em seguida, dê um nome ao seu projeto e clique no botão Próximo .

• Selecione a versão de destino do .NET Framework igual ou superior a .NET Core 3.1 e clique no botão Criar .

Seguindo os passos acima, você poderá criar um novo projeto em C# facilmente. Você pode usar um projeto C# já existente. Basta abrir o projeto e instalar a biblioteca IronPDF .

Instale a biblioteca IronPDF.

Install-Package IronPdf

using IronPdf;

using IronPdf;

Imports IronPdf

Adicionando bitmaps e imagens ao documento PDF

Existem várias maneiras de adicionar imagens a documentos PDF usando o IronPDF: usar um arquivo de imagem direto, converter imagens em bytes ou usar System.Drawing.Bitmap. Além disso, a biblioteca IronPDF suporta múltiplos formatos de imagem.

Vamos dar uma olhada:

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 carregará a imagem primeiro. A função ReadAllBytes converte a imagem para o formato de bytes no código acima. Em seguida, os dados da imagem serão codificados em base64 e inseridos em uma tag HTML <img> como uma string. Depois disso, a string HTML será renderizada em um PDF usando a função do método RenderHtmlAsPdf . Isso criará uma página PDF no documento PDF.

O próximo exemplo mostrará como usar uma imagem Bitmap em um documento PDF. O IronPDF possui um método útil para incorporar um System.Drawing.Image em um documento HTML, que pode então ser renderizado como um PDF. Acesse a API ImageUtilities a seguir para saber mais sobre ela. O código a seguir mostrará como 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

No código acima, a função ImageToDataUri é usada para converter uma imagem em um formato URI. A imagem é então desenhada no documento PDF usando a função RenderHtmlAsPdf. Isso se aplica a várias imagens.

Além disso, o IronPDF também é capaz de renderizar gráficos em PDFs , adicionar códigos de barras a documentos PDF , aprimorar a segurança de PDFs com senhas e marcas d'água , e até mesmo manipular formulários PDF programaticamente .