Ir para o conteúdo do rodapé
USANDO O IRONPDF

Conversão de PDF em C# (Tutorial para desenvolvedores)

Conversão de PDF em C# (Tutorial para desenvolvedores)

O IronPDF permite converter documentos para PDF em aplicações C# com apenas algumas linhas de código. Ele realiza conversões de HTML para PDF e de imagem para PDF de forma integrada nas plataformas Windows, Linux e macOS.

Este artigo mostra como funciona a conversão de PDF usando o IronPDF , a biblioteca PDF for .NET e .NET Core. Independentemente de você estar trabalhando no Windows , Linux ou macOS , o IronPDF oferece suporte multiplataforma para todas as suas necessidades de PDF. A biblioteca oferece documentação completa e tutoriais para ajudá-lo a começar rapidamente.

O que é o IronPDF?

  1. Geração de PDF: Crie facilmente documentos PDF programaticamente em C# a partir de várias fontes, incluindo HTML, imagens, texto e arquivos existentes.
  2. Conversão de HTML para PDF: Converta conteúdo HTML em PDFs , incluindo páginas da web ou modelos HTML, em PDFs de alta qualidade com controle total sobre estilo e formatação.
  3. Conversão de imagem para PDF : Converta arquivos de imagem (como JPEG, PNG ou BMP) em documentos PDF, permitindo a fácil integração de imagens em relatórios e documentos em PDF.
  4. Manipulação de PDF: Recursos abrangentes de edição de PDF, incluindo extração de texto , mesclagem e divisão de PDFs , rotação, além de adição, modificação ou remoção de conteúdo e anotações.
  5. Formulários PDF: Crie, preencha e extraia dados de formulários PDF , tornando-os adequados para aplicações que exigem formulários interativos e coleta de dados.

Seja para gerar PDFs do zero , converter páginas HTML , imagens ou documentos existentes para o formato PDF, ou manipular PDFs já existentes , o IronPDF oferece APIs simples para realizar essas tarefas. A biblioteca utiliza um mecanismo de renderização do Chrome para garantir que suas conversões de HTML tenham a aparência correta. Para obter uma lista completa de recursos, consulte o site Visão geral dos recursos do IronPDF .

  1. Geração de PDF : Crie PDFs programaticamente a partir de HTML, imagens, texto e arquivos. Suporta tamanhos , orientação e margens personalizados. Também funciona com idiomas internacionais .
  2. Conversão de HTML para PDF : Converta HTML para PDF com formatação completa. Suporta mídia CSS , JavaScript e fontes da web . Compatível com WebGL e designs responsivos .
  3. Conversão de imagem para PDF : Converta arquivos JPEG, PNG ou BMP para PDF. Suporta conversão de TIFF e gráficos SVG . É possível incorporar imagens com DataURIs .
  4. Manipulação de PDF : Edite PDFs com extração de texto , mesclagem/divisão e anotações . Também permite redigir texto , adicionar carimbos e gerenciar metadados .
  5. Formulários em PDF : Crie e preencha formulários em PDF . Permite criar e editar formulários . É possível transformar PDFs em conteúdo estático.

Como faço para criar um novo projeto no Visual Studio?

