O IronPDF oferece uma solução simples e gratuita para converter imagens em PDF em C# através do método ImageToPdf, permitindo que os desenvolvedores convertam imagens únicas ou múltiplas com apenas algumas linhas de código e configurações de página personalizáveis.
Diversas bibliotecas permitem que desenvolvedores C# convertam imagens em PDFs. Encontrar uma biblioteca gratuita, fácil de usar e com bom desempenho pode ser um desafio, já que algumas são pagas, complexas ou têm funcionalidades limitadas. Dentre essas bibliotecas, o IronPDF se destaca como uma biblioteca C# gratuita, eficiente e fácil de implementar. O produto vem acompanhado de documentação completa e suporte dedicado.
IronPDF é uma biblioteca .NET para gerar, ler, editar e salvar arquivos PDF em projetos .NET . O IronPDF oferece conversão de HTML para PDF for .NET 5, Core, Standard e Framework, com suporte completo a HTML para PDF, incluindo CSS3 e JS. A biblioteca utiliza um mecanismo de renderização do Chrome para garantir a geração de PDFs com perfeição de pixels a partir de diversas fontes.
Vamos ver como criar um projeto de exemplo para aprender a converter imagens em PDF. Este tutorial irá guiá-lo pelo processo de instalação , conversão básica de imagens e recursos avançados para lidar com várias imagens e diferentes formatos.
ImageToPdfPara criar um novo projeto, abra o Microsoft Visual Studio. Recomenda-se o uso da versão mais recente do Visual Studio. Os passos para criar um novo projeto podem variar entre as versões, mas o restante deve ser o mesmo em todas elas.
ImageToPDFConverter").O novo projeto será criado conforme mostrado abaixo. A estrutura do projeto incluirá um arquivo Program.cs onde escreveremos nosso código de conversão de imagem.
Crie um novo aplicativo de console no Visual Studio.
O IronPDF é compatível com uma ampla gama de versões do .NET , incluindo .NET Framework 4.6.2+, .NET Core 3.1+ e .NET 5/6/7/8+. Para novos projetos, recomenda-se usar a versão LTS (Suporte de Longo Prazo) mais recente do .NET para obter desempenho ideal e atualizações de segurança. A biblioteca também funciona perfeitamente nas plataformas Windows , Linux e macOS .
Em seguida, instale o pacote NuGet IronPDF neste projeto para usar seus recursos. A grande vantagem do IronPDF é que ele elimina a frustração de gerar documentos PDF, pois não depende de APIs proprietárias. A renderização de HTML para PDF gera PDFs com qualidade impecável a partir de formatos de documento de padrão aberto: HTML, JS, CSS, JPG, PNG, GIF e SVG. Resumindo, utiliza as habilidades que os desenvolvedores já possuem.
Para instalar o pacote NuGet , acesse Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes . A seguinte janela será exibida:
Interface do usuário do console do gerenciador de pacotes
Em seguida, digite o seguinte comando no Console do Gerenciador de Pacotes:
Pressione Enter. O processo de instalação fará o download do IronPDF e suas dependências, incluindo os componentes necessários do mecanismo de renderização do Chrome .
Instale o pacote IronPDF no Console do Gerenciador de Pacotes
Você também pode instalar o IronPDF através de:
<PackageReference Include="IronPdf" Version="*" /> ao seu arquivo .csprojdotnet add package IronPdf no terminalPara implantações no Azure , você pode precisar de configurações adicionais. Da mesma forma, os ambientes Docker exigem etapas de configuração específicas.
O próximo passo mostrará como converter a seguinte imagem em PDF. O IronPDF simplifica esse processo com sua funcionalidade de conversão de imagem para PDF .
O IronPDF suporta uma ampla variedade de formatos de imagem para conversão em PDF:
A imagem de exemplo
Para usar a biblioteca, referencie a biblioteca IronPDF no arquivo program.cs. Escreva o seguinte trecho de código no topo do arquivo:
using IronPdf;
using IronPdf.Imaging;
using System.Linq;Imports IronPdf
Imports IronPdf.Imaging
Imports System.LinqEm seguida, escreva o seguinte código dentro da função principal. Isso converterá um arquivo JPG em um arquivo PDF:
public static void Main(string[] args)
{
// Convert a single image to the PDF document
PdfDocument doc = ImageToPdfConverter.ImageToPdf(@"D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage);
// Optional: Set document properties
doc.MetaData.Author = "IronPDF Tutorial";
doc.MetaData.Title = "Image to PDF Conversion";
doc.MetaData.Subject = "Converting JPG to PDF";
// Save the resulting PDF to the specified path
doc.SaveAs(@"D:\Iron Software\ImageToPDF\bird.pdf");
Console.WriteLine("PDF created successfully!");
}Public Shared Sub Main(ByVal args As String())
' Convert a single image to the PDF document
Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf("D:\Iron Software\ImageToPDF\bird.jpg", IronPdf.Imaging.ImageBehavior.CropPage)
' Optional: Set document properties
doc.MetaData.Author = "IronPDF Tutorial"
doc.MetaData.Title = "Image to PDF Conversion"
doc.MetaData.Subject = "Converting JPG to PDF"
' Save the resulting PDF to the specified path
doc.SaveAs("D:\Iron Software\ImageToPDF\bird.pdf")
Console.WriteLine("PDF created successfully!")
End SubImageBehavior Afeta a Saída?No exemplo de código acima, a classe ImageToPdfConverter fornecida pelo IronPDF é usada para conversão de imagem. O método ImageToPdf pode ser usado para criar documentos PDF a partir de imagens. Ele aceita tanto arquivos de imagem quanto um objeto System.Drawing como entrada.
O método estático ImageToPdf converte um único arquivo de imagem em um documento PDF idêntico com dimensões correspondentes. São necessários dois argumentos: Caminho da Imagem e Comportamento da Imagem (como a imagem será exibida no papel). O enum ImageBehavior fornece várias opções:
CropPage: Define o tamanho da página do PDF para corresponder às dimensões da imagemCenteredOnPage: Centraliza a imagem na página sem redimensionarFitToPage: Escala a imagem para caber dentro das margens da páginaFitToPageAndMaintainAspectRatio: Escala mantendo a proporçãoImaging.ImageBehavior.CropPage definirá o tamanho do papel igual ao tamanho da imagem. O tamanho de página padrão é A4. Você pode defini-lo através da seguinte linha de código:
ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.Letter;ImageToPdfConverter.PaperSize = IronPdf.Rendering.PdfPaperSize.LetterVocê também pode definir tamanhos de página personalizados para requisitos específicos:
// Set custom page size in millimeters
ImageToPdfConverter.PaperSize = new IronPdf.Rendering.PdfPaperSize(210, 297);' Set custom page size in millimeters
ImageToPdfConverter.PaperSize = New IronPdf.Rendering.PdfPaperSize(210, 297)São oferecidas várias opções de tamanho de página, que você pode configurar de acordo com suas necessidades. O IronPDF é compatível com todos os tamanhos de papel padrão:
Você também pode configurar a orientação da página (retrato ou paisagem) e margens personalizadas para seus PDFs.
O exemplo a seguir converterá imagens JPG em um novo documento. Isso é particularmente útil para criar álbuns de fotos, catálogos ou combinar documentos digitalizados:
public static void Main(string[] args)
{
// Enumerate and filter JPG files from the specified directory
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
.Where(f => f.EndsWith(".jpg") || f.EndsWith(".jpeg"));
// Sort files alphabetically (optional)
var sortedImageFiles = imageFiles.OrderBy(f => f);
// Convert the images to a PDF document
PdfDocument doc = ImageToPdfConverter.ImageToPdf(sortedImageFiles);
// Add page numbers to each page
for (int i = 0; i < doc.PageCount; i++)
{
doc.AddTextFooter($"Page {i + 1} of {doc.PageCount}",
FontFamily.Arial,
fontSize: 10,
y: 25);
}
// Save the combined PDF
doc.SaveAs(@"D:\Iron Software\ImageToPDF\JpgToPDF.pdf");
Console.WriteLine($"Combined {doc.PageCount} images into a single PDF!");
}Public Shared Sub Main(args As String())
' Enumerate and filter JPG files from the specified directory
Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\") _
.Where(Function(f) f.EndsWith(".jpg") OrElse f.EndsWith(".jpeg"))
' Sort files alphabetically (optional)
Dim sortedImageFiles = imageFiles.OrderBy(Function(f) f)
' Convert the images to a PDF document
Dim doc As PdfDocument = ImageToPdfConverter.ImageToPdf(sortedImageFiles)
' Add page numbers to each page
For i As Integer = 0 To doc.PageCount - 1
doc.AddTextFooter($"Page {i + 1} of {doc.PageCount}",
FontFamily.Arial,
fontSize:=10,
y:=25)
Next
' Save the combined PDF
doc.SaveAs("D:\Iron Software\ImageToPDF\JpgToPDF.pdf")
Console.WriteLine($"Combined {doc.PageCount} images into a single PDF!")
End SubNo código acima, System.IO.Directory.EnumerateFiles recupera todos os arquivos disponíveis na pasta especificada. A cláusula Where filtra todas as imagens JPG daquela pasta e as armazena na coleção imageFiles. Se você tiver PNG ou qualquer outro formato de imagem, você pode simplesmente adicioná-lo à consulta Where:
// Filter multiple image formats
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
.Where(f => f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) ||
f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) ||
f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) ||
f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) ||
f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) ||
f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase));' Filter multiple image formats
Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\") _
.Where(Function(f) f.EndsWith(".jpg", StringComparison.OrdinalIgnoreCase) OrElse _
f.EndsWith(".jpeg", StringComparison.OrdinalIgnoreCase) OrElse _
f.EndsWith(".png", StringComparison.OrdinalIgnoreCase) OrElse _
f.EndsWith(".bmp", StringComparison.OrdinalIgnoreCase) OrElse _
f.EndsWith(".gif", StringComparison.OrdinalIgnoreCase) OrElse _
f.EndsWith(".tiff", StringComparison.OrdinalIgnoreCase))Você também pode usar uma abordagem mais concisa com uma variedade de extensões:
string[] imageExtensions = { ".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff" };
var imageFiles = System.IO.Directory.EnumerateFiles(@"D:\Iron Software\ImageToPDF\")
.Where(f => imageExtensions.Any(ext => f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)));Dim imageExtensions As String() = {".jpg", ".jpeg", ".png", ".bmp", ".gif", ".tiff"}
Dim imageFiles = System.IO.Directory.EnumerateFiles("D:\Iron Software\ImageToPDF\") _
.Where(Function(f) imageExtensions.Any(Function(ext) f.EndsWith(ext, StringComparison.OrdinalIgnoreCase)))Por padrão, as imagens aparecem na ordem retornada pelo sistema de arquivos, que pode não ser alfabética. Para controlar a ordem, você pode classificar os arquivos:
imageFiles.OrderBy(f => f)imageFiles.OrderBy(f => new FileInfo(f).CreationTime)imageFiles.OrderBy(f => new FileInfo(f).Length)A próxima linha pegará todas as imagens e as combinará em um único documento PDF. Cada imagem se torna uma página separada no PDF.
O seguinte trecho de código imprimirá o documento usando os recursos de impressão do IronPDF:
// Print using default printer
doc.Print();
// Print silently (without print dialog)
doc.Print(showPreview: false);
// Print to a specific printer
var printerName = "Microsoft Print to PDF";
doc.Print(printerName);' Print using default printer
doc.Print()
' Print silently (without print dialog)
doc.Print(showPreview:=False)
' Print to a specific printer
Dim printerName As String = "Microsoft Print to PDF"
doc.Print(printerName)O método Print fornecido pela classe PdfDocument imprimirá o documento usando a impressora padrão. Também oferece a opção de alterar o nome da impressora e outras configurações. Para opções avançadas de impressão:
// Advanced printing with settings
using System.Drawing.Printing;
var printDocument = doc.GetPrintDocument();
printDocument.PrinterSettings.PrinterName = "Your Printer Name";
printDocument.PrinterSettings.Copies = 2;
printDocument.PrinterSettings.Collate = true;
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages;
printDocument.PrinterSettings.FromPage = 1;
printDocument.PrinterSettings.ToPage = 3;
printDocument.Print();' Advanced printing with settings
Imports System.Drawing.Printing
Dim printDocument = doc.GetPrintDocument()
printDocument.PrinterSettings.PrinterName = "Your Printer Name"
printDocument.PrinterSettings.Copies = 2
printDocument.PrinterSettings.Collate = True
printDocument.PrinterSettings.PrintRange = PrintRange.SomePages
printDocument.PrinterSettings.FromPage = 1
printDocument.PrinterSettings.ToPage = 3
printDocument.Print()Para obter mais detalhes sobre como imprimir documentos, consulte este exemplo de impressão em PDF . Você também pode explorar opções de impressão em rede para ambientes corporativos.
Este tutorial mostrou uma maneira muito fácil de converter imagens em um arquivo PDF com exemplos de código, seja convertendo uma única imagem em PDF ou combinando várias imagens em um único arquivo PDF. Além disso, também explicou como imprimir documentos com uma única linha de código.
Principais pontos abordados:
Além disso, algumas características importantes do IronPDF incluem:
O IronPDF oferece diversos recursos úteis. Explore estes recursos:
Visite a página inicial do IronPDF para obter uma visão geral do produto.
Para casos de uso específicos, explore:
O IronPDF faz parte do pacote de Iron Software . O Iron Suite inclui produtos adicionais úteis, como IronXL para operações de Excel, IronBarcode para geração de códigos de barra, IronOCR para reconhecimento de texto e IronWebScraper para extração de dados da web. Você pode economizar até 250% comprando o pacote completo Iron Suite, pois atualmente você pode adquirir os cinco produtos pelo preço de apenas dois. Por favor, visite a página de detalhes de licenciamento para obter mais informações.
IronPDF oferece:
Experimente o IronPDF gratuitamente por 30 dias com uma licença de avaliação ou explore as opções de licenciamento para sua equipe.
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 bem estruturados e visualmente atraentes.
IronPDF faz parte do IRON SUITE.
10 produtos de API .NET para seus documentos de escritório
Quando você precisa que seu PDF tenha a aparência de HTML, rapidamente.
