Incorporar imagens com DataURIs em C# e VB para renderização de PDF

Atualizado:janeiro 10, 2026

Translated

View the article in English

Incorpore imagens diretamente em documentos PDF usando DataURIs em C# e VB .NET com o IronPDF, eliminando dependências de arquivos externos ao converter bytes de imagem em strings base64 e incluí-las diretamente na marcação HTML para uma renderização perfeita do PDF.

Ao trabalhar com strings e documentos HTML, evitar dependências em diretórios de recursos é frequentemente essencial. O esquema de URI de dados oferece uma solução eficaz.

O esquema de URI de dados incorpora dados diretamente no código HTML ou CSS, eliminando a necessidade de arquivos separados. DataURIs permite que imagens, arquivos e fontes sejam inseridos diretamente em um documento HTML como uma string.

Início Rápido: Incorporar Imagens em PDFs Usando DataURIs

Transforme conteúdo HTML em documentos PDF incorporando imagens usando DataURIs com IronPDF. Este guia demonstra como renderizar PDFs com imagens incorporadas usando um código simples e eficiente. O IronPDF converte HTML em PDF, mantendo a integridade da imagem. Aqui está um exemplo simples que mostra como incorporar uma imagem diretamente em seu documento PDF usando DataURI com o mínimo de código.

Instale IronPDF com o Gerenciador de Pacotes NuGet
PM > Install-Package IronPdf

Copie e execute este trecho de código.

new IronPdf.ChromePdfRenderer.StaticRenderHtmlAsPdf("<img src='data:image/png;base64,...' />").SaveAs("output.pdf");

Implante para testar em seu ambiente de produção.

Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita

Fluxo de trabalho mínimo (5 etapas)

Baixe o IronPDF do NuGet.
Leia os bytes da imagem usando o método `ReadAllBytes`
Utilize o método `ToBase64String` para converter bytes em base64.
Inclua as informações em base64 na tag img.
Converter o HTML para PDF

Como faço para incorporar imagens usando DataURIs em PDFs?

Incorporar imagens usando DataURIs inclui imagens diretamente na marcação HTML sem fazer referência a arquivos externos. Essa abordagem funciona bem ao gerar PDFs em ambientes de nuvem, sistemas distribuídos ou quando se garante que todos os recursos sejam autossuficientes. A conversão de HTML para PDF do IronPDF oferece suporte completo ao DataURIs, permitindo a criação de PDFs profissionais com imagens incorporadas.

O processo envolve três etapas: leitura dos dados da imagem, conversão para o formato base64 e incorporação em uma tag HTML img. Este método funciona com vários formatos de imagem, incluindo PNG, JPEG, GIF e SVG, proporcionando flexibilidade nos fluxos de trabalho de geração de PDFs. A técnica permanece consistente, independentemente de se trabalhar com imagens do Armazenamento de Blobs do Azure ou com arquivos locais.

Exemplo básico de incorporação de imagens

Este exemplo completo demonstra como incorporar uma imagem em um PDF usando DataURIs:

:path=/static-assets/pdf/content-code-examples/how-to/datauris-image.cs

using IronPdf;
using System;

// Read byte from image file
var pngBinaryData = System.IO.File.ReadAllBytes("My_image.png");

// Convert bytes to base64
var ImgDataURI = @"data:image/png;base64," + Convert.ToBase64String(pngBinaryData);

// Import base64 to img tag
var ImgHtml = $"<img src='{ImgDataURI}'>";

ChromePdfRenderer Renderer = new ChromePdfRenderer();

// Render the HTML string
var pdf = Renderer.RenderHtmlAsPdf(ImgHtml);

pdf.SaveAs("datauri_example.pdf");

Imports IronPdf
Imports System

' Read byte from image file
Private pngBinaryData = System.IO.File.ReadAllBytes("My_image.png")

' Convert bytes to base64
Private ImgDataURI = "data:image/png;base64," & Convert.ToBase64String(pngBinaryData)

' Import base64 to img tag
Private ImgHtml = $"<img src='{ImgDataURI}'>"

Private Renderer As New ChromePdfRenderer()

' Render the HTML string
Private pdf = Renderer.RenderHtmlAsPdf(ImgHtml)

pdf.SaveAs("datauri_example.pdf")

$vbLabelText $csharpLabel

Os desenvolvedores VB .NET podem obter a mesma funcionalidade usando a biblioteca VB .NET PDF do IronPDF:

Imports IronPdf
Imports System

' Read byte from image file
Dim pngBinaryData As Byte() = System.IO.File.ReadAllBytes("My_image.png")

' Convert bytes to base64
Dim ImgDataURI As String = "data:image/png;base64," & Convert.ToBase64String(pngBinaryData)

' Import base64 to img tag
Dim ImgHtml As String = $"<img src='{ImgDataURI}'>"

Dim Renderer As New ChromePdfRenderer()

' Render the HTML string
Dim pdf = Renderer.RenderHtmlAsPdf(ImgHtml)

pdf.SaveAs("datauri_example.pdf")

Por que devo usar DataURIs em vez de referências de arquivo?

DataURIs oferecem diversas vantagens em relação às referências de arquivos tradicionais na geração de PDFs. Em primeiro lugar, eliminam a dependência de arquivos externos, tornando a geração de PDFs mais confiável e portátil. Isso é crucial em ambientes de nuvem como Azure ou AWS Lambda , onde o acesso ao sistema de arquivos pode ser limitado ou sensível ao desempenho.

Em segundo lugar, DataURIs assegure-se de que os PDFs sejam completamente autossuficientes. Ao compartilhar ou distribuir PDFs gerados, links de imagens quebrados ou recursos ausentes não são uma preocupação. Isso torna o DataURIs ideal para gerar relatórios, faturas ou documentos que necessitem de arquivamento ou distribuição por e-mail.

Terceiro, DataURIs pode melhorar o desempenho em determinados cenários. Como os dados da imagem são incorporados diretamente no HTML, nenhuma solicitação HTTP adicional ou operação no sistema de arquivos ocorre durante a renderização. Isso resulta em uma geração de PDFs mais rápida, especialmente ao lidar com várias imagens pequenas.

Quais formatos de imagem são suportados?

O IronPDF suporta todos os principais formatos de imagem através do DataURIs, proporcionando flexibilidade nos fluxos de trabalho de geração de PDFs:

PNG : Ideal para imagens com transparência ou gráficos com bordas nítidas. Use data:image/png;base64,
JPEG : Ideal para fotografias e imagens complexas com muitas cores. Use data:image/jpeg;base64,
GIF : Adequado para animações simples ou imagens com cores limitadas. Use data:image/gif;base64,
SVG : Perfeito para gráficos vetoriais escaláveis. Use data:image/svg+xml;base64,
WebP : Formato moderno com excelente compressão. Use data:image/webp;base64,

O exemplo a seguir mostra como lidar com diferentes formatos de imagem:

using IronPdf;
using System;
using System.IO;

public class MultiFormatImageEmbedding
{
    public static void EmbedVariousImageFormats()
    {
        var renderer = new ChromePdfRenderer();

        // Function to create DataURI from image file
        string CreateDataUri(string filePath, string mimeType)
        {
            var imageBytes = File.ReadAllBytes(filePath);
            return $"data:{mimeType};base64,{Convert.ToBase64String(imageBytes)}";
        }

        // Create HTML with multiple image formats
        var html = $@"
        <html>
        <body>
            <h1>Multi-Format Image Test</h1>
            <img src='{CreateDataUri("logo.png", "image/png")}' alt='PNG Logo' />
            <img src='{CreateDataUri("photo.jpg", "image/jpeg")}' alt='JPEG Photo' />
            <img src='{CreateDataUri("icon.svg", "image/svg+xml")}' alt='SVG Icon' />
        </body>
        </html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("multi_format_images.pdf");
    }
}

using IronPdf;
using System;
using System.IO;

public class MultiFormatImageEmbedding
{
    public static void EmbedVariousImageFormats()
    {
        var renderer = new ChromePdfRenderer();

        // Function to create DataURI from image file
        string CreateDataUri(string filePath, string mimeType)
        {
            var imageBytes = File.ReadAllBytes(filePath);
            return $"data:{mimeType};base64,{Convert.ToBase64String(imageBytes)}";
        }

        // Create HTML with multiple image formats
        var html = $@"
        <html>
        <body>
            <h1>Multi-Format Image Test</h1>
            <img src='{CreateDataUri("logo.png", "image/png")}' alt='PNG Logo' />
            <img src='{CreateDataUri("photo.jpg", "image/jpeg")}' alt='JPEG Photo' />
            <img src='{CreateDataUri("icon.svg", "image/svg+xml")}' alt='SVG Icon' />
        </body>
        </html>";

        var pdf = renderer.RenderHtmlAsPdf(html);
        pdf.SaveAs("multi_format_images.pdf");
    }
}