Antes de começarmos a programar, vamos configurar um novo projeto de Aplicativo de Console em C#. Se você é iniciante no desenvolvimento .NET , o guia de início rápido pode ser útil para dicas adicionais de configuração. Os desenvolvedores F# também podem usar o IronPDF com abordagens de programação funcional.

  1. Abra o Visual Studio e crie um novo projeto clicando em Arquivo > Novo > Projeto .

    Menu Arquivo do Visual Studio expandido mostrando várias opções, incluindo Novo Projeto, Clonar Repositório, Abrir Arquivo/Projeto e Salvar, com atalhos de teclado O menu Arquivo no Visual Studio oferece acesso rápido a funções essenciais de gerenciamento de projetos, desde a criação de novos projetos até a clonagem de repositórios de sistemas de controle de versão.

  2. Uma nova janela será aberta. Selecione o modelo Aplicativo de Console e clique em Avançar na parte inferior. Este modelo é perfeito para aprender o básico de PDF antes de passar para tipos de projetos mais complexos, como aplicativos Blazor ouASP.NET MVC .

    Caixa de diálogo Criar um novo projeto do Visual Studio mostrando o modelo de Aplicativo de Console selecionado para criar um aplicativo de linha de comando .NET Core compatível com Windows, Linux e macOS. O modelo de Aplicativo de Console no Visual Studio fornece um ponto de partida para a criação de aplicativos de linha de comando multiplataforma usando o .NET Core.

  3. Na janela seguinte, dê um nome ao seu projeto e escolha um local, depois clique em Avançar . Considere organizar os projetos em uma pasta dedicada para facilitar o acesso a exemplos de código e arquivos de amostra .

    Caixa de diálogo Configurar seu novo projeto do Visual Studio mostrando a configuração de um aplicativo de console chamado Conversão de PDF com a localização do projeto e as configurações da solução. Etapa 2: Configurar o novo projeto de Aplicativo de Console com as configurações de nomenclatura e localização apropriadas para o aplicativo de conversão de PDF.

  4. Selecione a estrutura desejada e clique em Criar . Para aplicações modernas, utilize o .NET 6 ou posterior para obter o melhor desempenho e suporte. As versões recentes oferecem desempenho aprimorado e recursos assíncronos .

    Diálogo de criação de projeto do Visual Studio mostrando a página 'Informações adicionais' com o .NET 5.0 selecionado como a estrutura de destino para um aplicativo de console. A etapa final na criação de um novo aplicativo de console no Visual Studio é a seleção da estrutura de destino. Observe que o .NET 5.0 está marcado como "Sem suporte" - considere usar o .NET 6.0 ou o .NET 8.0 para projetos atuais.

Seu projeto está pronto. Vamos instalar o IronPDF.

Como faço para instalar o IronPDF?

O IronPDF oferece diversos métodos de instalação. Vamos usar o gerenciador de pacotes NuGet aqui. Você pode explorar métodos de instalação avançados para cenários específicos, incluindo opções do Windows Installer e configurações do Linux .

  1. No Visual Studio, abra o menu Ferramentas e passe o cursor sobre Gerenciador de Pacotes NuGet .
  2. Clique em Gerenciar pacotes NuGet para soluções.

    Menu Ferramentas do Visual Studio expandido mostrando o submenu Gerenciador de Pacotes NuGet com opções para Console do Gerenciador de Pacotes, Gerenciar Pacotes NuGet para a Solução e Configurações do Gerenciador de Pacotes O menu Ferramentas no Visual Studio fornece acesso aos recursos do Gerenciador de Pacotes NuGet , que são essenciais para gerenciar bibliotecas externas e dependências em projetos .NET.

  3. Uma nova janela será aberta. Clique na aba Procurar e pesquise por "IronPDF".
  4. Selecione IronPDF e clique em Instalar. Para implantações menores, considere o IronPdf.Slim .
  5. Você também pode instalar através do Console do Gerenciador de Pacotes:

    Install-Package IronPdf

Ou faça o download diretamente da página do IronPDF no NuGet . Para contêineres, consulte o guia de implantação do Docker ou execute o IronPDF como um contêiner remoto .

Como faço para converter arquivos para PDF usando o IronPDF?

Vamos explorar a conversão de diferentes formatos de documentos para PDF. O IronPDF oferece amplas opções de renderização para personalizar a saída, incluindo registro personalizado e monitoramento de desempenho .

  1. Converter arquivos HTML em documentos PDF
  2. Converter imagem em documento PDF

Como faço para converter arquivos HTML em PDF?

Converter HTML para PDF é incrivelmente simples com o IronPDF. A biblioteca suporta recursos avançados como cabeçalhos e rodapés , quebras de página e CSS personalizado . Você pode manipular layouts do Bootstrap e implementar o gerenciamento de cookies para conteúdo autenticado.

Veja como converter um arquivo HTML em PDF:

using IronPdf;

// Create an instance of the ChromePdfRenderer class.
var renderer = new ChromePdfRenderer();

// Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;

// Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___";

// Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024;

// Render the HTML file as a PDF document.
var pdf = renderer.RenderHtmlFileAsPdf("invoice.html");

// Optional: Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Keywords = "invoice, pdf, conversion";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Save the PDF document as an output file.
pdf.SaveAs("output.pdf");

// Alternative: Save with compression
pdf.CompressImages(80);
pdf.SaveAs("compressed-output.pdf");
using IronPdf;

// Create an instance of the ChromePdfRenderer class.
var renderer = new ChromePdfRenderer();

// Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;

// Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = true;

// Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___";

// Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024;

// Render the HTML file as a PDF document.
var pdf = renderer.RenderHtmlFileAsPdf("invoice.html");

