Como converter imagens em PDF em C#

Como converter imagem em PDF em C

This article was translated from English: Does it need improvement?
Translated
View the article in English

O IronPDF permite que desenvolvedores C# convertam uma ou várias imagens (JPG, PNG, TIFF) em documentos PDF usando o método ImageToPdfConverter.ImageToPdf com comportamentos de posicionamento e opções de renderização personalizáveis.

Converter imagem em PDF combina vários arquivos de imagem (como JPG, PNG ou TIFF) em um único documento PDF. Esse processo cria portfólios, apresentações ou relatórios digitais, facilitando o compartilhamento e o armazenamento de coleções de imagens em um formato organizado e universalmente legível.

O IronPDF converte uma ou várias imagens em PDFs com posicionamentos e comportamentos de imagem exclusivos. Esses comportamentos incluem ajustar à página, centralizar na página e recortar a página. Além disso, você pode adicionar cabeçalhos e rodapés de texto e HTML usando o IronPDF , aplicar marcas d'água com o IronPDF , definir tamanhos de página personalizados e incluir sobreposições de fundo e primeiro plano.

Início rápido: Converter imagem para PDF com o IronPDF

Converta imagem para PDF usando a classe ImageToPdfConverter do IronPDF. Este exemplo demonstra como transformar um arquivo de imagem em PDF, permitindo que você integre a funcionalidade de conversão de imagem em PDF em seus aplicativos .NET C#. Com um código mínimo, você pode converter imagens em PDF para criar portfólios ou relatórios digitais.

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf
  2. Copie e execute este trecho de código.

    IronPdf.ImageToPdfConverter.ImageToPdf("path/to/image.png").SaveAs("imageToPdf.pdf");
  3. Implante para testar em seu ambiente de produção.

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

    arrow pointer


Como faço para converter uma única imagem em PDF?

Use o método estático ImageToPdf dentro da classe ImageToPdfConverter para converter uma imagem em um documento PDF. Este método requer apenas o caminho do arquivo da imagem e a converte em um documento PDF com posicionamento e comportamento de imagem padrão. Os formatos de imagem suportados incluem .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp e .pjpeg.

Antes de começar, certifique-se de ter instalado o IronPDF via NuGet ou baixado o instalador para Windows . A biblioteca funciona perfeitamente nas plataformas Windows , macOS e Linux , tornando-a versátil para diversos ambientes de desenvolvimento.

Quais formatos de imagem são suportados?

Membros da equipe da IronSoftware com uniformes roxos em evento da empresa

O IronPDF suporta uma ampla gama de formatos de imagem, incluindo formatos raster como JPEG, PNG, BMP e GIF, bem como formatos vetoriais como gráficos SVG . A biblioteca é compatível com formatos padrão e modernos, como WebP e AVIF, garantindo a compatibilidade com aplicações web contemporâneas. Para necessidades específicas, trabalhe com arquivos de ícones (.ico) e arquivos de cursor (.cur).

Como faço para escrever o código?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

Para cenários mais avançados, explore a geração assíncrona de PDFs para melhorar o desempenho ao processar várias imagens. A biblioteca também oferece suporte a tamanhos de papel e margens personalizados para garantir que suas imagens sejam exibidas exatamente como você precisa.

Qual é a aparência do resultado?


Como faço para converter várias imagens em PDF?

Para converter várias imagens em um documento PDF, forneça um objeto IEnumerable contendo os caminhos dos arquivos em vez de um único caminho de arquivo. Isso gera um documento PDF com posicionamento e comportamento de imagem padrão.

Ao trabalhar com várias imagens, considere as opções de compressão de PDF disponíveis para otimizar o tamanho do arquivo sem sacrificar a qualidade. Isso é particularmente importante na criação de portfólios ou álbuns de fotos extensos.

Como faço para processar várias imagens simultaneamente?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-multiple-images.cs
using IronPdf;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

// Retrieve all JPG and JPEG image paths in the 'images' folder.
IEnumerable<String> imagePaths = Directory.EnumerateFiles("images").Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));

// Convert images to a PDF
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePaths);

// Export the PDF
pdf.SaveAs("imagesToPdf.pdf");
Imports IronPdf
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq

' Retrieve all JPG and JPEG image paths in the 'images' folder.
Private imagePaths As IEnumerable(Of String) = Directory.EnumerateFiles("images").Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))

' Convert images to a PDF
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePaths)

' Export the PDF
pdf.SaveAs("imagesToPdf.pdf")
$vbLabelText   $csharpLabel

