Do ponto de vista do desenvolvedor, adicionar imagens a documentos PDF programaticamente é uma tarefa desafiadora devido à variedade de formatos de imagem e à complexidade de sua manipulação. Portanto, recomenda-se a biblioteca IronPDF C# para adicionar imagens ao documento PDF programaticamente. Vamos explorar o que é o IronPDF e como usá-lo de forma eficaz.

IronPDF: Biblioteca PDF em C#

A biblioteca IronPDF C# é uma biblioteca PDF escrita em C# e direcionada ao modelo de objeto PDF. Esta biblioteca fornece ao desenvolvedor uma maneira de criar, editar e salvar arquivos PDF sem a necessidade de manter estrita compatibilidade com APIs específicas, como o Acrobat da Adobe. A biblioteca IronPDF C# pode ser usada quando você não deseja usar o Adobe Acrobat ou outro software individual.

Esta biblioteca auxilia os desenvolvedores com diversas ferramentas para criar e editar arquivos PDF com C# , além de oferecer recursos e funcionalidades para salvar arquivos PDF que outras bibliotecas .NET PDF não oferecem. Muitos desenvolvedores preferem a biblioteca IronPDF C# porque ela oferece tudo o que eles procuram em uma biblioteca PDF para plataformas Windows, Linux e macOS, e sem nenhum custo! O IronPDF adiciona constantemente recursos e amplia seus serviços para torná-lo a melhor ferramenta para suas necessidades em PDF. A biblioteca oferece muito mais do que o básico para quem precisa navegar, pesquisar, encontrar, extrair dados de arquivos PDF ou criar arquivos PDF. Vamos dar uma olhada em como o IronPDF é usado para adicionar imagens a um documento PDF.

Crie ou Abra 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.

A biblioteca IronPDF pode ser instalada de diversas maneiras.

• Usando o Gerenciador de Pacotes NuGet
• Usando o Console do Gerenciador de Pacotes

Usando o Gerenciador de Pacotes NuGet

Para instalar a biblioteca usando o Gerenciador de Pacotes NuGet , siga os passos abaixo:

• No menu principal, acesse Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para a Solução .

Acesse o Gerenciador de Pacotes NuGet.

• Isso abrirá a janela do Gerenciador de Pacotes NuGet . Acesse a aba de navegação e pesquise por IronPDF. Selecione a biblioteca IronPDF e clique no botão "Instalar".

Instale o pacote IronPDF do Gerenciador de Pacotes NuGet

Usando o console do gerenciador de pacotes

A seguir estão os passos para instalar a biblioteca IronPDF usando o Console.

• Acesse o Console do Gerenciador de Pacotes (geralmente localizado na parte inferior do Visual Studio).
• Digite o seguinte comando para iniciar a instalação da biblioteca IronPDF .

Install-Package IronPdf

A instalação será iniciada e você poderá acompanhar o progresso. Após a instalação, você poderá usar a biblioteca IronPDF em seu projeto muito rapidamente.

A biblioteca foi instalada e agora é hora de escrever o código para adicionar imagens ao documento PDF. Começando pela importação do namespace IronPDF . Então, escreva a seguinte linha no seu arquivo de código:

using IronPdf;

using IronPdf;

Imports IronPdf

Imports IronPdf

Adicionando bitmaps e imagens ao documento PDF

Existem várias maneiras de adicionar imagens a documentos PDF usando IronPDF: usar um arquivo de imagem direto, converter imagens para 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

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 em formato de bytes no código acima. Depois disso, os dados da imagem serão codificados em base64 e colocados em uma tag HTML <img> como uma string. Depois disso, a string HTML será renderizada para um PDF usando a método RenderHtmlAsPdf função. 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

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

Licenciamento

IronPDF é uma excelente biblioteca de PDF que auxilia na criação e personalização de arquivos PDF, e está disponível para compra hoje mesmo. No entanto, o IronPDF é totalmente gratuito para fins de desenvolvimento. Você também pode ativar a versão de avaliação gratuita para produção sem precisar fornecer informações de pagamento. Após adquirir o IronPDF, a Iron Software oferece uma promoção fantástica: você pode comprar cinco pacotes do Iron Software pelo preço de apenas dois. Sim! Você ouviu direito — pode adquirir um pacote com cinco produtos da Iron Software pelo preço de apenas dois. Compre agora! Visite a página de licenciamento do IronPDF para obter mais detalhes.