// Optional: Add metadata
pdf.MetaData.Author = "Your Company";
pdf.MetaData.Keywords = "invoice, pdf, conversion";
pdf.MetaData.CreationDate = System.DateTime.Now;

// Save the PDF document as an output file.
pdf.SaveAs("output.pdf");

// Alternative: Save with compression
pdf.CompressImages(80);
pdf.SaveAs("compressed-output.pdf");
Imports IronPdf

' Create an instance of the ChromePdfRenderer class.
Dim renderer As New ChromePdfRenderer()

' Optional: Configure rendering options for better output
renderer.RenderingOptions.MarginTop = 25
renderer.RenderingOptions.MarginBottom = 25
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4

' Enable JavaScript execution for dynamic content
renderer.RenderingOptions.EnableJavaScript = True

' Set print CSS media type for proper formatting
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

' Add custom headers for authenticated content
renderer.RenderingOptions.CustomCssUrl = "___PROTECTED_URL_142___"

' Configure viewport for responsive design
renderer.RenderingOptions.ViewPortWidth = 1024

' Render the HTML file as a PDF document.
Dim pdf = renderer.RenderHtmlFileAsPdf("invoice.html")

' Optional: Add metadata
pdf.MetaData.Author = "Your Company"
pdf.MetaData.Keywords = "invoice, pdf, conversion"
pdf.MetaData.CreationDate = System.DateTime.Now

' Save the PDF document as an output file.
pdf.SaveAs("output.pdf")

' Alternative: Save with compression
pdf.CompressImages(80)
pdf.SaveAs("compressed-output.pdf")
$vbLabelText   $csharpLabel

Este código transforma um arquivo HTML ("invoice.html") em um documento PDF. Ao criar um ChromePdfRenderer, você está usando o mecanismo Chromium para garantir uma conversão precisa que preserva a aparência da sua página da web. As opções de renderização permitem definir margens e tamanho de papel personalizados . O PDF resultante é salvo como "output.pdf" com uma simples chamada SaveAs. Esse processo simplificado torna a conversão de HTML para PDF simples para a geração de PDFs em C#.

Para cenários complexos, explore a conversão de URLs para PDF , o trabalho com strings HTML ou a conversão de arquivos CSHTML em aplicações ASP.NET MVC. Você também pode renderizar gráficos em JavaScript e lidar com aplicações Angular .

Qual é a aparência do arquivo HTML convertido para PDF?

PDF viewer interface showing a sample invoice template with placeholder company information, two line items totaling $190.00, and navigation controls Exemplo de um modelo básico de fatura visualizado em um leitor de PDF, demonstrando elementos padrão de fatura, incluindo detalhes do remetente/destinatário, serviços discriminados e cálculos de preços.

Para melhorar a geração de PDFs, considere adicionar números de página , sumário ou marcas d'água personalizadas . Você pode otimizar a saída com linearização para uma visualização mais rápida na web.

Como faço para converter imagens em PDF?

Vamos converter imagens em documentos PDF. Com um código mínimo, você pode converter arquivos JPEG, PNG, BMP e SVG . A biblioteca também oferece suporte a recursos avançados, como desenhar linhas e retângulos ou adicionar texto e bitmaps a PDFs existentes.

Quais formatos de imagem posso converter?

 Captura de tela da página inicial do IronPDF exibindo os principais recursos da biblioteca C# PDF para criação, edição e leitura de PDFs em aplicativos .NET . IronPDF oferece uma biblioteca C# completa para PDF com suporte para conversão de HTML para PDF, compatibilidade entre plataformas e mais de 50 recursos para manipulação de PDF em aplicações .NET .

using IronPdf;
using System.IO;
using System.Linq;

// Enumerate all PNG files from the specified directory.
var imageFiles = Directory.EnumerateFiles("assets").Where(f => f.EndsWith(".png"));

// Create an instance of ImageToPdfConverter
var imageToPdf = new ImageToPdfConverter();

// Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage;
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4;

// Set margins for professional appearance
imageToPdf.PaperMargins = new IronPdf.Imaging.PdfPaperMargins(25);

// Control image quality and compression
imageToPdf.ImageQuality = 90; // 0-100 quality scale

// Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf");

// Alternative: Convert a single image with custom settings
var singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png");
singleImagePdf.SaveAs("single-image.pdf");

// Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo";
singleImagePdf.MetaData.Subject = "Brand Assets";
singleImagePdf.MetaData.CreationDate = DateTime.Now;
singleImagePdf.SaveAs("logo-with-metadata.pdf");
using IronPdf;
using System.IO;
using System.Linq;

// Enumerate all PNG files from the specified directory.
var imageFiles = Directory.EnumerateFiles("assets").Where(f => f.EndsWith(".png"));

// Create an instance of ImageToPdfConverter
var imageToPdf = new ImageToPdfConverter();

// Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage;
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4;

// Set margins for professional appearance
imageToPdf.PaperMargins = new IronPdf.Imaging.PdfPaperMargins(25);

// Control image quality and compression
imageToPdf.ImageQuality = 90; // 0-100 quality scale

// Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf");

// Alternative: Convert a single image with custom settings
var singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png");
singleImagePdf.SaveAs("single-image.pdf");

// Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo";
singleImagePdf.MetaData.Subject = "Brand Assets";
singleImagePdf.MetaData.CreationDate = DateTime.Now;
singleImagePdf.SaveAs("logo-with-metadata.pdf");
Imports IronPdf
Imports System.IO
Imports System.Linq

' Enumerate all PNG files from the specified directory.
Dim imageFiles = Directory.EnumerateFiles("assets").Where(Function(f) f.EndsWith(".png"))

' Create an instance of ImageToPdfConverter
Dim imageToPdf = New ImageToPdfConverter()

' Optional: Set rendering options for better control
imageToPdf.ImageBehavior = ImageBehavior.CropPage
imageToPdf.PaperSize = IronPdf.Imaging.PdfPaperSize.A4

' Set margins for professional appearance
imageToPdf.PaperMargins = New IronPdf.Imaging.PdfPaperMargins(25)

' Control image quality and compression
imageToPdf.ImageQuality = 90 ' 0-100 quality scale

' Convert the images to a PDF document.
ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("composite.pdf")

' Alternative: Convert a single image with custom settings
Dim singleImagePdf = imageToPdf.ImageToPdf("assets/logo.png")
singleImagePdf.SaveAs("single-image.pdf")

' Advanced: Add metadata to image PDF
singleImagePdf.MetaData.Title = "Company Logo"
singleImagePdf.MetaData.Subject = "Brand Assets"
singleImagePdf.MetaData.CreationDate = DateTime.Now
singleImagePdf.SaveAs("logo-with-metadata.pdf")
$vbLabelText   $csharpLabel

Este código mostra duas abordagens: conversão em lote de vários arquivos PNG e conversão de imagem única. Ele encontra todos os arquivos PNG na pasta de recursos e os converte em PDF usando ImageToPdfConverter.ImageToPdf. A propriedade ImageBehavior controla o posicionamento da imagem na página. Finalmente, ele salva o PDF usando SaveAs.

Para manipulação avançada de imagens, explore a incorporação de imagens do Armazenamento de Blobs do Azure ou o trabalho com imagens codificadas em Base64 . Você também pode rasterizar PDFs em imagens para conversão inversa.

Qual é a aparência da imagem convertida para PDF?

Captura de tela da página de documentação do IronPDF mostrando a página inicial da biblioteca C# PDF com recursos para criar e editar PDFs em aplicativos .NET A página inicial da biblioteca IronPDF exibe recursos importantes, incluindo conversão de HTML para PDF, suporte multiplataforma para frameworks .NET e um botão de destaque para "Teste Gratuito de 30 Dias".

Quais recursos avançados de conversão de PDF estão disponíveis?

Além da conversão básica de HTML e imagens, o IronPDF oferece muitos recursos avançados para trabalhos completos com PDFs. A biblioteca oferece suporte a operações assíncronas e processamento paralelo para cenários de alto desempenho.

Quais tipos de documentos posso converter para PDF?

O IronPDF suporta a conversão de vários formatos:

Como posso melhorar meus PDFs gerados?

Após converter os documentos para PDF, aprimore-os com:

Como otimizar o desempenho da conversão de PDFs?

Para um melhor desempenho em suas aplicações:

E quanto às considerações específicas de cada plataforma?

O IronPDF oferece suporte abrangente à plataforma:

Quais são os principais pontos a serem destacados?

Este artigo explorou a conversão de PDF em C# para gerenciamento e compartilhamento de documentos. Com C# e IronPDF, você pode integrar facilmente a funcionalidade de PDF em seus aplicativos. Desde a geração de PDFs até a conversão de HTML, imagens e documentos existentes, o IronPDF oferece recursos abrangentes. Os exemplos de código mostraram como converter documentos HTML e imagens em PDFs com o mínimo esforço.