Imports IronPdf
Imports System
Imports System.IO

Public Class MultiFormatImageEmbedding
    Public Shared Sub EmbedVariousImageFormats()
        Dim renderer As New ChromePdfRenderer()

        ' Function to create DataURI from image file
        Function CreateDataUri(filePath As String, mimeType As String) As String
            Dim imageBytes = File.ReadAllBytes(filePath)
            Return $"data:{mimeType};base64,{Convert.ToBase64String(imageBytes)}"
        End Function

        ' Create HTML with multiple image formats
        Dim html = $"
        <html>
        <body>
            <h1>Multi-Format Image Test</h1>
            <img src='{CreateDataUri("logo.png", "image/png")}' alt='PNG Logo' />
            <img src='{CreateDataUri("photo.jpg", "image/jpeg")}' alt='JPEG Photo' />
            <img src='{CreateDataUri("icon.svg", "image/svg+xml")}' alt='SVG Icon' />
        </body>
        </html>"

        Dim pdf = renderer.RenderHtmlAsPdf(html)
        pdf.SaveAs("multi_format_images.pdf")
    End Sub
End Class

$vbLabelText $csharpLabel

Para manipulação avançada de imagens, incluindo a adição de imagens a PDFs existentes , o IronPDF oferece suporte completo.

Como a codificação Base64 afeta o tamanho do arquivo?

A codificação Base64 aumenta o tamanho dos dados em aproximadamente 33%. O Base64 representa dados binários usando apenas 64 caracteres ASCII, exigindo 4 caracteres para representar cada 3 bytes de dados originais. Embora isso aumente o tamanho total, o impacto na geração de PDFs costuma ser mínimo em comparação com os benefícios de documentos autossuficientes.

Otimize o tamanho dos arquivos ao usar DataURIs seguindo estas práticas:

Comprima as imagens antes da codificação : Use ferramentas ou bibliotecas para otimizar os arquivos de imagem antes de convertê-los para base64.
Escolha os formatos apropriados : Use JPEG para fotos e PNG para gráficos com transparência.
Redimensione as imagens adequadamente : Não incorpore imagens maiores do que o necessário para a saída em PDF.
Considere a compressão de PDF : Utilize os recursos de compressão do IronPDF após a geração.

Este exemplo demonstra a otimização de imagens antes da incorporação:

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

public class OptimizedImageEmbedding
{
    public static void EmbedOptimizedImage(string imagePath, int maxWidth = 800)
    {
        // Load and resize image if necessary
        using (var originalImage = Image.FromFile(imagePath))
        {
            var resizedImage = originalImage;

            if (originalImage.Width > maxWidth)
            {
                var ratio = (double)maxWidth / originalImage.Width;
                var newHeight = (int)(originalImage.Height * ratio);
                resizedImage = new Bitmap(originalImage, maxWidth, newHeight);
            }

            // Convert to optimized JPEG
            using (var ms = new MemoryStream())
            {
                var encoder = ImageCodecInfo.GetImageEncoders()
                    .First(c => c.FormatID == ImageFormat.Jpeg.Guid);
                var encoderParams = new EncoderParameters(1);
                encoderParams.Param[0] = new EncoderParameter(
                    System.Drawing.Imaging.Encoder.Quality, 85L);

                resizedImage.Save(ms, encoder, encoderParams);
                var imageBytes = ms.ToArray();

                // Create DataURI
                var dataUri = $"data:image/jpeg;base64,{Convert.ToBase64String(imageBytes)}";

                // Generate PDF
                var html = $@"
                <html>
                <body>
                    <h1>Optimized Image Example</h1>
                    <img src='{dataUri}' style='max-width: 100%;' />
                </body>
                </html>";

                var renderer = new ChromePdfRenderer();
                var pdf = renderer.RenderHtmlAsPdf(html);
                pdf.SaveAs("optimized_image.pdf");
            }

            if (resizedImage != originalImage)
                resizedImage.Dispose();
        }
    }
}

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