Qual é a aparência do PDF com várias imagens?


Como posso controlar o posicionamento e os comportamentos das imagens?

O IronPDF oferece diversas opções de posicionamento e comportamento de imagens. Você pode centralizar a imagem na página ou ajustá-la ao tamanho da página, mantendo sua proporção. Todas as opções de posicionamento de imagem e comportamentos disponíveis são:

  • TopLeftCornerOfPage: A imagem está localizada no canto superior esquerdo da página.
  • TopRightCornerOfPage: A imagem está localizada no canto superior direito da página.
  • CenteredOnPage: A imagem está centralizada na página.
  • FitToPageAndMaintainAspectRatio: A imagem se ajusta à página mantendo sua proporção original.
  • BottomLeftCornerOfPage: A imagem está localizada no canto inferior esquerdo da página.
  • BottomRightCornerOfPage: A imagem está localizada no canto inferior direito da página.
  • FitToPage: A imagem se ajusta à página.
  • CropPage: A página foi ajustada para caber na imagem.

Essas opções de posicionamento funcionam perfeitamente com os recursos de orientação e rotação de página do IronPDF, permitindo que você crie documentos com aparência profissional, independentemente das dimensões da sua imagem.

Como aplicar comportamentos de imagem no código?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-image-behavior.cs
using IronPdf;
using IronPdf.Imaging;

string imagePath = "meetOurTeam.jpg";

// Convert an image to a PDF with image behavior of centered on page
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage);

// Export the PDF
pdf.SaveAs("imageToPdf.pdf");
Imports IronPdf
Imports IronPdf.Imaging

Private imagePath As String = "meetOurTeam.jpg"

' Convert an image to a PDF with image behavior of centered on page
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, ImageBehavior.CenteredOnPage)

' Export the PDF
pdf.SaveAs("imageToPdf.pdf")
$vbLabelText   $csharpLabel

Quais são as diferenças visuais entre os comportamentos das imagens?

Membros da equipe da Iron Software com roupas esportivas roxas da marca em evento da empresa.
Membros da equipe da Iron Software com roupas esportivas roxas da marca em evento corporativo ao ar livre
Membros da equipe da Iron Software com roupas esportivas roxas da marca em evento da empresa.
Membros da equipe IronSoftware com uniformes roxos em evento esportivo da empresa
Membros da equipe da Iron Software com uniforme esportivo roxo em evento esportivo da empresa com sobreposição
Membros da equipe da Iron Software vestindo roupas esportivas roxas com a marca da empresa em evento esportivo corporativo com sobreposição de texto da marca.
Membros da equipe IronSoftware com uniformes roxos em evento corporativo com a inscrição
Membros da equipe da Iron Software com roupas esportivas roxas da marca em evento corporativo da equipe.

Como faço para personalizar as opções de renderização de PDF?

O método estático ImageToPdf converte imagens importando-as como tags HTML <img> e, em seguida, convertendo o HTML em PDF. Isso permite que você passe o objeto ChromePdfRenderOptions como um terceiro parâmetro para personalizar diretamente o processo de renderização.

Essa abordagem fornece acesso a todas as opções de renderização avançadas disponíveis no IronPDF, incluindo a execução de JavaScript , tipos de mídia CSS e configuração da viewport. Você pode até incorporar fontes e ícones da web para melhorar o apelo visual do seu documento.

Como adiciono cabeçalhos e estilos personalizados?

:path=/static-assets/pdf/content-code-examples/how-to/image-to-pdf-convert-one-image-rendering-options.cs
using IronPdf;

string imagePath = "meetOurTeam.jpg";

ChromePdfRenderOptions options = new ChromePdfRenderOptions()
{
    HtmlHeader = new HtmlHeaderFooter()
    {
        HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
        DrawDividerLine = true,
    },
};

// Convert an image to a PDF with custom header
PdfDocument pdf = ImageToPdfConverter.ImageToPdf(imagePath, options: options);

// Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf");
Imports IronPdf

Private imagePath As String = "meetOurTeam.jpg"

Private options As New ChromePdfRenderOptions() With {
	.HtmlHeader = New HtmlHeaderFooter() With {
		.HtmlFragment = "<h1 style='color: #2a95d5;'>Content Header</h1>",
		.DrawDividerLine = True
	}
}

' Convert an image to a PDF with custom header
Private pdf As PdfDocument = ImageToPdfConverter.ImageToPdf(imagePath, options:= options)

' Export the PDF
pdf.SaveAs("imageToPdfWithHeader.pdf")
$vbLabelText   $csharpLabel