A força do IronPDF reside em seus recursos abrangentes:

  • Suporte multiplataforma para Windows , Linux , macOS e nuvem
  • Vários formatos de conversão , incluindo HTML, imagens, DOCX, RTF e muito mais.
  • Funcionalidades avançadas como assinaturas digitais, criptografia, formulários e anotações.
  • Otimização de desempenho por meio de operações assíncronas e processamento paralelo
  • Renderização com perfeição de pixels usando o mecanismo de renderização do Chrome
  • Documentação completa com referência de API e guias de solução de problemas

Conforme demonstrado, o IronPDF simplifica tarefas complexas em PDF, tornando-se valioso para desenvolvedores que aprimoram o processamento de documentos em aplicativos .NET . Seja para criar aplicativos web , softwares para desktop ou serviços em nuvem , o IronPDF oferece as ferramentas para geração profissional de PDFs. O conjunto de funcionalidades da biblioteca inclui a criação , edição , conversão e proteção de documentos PDF.

Para baixar a biblioteca de conversão de PDF, visite o pacote NuGet do IronPDF . Veja também o tutorial de conversão de HTML para PDF com o IronPDF . Para aprendizado prático, explore nossos exemplos de código e tutoriais abrangentes . Os desenvolvedores do IronPDF podem escolher entre várias licenças que melhor se adaptem às suas necessidades. Está disponível um período de teste gratuito . Para obter informações completas sobre preços e licenciamento, visite a página de informações sobre licenciamento do IronPDF . Confira o changelog para as últimas atualizações e melhorias.

Perguntas frequentes

Como posso converter HTML para PDF em C#?

Você pode usar o método RenderHtmlAsPdf do IronPDF para converter strings HTML em PDFs. Você também pode converter arquivos HTML em PDFs usando o RenderHtmlFileAsPdf .

Quais são os passos envolvidos na configuração do IronPDF em um projeto do Visual Studio?

Para configurar o IronPDF em um projeto do Visual Studio, use o Gerenciador de Pacotes NuGet para pesquisar por 'IronPDF' e instalar o pacote mais recente. Esse processo integra o IronPDF ao seu projeto, permitindo que você acesse suas funcionalidades de PDF.

Quais são as funcionalidades do IronPDF para manipulação de PDFs?

O IronPDF oferece recursos abrangentes de manipulação de PDFs, incluindo extração de texto, fusão e divisão de PDFs, rotação de páginas e modificação de conteúdo e anotações.

Posso converter imagens para PDF usando o IronPDF?

Sim, você pode converter imagens para PDF usando o método ImageToPdfConverter do IronPDF, que suporta formatos de imagem como JPEG, PNG e BMP.

Como o IronPDF mantém a formatação durante a conversão para PDF?

O IronPDF garante que a formatação original do documento seja preservada durante a conversão, renderizando com precisão o conteúdo HTML e as imagens em formato PDF, graças ao seu robusto mecanismo de renderização.

Existe alguma versão de avaliação disponível para o IronPDF?

Sim, o IronPDF oferece um período de teste gratuito. Para informações detalhadas sobre preços e licenciamento, consulte a página de informações sobre licenciamento do IronPDF.

Quais linguagens de programação são suportadas pelo IronPDF?

O IronPDF oferece suporte à integração com aplicativos C#, VB.NET e F#, proporcionando uma ampla gama de possibilidades para desenvolvedores que trabalham no ecossistema .NET.

Onde posso encontrar mais tutoriais ou suporte para usar o IronPDF?

Tutoriais adicionais e suporte para o uso do IronPDF estão disponíveis no site e nas páginas de documentação do IronPDF, incluindo guias sobre conversão de HTML para PDF e outras funcionalidades.

O IronPDF é totalmente compatível com o .NET 10?

Sim — o IronPDF é totalmente compatível com o .NET 10, funcionando perfeitamente sem qualquer configuração especial. Ele oferece suporte aos recursos mais recentes de tempo de execução e linguagem do .NET 10, incluindo implantação multiplataforma e APIs modernas e compatíveis com operações assíncronas.

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

Equipe de suporte de ferro

Estamos online 24 horas por dia, 5 dias por semana.
Bater papo
E-mail
Liga para mim