public class OptimizedImageEmbedding
{
    public static void EmbedOptimizedImage(string imagePath, int maxWidth = 800)
    {
        // Load and resize image if necessary
        using (var originalImage = Image.FromFile(imagePath))
        {
            var resizedImage = originalImage;

            if (originalImage.Width > maxWidth)
            {
                var ratio = (double)maxWidth / originalImage.Width;
                var newHeight = (int)(originalImage.Height * ratio);
                resizedImage = new Bitmap(originalImage, maxWidth, newHeight);
            }

            // Convert to optimized JPEG
            using (var ms = new MemoryStream())
            {
                var encoder = ImageCodecInfo.GetImageEncoders()
                    .First(c => c.FormatID == ImageFormat.Jpeg.Guid);
                var encoderParams = new EncoderParameters(1);
                encoderParams.Param[0] = new EncoderParameter(
                    System.Drawing.Imaging.Encoder.Quality, 85L);

                resizedImage.Save(ms, encoder, encoderParams);
                var imageBytes = ms.ToArray();

                // Create DataURI
                var dataUri = $"data:image/jpeg;base64,{Convert.ToBase64String(imageBytes)}";

                // Generate PDF
                var html = $@"
                <html>
                <body>
                    <h1>Optimized Image Example</h1>
                    <img src='{dataUri}' style='max-width: 100%;' />
                </body>
                </html>";

                var renderer = new ChromePdfRenderer();
                var pdf = renderer.RenderHtmlAsPdf(html);
                pdf.SaveAs("optimized_image.pdf");
            }

            if (resizedImage != originalImage)
                resizedImage.Dispose();
        }
    }
}

Imports IronPdf
Imports System
Imports System.Drawing
Imports System.Drawing.Imaging
Imports System.IO

Public Class OptimizedImageEmbedding
    Public Shared Sub EmbedOptimizedImage(imagePath As String, Optional maxWidth As Integer = 800)
        ' Load and resize image if necessary
        Using originalImage As Image = Image.FromFile(imagePath)
            Dim resizedImage As Image = originalImage

            If originalImage.Width > maxWidth Then
                Dim ratio As Double = CDbl(maxWidth) / originalImage.Width
                Dim newHeight As Integer = CInt(originalImage.Height * ratio)
                resizedImage = New Bitmap(originalImage, maxWidth, newHeight)
            End If

            ' Convert to optimized JPEG
            Using ms As New MemoryStream()
                Dim encoder As ImageCodecInfo = ImageCodecInfo.GetImageEncoders().First(Function(c) c.FormatID = ImageFormat.Jpeg.Guid)
                Dim encoderParams As New EncoderParameters(1)
                encoderParams.Param(0) = New EncoderParameter(System.Drawing.Imaging.Encoder.Quality, 85L)

                resizedImage.Save(ms, encoder, encoderParams)
                Dim imageBytes As Byte() = ms.ToArray()

                ' Create DataURI
                Dim dataUri As String = $"data:image/jpeg;base64,{Convert.ToBase64String(imageBytes)}"

                ' Generate PDF
                Dim html As String = $"
                <html>
                <body>
                    <h1>Optimized Image Example</h1>
                    <img src='{dataUri}' style='max-width: 100%;' />
                </body>
                </html>"

                Dim renderer As New ChromePdfRenderer()
                Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(html)
                pdf.SaveAs("optimized_image.pdf")
            End Using

            If resizedImage IsNot originalImage Then
                resizedImage.Dispose()
            End If
        End Using
    End Sub
End Class

$vbLabelText $csharpLabel

Técnicas avançadas e melhores práticas

Ao trabalhar com DataURIs em ambientes de produção, implemente mecanismos de cache para evitar a codificação repetida das mesmas imagens. Isso é particularmente importante ao gerar vários PDFs com recursos compartilhados. Aproveite os recursos do IronPDF para obter melhor desempenho ao processar várias imagens.

Para documentos complexos com muitas imagens, use uma abordagem híbrida onde as imagens críticas são incorporadas como DataURIs enquanto as imagens maiores e opcionais são referenciadas externamente. Isso equilibra documentos autossuficientes com tamanhos de arquivo razoáveis.

Você também pode fornecer uma string HTML inteira ou um documento PDF como uma matriz de bytes usando a integração ASP.NET MVC do IronPDF. Essa técnica funciona bem na criação de aplicações web que geram e disponibilizam PDFs dinamicamente.

Para técnicas avançadas de manipulação de PDF, incluindo marcas d'água, assinaturas digitais e criação de formulários, o IronPDF oferece documentação completa e exemplos para criar soluções robustas em PDF.

Perguntas frequentes

O que são DataURIs e por que usá-los para geração de PDFs?