Para requisitos mais complexos de cabeçalho e rodapé, explore nosso guia completo sobre cabeçalhos e rodapés HTML . Você também pode adicionar números de página aos seus PDFs baseados em imagens para melhor organização.

Qual é a aparência da saída personalizada?

Como gerenciar o desempenho de grandes coleções de imagens?

Ao lidar com grandes coleções de imagens ou imagens de alta resolução, implemente técnicas assíncronas e de multithreading para melhorar o desempenho. Para aplicações empresariais, explore as estratégias de otimização de desempenho do IronPDF para garantir um funcionamento tranquilo mesmo com cargas de trabalho substanciais.

Além disso, ao trabalhar com imagens armazenadas em serviços de nuvem, consulte nosso guia sobre como incorporar imagens do Azure Blob Storage para uma integração perfeita com a nuvem.

Como faço para converter PDFs de volta em imagens?

Para converter ou rasterizar um documento PDF em imagens, consulte nosso guia sobre como rasterizar PDFs em imagens .

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

Perguntas frequentes

Quais formatos de imagem podem ser convertidos para PDF?

O IronPDF oferece suporte a uma ampla gama de formatos de imagem para conversão de PDF, incluindo .bmp, .jpeg, .jpg, .gif, .png, .svg, .tif, .tiff, .webp, .apng, .avif, .cur, .dib, .ico, .jfif, .jif, .jpe, .pjp e .pjpeg. Isso inclui formatos raster como JPEG, PNG, BMP e GIF, bem como formatos vetoriais como gráficos SVG.

Como faço para converter uma única imagem em PDF em C#?

Para converter uma única imagem em PDF usando o IronPDF, utilize o método estático `ImageToPdf` da classe `ImageToPdfConverter`. Basta fornecer o caminho do arquivo da sua imagem: `IronPDF.ImageToPdfConverter.ImageToPdf("caminho/para/imagem.png").SaveAs("imageToPdf.pdf").` Essa solução de uma linha converte sua imagem em um documento PDF com posicionamento e comportamento padrão.

Posso converter várias imagens em um único documento PDF?

Sim, o IronPDF permite converter várias imagens (JPG, PNG, TIFF) em um único documento PDF usando o método ImageToPdfConverter.ImageToPdf. Isso é perfeito para criar portfólios digitais, apresentações ou relatórios onde você precisa combinar vários arquivos de imagem em um formato PDF organizado e universalmente legível.

Quais opções de personalização estão disponíveis ao converter imagens para PDF?

O IronPDF oferece amplas opções de personalização, incluindo posicionamento e comportamento exclusivos de imagens (ajuste à página, centralização, recorte), adição de cabeçalhos e rodapés de texto e HTML, aplicação de marcas d'água, definição de tamanhos de página personalizados e inclusão de sobreposições de fundo e primeiro plano. Esses recursos permitem que você crie documentos PDF com aparência profissional a partir de suas imagens.

Quais plataformas são compatíveis com o recurso de conversão de imagem para PDF?

A conversão de imagens para PDF do IronPDF funciona perfeitamente em plataformas Windows, macOS e Linux, tornando-o versátil para diversos ambientes de desenvolvimento. Você pode instalá-lo via NuGet ou baixar o instalador para Windows para começar a usar na sua plataforma preferida.

Como posso controlar o posicionamento das imagens ao converter para PDF?

O IronPDF oferece opções exclusivas de posicionamento e comportamento de imagens, incluindo ajuste à página, centralização e recorte. Esses recursos de exportação de imagens proporcionam controle preciso sobre a aparência das imagens no documento PDF final, garantindo uma apresentação profissional do seu conteúdo visual.

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

Leia mais
Analisado por
Jeff Fritz
Jeffrey T. Fritz
Gerente de Programa Principal - Equipe da Comunidade .NET
Jeff também é Gerente de Programa Principal das equipes do .NET e do Visual Studio. Ele é o produtor executivo da série de conferências virtuais .NET Conf e apresenta o "Fritz and Friends", uma transmissão ao vivo para desenvolvedores que vai ao ar duas vezes por semana, onde ele conversa sobre tecnologia e escreve código junto com os espectadores. Jeff cria workshops, apresentações e planeja conteúdo para os maiores eventos de desenvolvedores da Microsoft, incluindo o Microsoft Build, o Microsoft Ignite, a .NET Conf e o Microsoft MVP Summit.
Pronto para começar?
Nuget Downloads 18,318,263 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

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