Converter HTML para PDF é um requisito comum em muitos aplicativos de software, como gerar relatórios, faturas ou salvar páginas da web como PDFs. Neste artigo, exploraremos três bibliotecas populares de código aberto para conversão de HTML para PDF em C#, analisaremos seus pontos fortes e limitações e discutiremos por que o IronPDF é uma alternativa melhor em diversos casos.
PuppeteerSharp é um wrapper .NET para o Puppeteer, um navegador Chromium sem interface gráfica. Permite aos desenvolvedores converter documentos HTML em PDFs, utilizando o mecanismo de renderização Chromium.
O PuppeteerSharp oferece controle preciso sobre o processo de renderização. Eis um exemplo:
using PuppeteerSharp;
using System.Threading.Tasks;
class Program
{
static async Task Main(string[] args)
{
// Download Chromium to ensure compatibility with PuppeteerSharp
await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultChromiumRevision);
// Launch a headless instance of Chromium browser
using (var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true }))
{
// Open a new browser page
var page = await browser.NewPageAsync();
// Set the HTML content for the page
await page.SetContentAsync("<html><body><h1>Hello, PuppeteerSharp!</h1></body></html>");
// Generate a PDF from the rendered HTML content
await page.PdfAsync("output.pdf");
Console.WriteLine("PDF Generated Successfully!");
}
}
}Imports PuppeteerSharp
Imports System.Threading.Tasks
Friend Class Program
Shared Async Function Main(ByVal args() As String) As Task
' Download Chromium to ensure compatibility with PuppeteerSharp
Await (New BrowserFetcher()).DownloadAsync(BrowserFetcher.DefaultChromiumRevision)
' Launch a headless instance of Chromium browser
Using browser = Await Puppeteer.LaunchAsync(New LaunchOptions With {.Headless = True})
' Open a new browser page
Dim page = Await browser.NewPageAsync()
' Set the HTML content for the page
Await page.SetContentAsync("<html><body><h1>Hello, PuppeteerSharp!</h1></body></html>")
' Generate a PDF from the rendered HTML content
Await page.PdfAsync("output.pdf")
Console.WriteLine("PDF Generated Successfully!")
End Using
End Function
End ClassBaixe o Chromium: O PuppeteerSharp baixa automaticamente a versão necessária do Chromium para garantir a compatibilidade.
Iniciar Navegador: Inicie uma instância sem cabeça do Chromium usando Puppeteer.LaunchAsync().
Definir Conteúdo HTML: Carregue o HTML desejado na página do navegador usando page.SetContentAsync().
Gerar PDF: Use o método page.PdfAsync() para gerar um PDF do conteúdo renderizado.
O resultado é um PDF de alta qualidade (output.pdf) que replica com precisão a estrutura e o design do HTML.
PDFSharp é uma biblioteca de código aberto poderosa para criação e manipulação de arquivos PDF em C#. Embora não ofereça suporte direto à renderização de HTML, destaca-se por fornecer aos desenvolvedores ferramentas para gerar e editar documentos PDF programaticamente.
Criação de PDF: O PDFSharp permite aos desenvolvedores gerar novos arquivos PDF do zero, definindo tamanhos de página, adicionando texto, formas, imagens e mais.
Manipulação de PDFs existentes: Você pode modificar documentos PDF existentes, como mesclar, dividir ou extrair conteúdo.
Capacidades de Desenho: O PDFSharp oferece capacidades gráficas robustas para adicionar designs personalizados aos arquivos PDF usando a classe XGraphics.
Leveza: É uma biblioteca leve, o que a torna ideal para projetos onde simplicidade e velocidade são prioridades.
using PdfSharp.Pdf;
using PdfSharp.Drawing;
using HtmlAgilityPack;
class Program
{
static void Main(string[] args)
{
// Example HTML content
string htmlContent = "<html><body><h1>Hello, PdfSharp!</h1><p>This is an example of HTML to PDF.</p></body></html>";
// Parse HTML using HtmlAgilityPack (You need to add HtmlAgilityPack via NuGet)
var htmlDoc = new HtmlDocument();
htmlDoc.LoadHtml(htmlContent);
// Create a new PDF document
PdfDocument pdfDocument = new PdfDocument
{
Info = { Title = "HTML to PDF Example" }
};
// Add a new page to the document
PdfPage page = pdfDocument.AddPage();
XGraphics gfx = XGraphics.FromPdfPage(page);
XFont titleFont = new XFont("Arial", 20, XFontStyle.Bold);
XFont textFont = new XFont("Arial", 12, XFontStyle.Regular);
// Draw the parsed HTML content
int yPosition = 50; // Starting Y position
foreach (var node in htmlDoc.DocumentNode.SelectNodes("//h1 | //p"))
{
if (node.Name == "h1")
{
gfx.DrawString(node.InnerText, titleFont, XBrushes.Black, new XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft);
yPosition += 30; // Adjust spacing
}
else if (node.Name == "p")
{
gfx.DrawString(node.InnerText, textFont, XBrushes.Black, new XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft);
yPosition += 20; // Adjust spacing
}
}
// Save the PDF document
string outputFilePath = "HtmlToPdf.pdf";
pdfDocument.Save(outputFilePath);
System.Console.WriteLine($"PDF file created: {outputFilePath}");
}
}Imports PdfSharp.Pdf
Imports PdfSharp.Drawing
Imports HtmlAgilityPack
Friend Class Program
Shared Sub Main(ByVal args() As String)
' Example HTML content
Dim htmlContent As String = "<html><body><h1>Hello, PdfSharp!</h1><p>This is an example of HTML to PDF.</p></body></html>"
' Parse HTML using HtmlAgilityPack (You need to add HtmlAgilityPack via NuGet)
Dim htmlDoc = New HtmlDocument()
htmlDoc.LoadHtml(htmlContent)
' Create a new PDF document
Dim pdfDocument As New PdfDocument With {
.Info = { Title = "HTML to PDF Example" }
}
' Add a new page to the document
Dim page As PdfPage = pdfDocument.AddPage()
Dim gfx As XGraphics = XGraphics.FromPdfPage(page)
Dim titleFont As New XFont("Arial", 20, XFontStyle.Bold)
Dim textFont As New XFont("Arial", 12, XFontStyle.Regular)
' Draw the parsed HTML content
Dim yPosition As Integer = 50 ' Starting Y position
For Each node In htmlDoc.DocumentNode.SelectNodes("//h1 | //p")
If node.Name = "h1" Then
gfx.DrawString(node.InnerText, titleFont, XBrushes.Black, New XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft)
yPosition += 30 ' Adjust spacing
ElseIf node.Name = "p" Then
gfx.DrawString(node.InnerText, textFont, XBrushes.Black, New XRect(50, yPosition, page.Width - 100, page.Height - 100), XStringFormats.TopLeft)
yPosition += 20 ' Adjust spacing
End If
Next node
' Save the PDF document
Dim outputFilePath As String = "HtmlToPdf.pdf"
pdfDocument.Save(outputFilePath)
System.Console.WriteLine($"PDF file created: {outputFilePath}")
End Sub
End ClassAnálise de HTML: O exemplo utiliza HtmlAgilityPack (uma biblioteca de código aberto para analisar e manipular HTML) para extrair conteúdo de texto das tags <h1> e <p>.
Desenhando Conteúdo: A classe XGraphics do PDFSharp é usada para renderizar o conteúdo HTML analisado como texto em uma página PDF.
Limitações: Esta abordagem funciona para estruturas HTML simples, mas não lida com layouts complexos, estilos ou JavaScript.
O PDFium .NET é uma biblioteca abrangente baseada no projeto de código aberto PDFium, projetada para visualizar, editar e manipular arquivos PDF em aplicativos .NET . Ele fornece aos desenvolvedores ferramentas poderosas para criar, editar e extrair conteúdo de PDFs, tornando-o adequado para uma ampla gama de casos de uso. É basicamente uma biblioteca gratuita para conversão de HTML em PDF.
Criação e Edição de PDF:
Extração de Texto e Imagem:
Controle de Visualizador de PDF:
Compatibility:
Recursos Avançados:
using Pdfium.Net.SDK;
using System;
class Program
{
static void Main(string[] args)
{
// Initialize Pdfium.NET SDK functionalities
PdfCommon.Initialize();
// Create a new PDF document
PdfDocument pdfDocument = PdfDocument.CreateNew();
// Add a page to the document (A4 size in points: 8.27 x 11.69 inches)
var page = pdfDocument.Pages.InsertPageAt(pdfDocument.Pages.Count, 595, 842);
// Sample HTML content to be parsed and rendered manually
var htmlContent = "<h1>Hello, Pdfium.NET SDK!</h1><p>This is an example of HTML to PDF.</p>";
// Example: Manually render text since Pdfium.NET doesn't render HTML directly
var font = PdfFont.CreateFont(pdfDocument, "Arial");
page.AddText(72, 750, font, 20, "Hello, Pdfium.NET SDK!");
page.AddText(72, 700, font, 14, "This is an example of HTML to PDF.");
// Save the document to a file
string outputFilePath = "HtmlToPdfExample.pdf";
pdfDocument.Save(outputFilePath, SaveFlags.Default);
Console.WriteLine($"PDF created successfully: {outputFilePath}");
}
}Imports Pdfium.Net.SDK
Imports System
Friend Class Program
Shared Sub Main(ByVal args() As String)
' Initialize Pdfium.NET SDK functionalities
PdfCommon.Initialize()
' Create a new PDF document
Dim pdfDocument As PdfDocument = PdfDocument.CreateNew()
' Add a page to the document (A4 size in points: 8.27 x 11.69 inches)
Dim page = pdfDocument.Pages.InsertPageAt(pdfDocument.Pages.Count, 595, 842)
' Sample HTML content to be parsed and rendered manually
Dim htmlContent = "<h1>Hello, Pdfium.NET SDK!</h1><p>This is an example of HTML to PDF.</p>"
' Example: Manually render text since Pdfium.NET doesn't render HTML directly
Dim font = PdfFont.CreateFont(pdfDocument, "Arial")
page.AddText(72, 750, font, 20, "Hello, Pdfium.NET SDK!")
page.AddText(72, 700, font, 14, "This is an example of HTML to PDF.")
' Save the document to a file
Dim outputFilePath As String = "HtmlToPdfExample.pdf"
pdfDocument.Save(outputFilePath, SaveFlags.Default)
Console.WriteLine($"PDF created successfully: {outputFilePath}")
End Sub
End ClassInicialização do SDK: O método PdfCommon.Initialize() inicializa as funcionalidades do Pdfium.NET.
Criando um PDF: Um novo documento PDF é criado usando PdfDocument.CreateNew().
Adicionando páginas: As páginas são inseridas no PDF com dimensões específicas (por exemplo, tamanho A4).
Renderização de conteúdo HTML: Como o SDK .NET da Pdfium não oferece suporte nativo à renderização de HTML, você precisa analisar e renderizar manualmente os elementos HTML como texto, formas ou imagens.
Salvando o PDF: O documento é salvo em um caminho de arquivo com o método Save().
IronPDF é uma biblioteca de nível profissional projetada para desenvolvedores .NET converterem conteúdo HTML em PDFs de alta qualidade sem esforço. Conhecido por sua confiabilidade, recursos avançados e facilidade de uso, o IronPDF agiliza o processo de desenvolvimento, oferecendo renderização precisa e funcionalidade robusta. Eis por que o IronPDF é uma solução excepcional:
Conversão direta de HTML para PDF: Crie documentos PDF diretamente usando o IronPDF com conteúdo HTML, incluindo CSS e JavaScript, em PDFs totalmente formatados. Com apenas algumas linhas de código, os desenvolvedores podem gerar PDFs a partir de páginas da web, strings HTML brutas ou arquivos HTML locais.
Recursos modernos de renderização: Compatível com os mais recentes padrões da web, o IronPDF garante a renderização precisa de layouts complexos, estilos e elementos interativos para converter páginas HTML em PDF.
Recursos avançados de PDF: O IronPDF oferece amplas opções de personalização, como adicionar cabeçalhos, rodapés, marcas d'água, anotações e marcadores. Ele também oferece suporte à fusão, divisão e edição de PDFs existentes.
Desempenho e escalabilidade: Otimizado tanto para aplicações de pequena escala quanto para ambientes corporativos, o IronPDF oferece desempenho rápido e confiável para projetos de qualquer tamanho.
Facilidade de integração: Projetado for .NET Framework e .NET Core, o IronPDF se integra perfeitamente com aplicativos C#, oferecendo aos desenvolvedores um processo de configuração simples e documentação completa.
O IronPDF se destaca entre outras soluções devido à sua combinação de recursos, suporte ao desenvolvedor e desempenho. Ao contrário das alternativas de código aberto que muitas vezes exigem configurações extensas ou dependências externas, o IronPDF é uma solução independente que simplifica o desenvolvimento sem sacrificar a funcionalidade. Seja para gerar faturas, relatórios ou arquivar conteúdo da web, o IronPDF oferece aos desenvolvedores as ferramentas necessárias para obter resultados de nível profissional com rapidez e eficiência.
IronPDF é uma escolha prática para desenvolvedores que valorizam confiabilidade, escalabilidade e facilidade de uso em seus fluxos de trabalho de HTML para PDF.
using IronPdf;
class Program
{
static void Main()
{
// Specify license key
IronPdf.License.LicenseKey = "Your Key";
// Create a new HtmlToPdf object using ChromePdfRenderer
var Renderer = new ChromePdfRenderer();
// Define the HTML string to be converted
string htmlContent = "<html><body><h1>IronPDF: Better than Open source</h1></body></html>";
// Convert the HTML string to a PDF document
var document = Renderer.RenderHtmlAsPdf(htmlContent);
// Save the PDF document to a file
document.SaveAs("html2Pdf.pdf");
Console.WriteLine("PDF generated and saved successfully!");
}
}Imports IronPdf
Friend Class Program
Shared Sub Main()
' Specify license key
IronPdf.License.LicenseKey = "Your Key"
' Create a new HtmlToPdf object using ChromePdfRenderer
Dim Renderer = New ChromePdfRenderer()
' Define the HTML string to be converted
Dim htmlContent As String = "<html><body><h1>IronPDF: Better than Open source</h1></body></html>"
' Convert the HTML string to a PDF document
Dim document = Renderer.RenderHtmlAsPdf(htmlContent)
' Save the PDF document to a file
document.SaveAs("html2Pdf.pdf")
Console.WriteLine("PDF generated and saved successfully!")
End Sub
End ClassConfiguração da chave de licença: O programa inicia definindo a chave de licença do IronPDF , que é necessária para desbloquear todas as funcionalidades da biblioteca.
Criando o Renderizador: Uma instância de ChromePdfRenderer é inicializada. Este componente é responsável por converter conteúdo HTML em um documento PDF , atuando como uma ponte entre o HTML bruto e o resultado final.
Definindo Conteúdo HTML: Uma variável de string, htmlContent, é criada para armazenar a estrutura HTML que será convertida em um PDF. Neste exemplo, contém um título simples.
Convertendo HTML para PDF: O método RenderHtmlAsPdf() é chamado na instância de ChromePdfRenderer, passando a string HTML como entrada. Esta função processa o conteúdo e o transforma em um documento PDF .
Salvando o PDF: Finalmente, o PDF gerado é salvo em um arquivo chamado "html2Pdf.pdf" utilizando o método SaveAs(), armazenando-o no disco para acesso futuro.
O IronPDF requer uma chave de licença válida para funcionar plenamente. Você pode obter uma licença de avaliação no site oficial. Antes de usar a biblioteca IronPDF , defina a chave de licença da seguinte forma:
IronPdf.License.LicenseKey = "your key";IronPdf.License.LicenseKey = "your key"Isso garante que a biblioteca funcione sem limitações.
O PuppeteerSharp é uma excelente opção para desenvolvedores que precisam de renderização precisa de HTML para PDF, especialmente ao lidar com páginas da web complexas. No entanto, para aplicações que exigem recursos avançados específicos para PDF, otimização de desempenho e facilidade de integração, ferramentas profissionais como o IronPDF costumam ser a melhor opção.
O PDFSharp é uma ótima escolha para criação e manipulação de PDF programática leve, especialmente para projetos com requisitos simples. No entanto, se sua aplicação exigir a conversão de HTML para PDF ou recursos avançados de PDF, o IronPDF oferece uma solução mais eficiente e completa.
Embora o SDK .NET da Pdfium seja uma ferramenta robusta para manipulação de PDFs, o IronPDF oferece suporte nativo para conversão direta de HTML para PDF, incluindo a renderização de HTML, CSS e JavaScript modernos. IronPDF simplifica o fluxo de trabalho com métodos integrados como HtmlToPdf.RenderHtmlAsPdf(), tornando-o mais rápido e eficiente para desenvolvedores.
Seja para gerar faturas, relatórios ou arquivar conteúdo da web, o IronPDF oferece aos desenvolvedores as ferramentas necessárias para obter resultados de nível profissional com rapidez e eficiência.
IronPDF é uma escolha prática para desenvolvedores que valorizam confiabilidade, escalabilidade e facilidade de uso em seus fluxos de trabalho de HTML para PDF.
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.