DataURIs são um esquema que incorpora dados diretamente no código HTML ou CSS como strings codificadas em base64, eliminando a necessidade de arquivos de imagem separados. O IronPDF oferece suporte completo a DataURIs, tornando-os ideais para ambientes em nuvem, sistemas distribuídos ou quando você precisa de PDFs autocontidos sem dependências de arquivos externos.

Como faço para converter uma imagem para o formato DataURI para incorporá-la em um PDF?

Com o IronPDF, a conversão de uma imagem para DataURI envolve três etapas: Primeiro, leia os bytes da imagem usando System.IO.File.ReadAllBytes(). Segundo, converta os bytes para base64 usando Convert.ToBase64String(). Finalmente, incorpore a string base64 em uma tag HTML img com o formato 'data:image/png;base64,[base64string]'.

Quais formatos de imagem são suportados ao incorporar imagens como DataURIs?

O IronPDF suporta a incorporação de vários formatos de imagem como DataURIs, incluindo PNG, JPEG, GIF e SVG. Essa flexibilidade permite que você trabalhe com diferentes tipos de imagem, mantendo o controle total sobre o fluxo de trabalho de geração de PDFs.

Posso incorporar várias imagens usando DataURIs em um único PDF?

Sim, o IronPDF permite incorporar várias imagens usando DataURIs em um único documento PDF. Basta converter cada imagem para sua representação em base64 e incluí-las na sua marcação HTML antes de renderizar com o ChromePdfRenderer do IronPDF.

Existe algum impacto no desempenho ao usar DataURIs em vez de referências de arquivo?

Embora os DataURIs aumentem o tamanho da string HTML devido à codificação base64, o IronPDF lida com a conversão de forma eficiente. Essa compensação vale a pena quando você precisa de PDFs autossuficientes, sem dependências externas, especialmente em ambientes de nuvem ou distribuídos.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais ...

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.

Ver licenças

Destaque do cliente:

Destaque do desenvolvedor:

Webinários:

Experimente gratuitamente por 30 dias.

Nesta página

Incorporar imagens com DataURIs em C# e VB para renderização de PDF

Instale IronPDF com o Gerenciador de Pacotes NuGet

Copie e execute este trecho de código.

Implante para testar em seu ambiente de produção.

Fluxo de trabalho mínimo (5 etapas)

Como faço para incorporar imagens usando DataURIs em PDFs?

Exemplo básico de incorporação de imagens

Por que devo usar DataURIs em vez de referências de arquivo?

Quais formatos de imagem são suportados?

Como a codificação Base64 afeta o tamanho do arquivo?

Técnicas avançadas e melhores práticas

Perguntas frequentes

O que são DataURIs e por que usá-los para geração de PDFs?

Como faço para converter uma imagem para o formato DataURI para incorporá-la em um PDF?

Quais formatos de imagem são suportados ao incorporar imagens como DataURIs?

Posso incorporar várias imagens usando DataURIs em um único PDF?

Existe algum impacto no desempenho ao usar DataURIs em vez de referências de arquivo?

Ainda está rolando a tela?

Equipe de suporte de ferro

Experimente gratuitamente por 30 dias.

Nesta página

Incorporar imagens com DataURIs em C# e VB para renderização de PDF

Instale IronPDF com o Gerenciador de Pacotes NuGet

Copie e execute este trecho de código.

Implante para testar em seu ambiente de produção.

Fluxo de trabalho mínimo (5 etapas)

Como faço para incorporar imagens usando DataURIs em PDFs?

Exemplo básico de incorporação de imagens

Por que devo usar DataURIs em vez de referências de arquivo?

Quais formatos de imagem são suportados?

Como a codificação Base64 afeta o tamanho do arquivo?

Técnicas avançadas e melhores práticas

Perguntas frequentes

O que são DataURIs e por que usá-los para geração de PDFs?

Como faço para converter uma imagem para o formato DataURI para incorporá-la em um PDF?

Quais formatos de imagem são suportados ao incorporar imagens como DataURIs?

Posso incorporar várias imagens usando DataURIs em um único PDF?

Existe algum impacto no desempenho ao usar DataURIs em vez de referências de arquivo?

Ainda está rolando a tela?

Obtenha o seu GRÁTIS

Want to deploy IronSuite to a live project for FREE?

What’s included?

Thank You

Want to deploy IronSuite to a live project for FREE?

What’s included?

Aprovado por milhões de engenheiros em todo o mundo.

Equipe de suporte de ferro