Como Converter Imagem em PDF e Adicionar Imagens a PDFs em C# com IronPDF

Por que o método RenderHtmlAsPdf funciona melhor?

O método RenderHtmlAsPdf utiliza o mecanismo de renderização Chrome do IronPDF para converter conteúdo HTML, incluindo imagens, em formato PDF, preservando o layout e o estilo. Este método suporta layouts CSS responsivos e garante que as imagens sejam renderizadas conforme aparecem em um navegador da web. Para layouts complexos, consulte nosso guia sobre formatação HTML perfeita em pixels .

Quais formatos de imagem são suportados?

O IronPDF suporta todos os principais formatos de imagem, incluindo PNG, JPG, SVG, GIF e BMP, ao ser incorporado por meio da conversão para HTML. A biblioteca lida com gráficos SVG de forma eficaz para ilustrações vetoriais escaláveis. Ao trabalhar com diferentes formatos, certifique-se de que seu HTML especifique corretamente o tipo de imagem no atributo src ou no URI de dados Base64.

Quando devo usar URL direta em vez de codificação Base64?

Use URLs diretos quando as imagens estiverem hospedadas online e o tamanho do arquivo for uma preocupação. Escolha a codificação Base64 para PDFs autossuficientes que não exigem acesso à internet. Para imagens armazenadas em serviços de nuvem, consulte nosso guia sobre como incorporar imagens do Armazenamento de Blobs do Azure . Essa decisão afeta tanto o tamanho do arquivo quanto a portabilidade dos PDFs gerados.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-embed-image.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

string html = @"<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>";

// Render HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export PDF
pdf.SaveAs("embedImage.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private html As String = "<img src='https://ironsoftware.com/img/products/ironpdf-logo-text-dotnet.svg'>"

' Render HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export PDF
pdf.SaveAs("embedImage.pdf")

Por que usar a codificação Base64 para imagens?

A codificação Base64 cria PDFs autossuficientes que não dependem de recursos externos, garantindo que as imagens sejam sempre exibidas sem conexão com a internet ou quando os arquivos de imagem originais forem movidos ou excluídos. Essa técnica é útil ao criar PDFs em aplicativos Blazor Server ou ao implantar no Azure , onde o acesso a arquivos externos pode ser restrito. As imagens codificadas passam a fazer parte da string HTML, tornando-as ideais para conversões de string HTML para PDF .

Quais são as considerações de desempenho?

A codificação Base64 aumenta o tamanho do arquivo em aproximadamente 33%, mas elimina dependências externas, tornando-a ideal para fins de arquivamento ou ambientes de rede restritos. Quando o desempenho é crucial, considere usar a geração assíncrona de PDFs para lidar com várias conversões de imagem simultaneamente. Para operações em larga escala, consulte nosso guia de otimização de desempenho para maximizar a produtividade.

Como lidar com arquivos de imagem grandes?

Para imagens grandes, comprima-as antes da codificação Base64 para minimizar o tamanho do arquivo PDF ou use URLs externas se o tamanho do arquivo for um fator crítico. O IronPDF oferece recursos de compressão de PDF que podem reduzir o tamanho dos arquivos em até 75%. Ao trabalhar com várias imagens, otimize as configurações de renderização para obter o melhor equilíbrio entre qualidade e tamanho do arquivo.

:path=/static-assets/pdf/content-code-examples/how-to/add-images-to-pdfs-base64-image.cs

using IronPdf;
using System;
using System.IO;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Import image file binary data
byte[] binaryData = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg");

// Convert the binary data to base 64
string imgDataUri = Convert.ToBase64String(binaryData);

// Embed in HTML
string html = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>";

// Convert HTML to PDF
PdfDocument pdf = renderer.RenderHtmlAsPdf(html);

// Export the PDF
pdf.SaveAs("embedImageBase64.pdf");

Imports IronPdf
Imports System
Imports System.IO

Private renderer As New ChromePdfRenderer()

' Import image file binary data
Private binaryData() As Byte = File.ReadAllBytes("ironpdf-logo-text-dotnet.svg")

' Convert the binary data to base 64
Private imgDataUri As String = Convert.ToBase64String(binaryData)

' Embed in HTML
Private html As String = $"<img src='data:image/svg+xml;base64,{imgDataUri}'>"

' Convert HTML to PDF
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)

' Export the PDF
pdf.SaveAs("embedImageBase64.pdf")

Pronto para ver o que mais você pode fazer? Confira nossa página de tutoriais aqui: Recursos adicionais