A geração programática de documentos PDF pode ser complexa devido à sua complexidade, especialmente ao incluir imagens, tabelas, texto, formatação e outros recursos.

O principal desafio é descobrir como converter um documento de texto simples em formato PDF. Existem diversos métodos que podem ser utilizados, mas é essencial escolher um que preserve a formatação do documento original.

Neste tutorial, compararei a biblioteca Telerik PdfProcessing da Progress Software Corporation com a IronPDF da Iron Software em relação à capacidade de ambas em gerar documentos PDF.

Processamento de PDF da Telerik

A documentação do Telerik PdfProcessing , parte do portfólio de aplicativos de processamento de documentos da Progress, permite criar PDFs e exportá-los sem escrever nenhum código. Possui funcionalidades como blocos de texto, imagens, formulários, tabelas, importação e exportação. Além disso, a biblioteca oferece recursos perfeitos para edição fluida. O aplicativo PdfProcessing está disponível para plataformas web, desktop e mobile.

Biblioteca IronPDF .NET PDF

IronPDF é uma biblioteca .NET para PDF que pode gerar PDFs sem a necessidade do Adobe Acrobat ou de outros softwares de terceiros. A biblioteca pode criar PDFs do zero ou exportar componentes .NET existentes (como páginas da web do site oficial do ASP.NET , interfaces de usuário WPF, etc.) para arquivos PDF.

Instalação

Nesta seção, abordarei como instalar as bibliotecas IronPDF e Telerik Document Processing.

Instalação das bibliotecas de processamento de documentos da Telerik

Para criar um documento PDF a partir de HTML usando o pacote Telerik Document Processing, precisamos instalar três bibliotecas:

1. Telerik.Documents.Core.Trial
2. Telerik.Documents.Flow.FormatProviders.Doc.Trial
3. Telerik.Documents.Flow.FormatProviders.Pdf.Trial
4. Telerik.Documents.Flow.Trial

Você pode instalar essas bibliotecas usando o Gerenciador de Pacotes NuGet .

Bibliotecas Telerik e Kendo UI

Instalação da Biblioteca IronPDF C#.NET PDF

Você pode instalar o IronPDF de três maneiras:

1. Instale usando o Console do Gerenciador de Pacotes NuGet
2. Instale com o NuGet Visual Studio GUI
3. Baixe o arquivo DLL do IronPDF para instalação manual

Para instalar usando o Console do Gerenciador de Pacotes, você precisará digitar o seguinte comando no console.

Install-Package IronPdf

Este comando instalará a versão mais recente da biblioteca IronPDF no projeto. Claro, você sempre pode verificar a versão mais recente do IronPDF na página do NuGet do IronPDF.

Gere PDFs usando o Telerik

Telerik suporta a conversão de HTML para PDF usando o addon de biblioteca RadFlowDocument. Ele pode converter um documento HTML contendo uma string HTML em um documento PDF.

Você pode usar o seguinte código para converter HTML em PDF usando o Telerik.

using Telerik.Windows.Documents.Flow.FormatProviders.Html;
using Telerik.Windows.Documents.Flow.Model;

// Create an HTML format provider for importing HTML files.
HtmlFormatProvider htmlProvider = new Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider();

// Create a document instance from the content of an HTML file.
RadFlowDocument document = htmlProvider.Import(File.ReadAllText(@"C:\HTML Website\website\index.html"));

// Create a PDF format provider for exporting the document.
Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider pdfProvider = new Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider();

// Export the document to a byte array.
byte[] pdfBytes = pdfProvider.Export(document);

// Save the PDF byte array to a file.
File.WriteAllBytes(@"C:/test.pdf", pdfBytes);

using Telerik.Windows.Documents.Flow.FormatProviders.Html;
using Telerik.Windows.Documents.Flow.Model;

// Create an HTML format provider for importing HTML files.
HtmlFormatProvider htmlProvider = new Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider();

// Create a document instance from the content of an HTML file.
RadFlowDocument document = htmlProvider.Import(File.ReadAllText(@"C:\HTML Website\website\index.html"));

// Create a PDF format provider for exporting the document.
Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider pdfProvider = new Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider();

// Export the document to a byte array.
byte[] pdfBytes = pdfProvider.Export(document);

// Save the PDF byte array to a file.
File.WriteAllBytes(@"C:/test.pdf", pdfBytes);

Imports Telerik.Windows.Documents.Flow.FormatProviders.Html
Imports Telerik.Windows.Documents.Flow.Model

' Create an HTML format provider for importing HTML files.
Private htmlProvider As HtmlFormatProvider = New Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider()

' Create a document instance from the content of an HTML file.
Private document As RadFlowDocument = htmlProvider.Import(File.ReadAllText("C:\HTML Website\website\index.html"))

' Create a PDF format provider for exporting the document.
Private pdfProvider As New Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider()

' Export the document to a byte array.
Private pdfBytes() As Byte = pdfProvider.Export(document)

' Save the PDF byte array to a file.
File.WriteAllBytes("C:/test.pdf", pdfBytes)

Imports Telerik.Windows.Documents.Flow.FormatProviders.Html
Imports Telerik.Windows.Documents.Flow.Model

' Create an HTML format provider for importing HTML files.
Private htmlProvider As HtmlFormatProvider = New Telerik.Windows.Documents.Flow.FormatProviders.Html.HtmlFormatProvider()

' Create a document instance from the content of an HTML file.
Private document As RadFlowDocument = htmlProvider.Import(File.ReadAllText("C:\HTML Website\website\index.html"))

' Create a PDF format provider for exporting the document.
Private pdfProvider As New Telerik.Windows.Documents.Flow.FormatProviders.Pdf.PdfFormatProvider()

' Export the document to a byte array.
Private pdfBytes() As Byte = pdfProvider.Export(document)

' Save the PDF byte array to a file.
File.WriteAllBytes("C:/test.pdf", pdfBytes)

O código acima é um tanto complexo. Primeiro, você precisará criar um HtmlFormatProvider e um RadFlowDocument. Importe o arquivo HTML usando a função Import do HtmlFormatProvider, e use o objeto RadFlowDocument retornado para produzir um PdfFormatProvider. Por fim, use o método WriteAllBytes no PdfFormatProvider para exportar o arquivo PDF para uma localização específica.

A saída gerada pela Telerik não é boa. A Telerik não manteve a interface do usuário do documento HTML nem carregou nenhuma das imagens.

Saída Telerik

Gere um PDF usando o IronPDF.

O IronPDF pode gerar PDFs usando arquivos HTML, strings HTML e URLs.

HTML para PDF

Utilize o código a seguir para criar um documento PDF a partir de um arquivo HTML.

using IronPdf;

// Create an instance of ChromePdfRenderer
var IronRenderer = new ChromePdfRenderer();

// Set the renderer's options to fit to the specified paper mode.
IronRenderer.RenderingOptions.FitToPaperMode = IronPdf.Engines.Chrome.FitToPaperModes.FixedPixelWidth;

// Render the HTML file as a PDF document.
var pdfFromHtmlFile = IronRenderer.RenderHtmlFileAsPdf(@"C:\HTML Website\website\index.html");

// Save the rendered PDF document to a file.
pdfFromHtmlFile.SaveAs(@"C:/IronPDF Test.pdf");

using IronPdf;

// Create an instance of ChromePdfRenderer
var IronRenderer = new ChromePdfRenderer();

// Set the renderer's options to fit to the specified paper mode.
IronRenderer.RenderingOptions.FitToPaperMode = IronPdf.Engines.Chrome.FitToPaperModes.FixedPixelWidth;

// Render the HTML file as a PDF document.
var pdfFromHtmlFile = IronRenderer.RenderHtmlFileAsPdf(@"C:\HTML Website\website\index.html");

// Save the rendered PDF document to a file.
pdfFromHtmlFile.SaveAs(@"C:/IronPDF Test.pdf");

Imports IronPdf

' Create an instance of ChromePdfRenderer
Private IronRenderer = New ChromePdfRenderer()

' Set the renderer's options to fit to the specified paper mode.
IronRenderer.RenderingOptions.FitToPaperMode = IronPdf.Engines.Chrome.FitToPaperModes.FixedPixelWidth

' Render the HTML file as a PDF document.
Dim pdfFromHtmlFile = IronRenderer.RenderHtmlFileAsPdf("C:\HTML Website\website\index.html")

' Save the rendered PDF document to a file.
pdfFromHtmlFile.SaveAs("C:/IronPDF Test.pdf")

Imports IronPdf

' Create an instance of ChromePdfRenderer
Private IronRenderer = New ChromePdfRenderer()

' Set the renderer's options to fit to the specified paper mode.
IronRenderer.RenderingOptions.FitToPaperMode = IronPdf.Engines.Chrome.FitToPaperModes.FixedPixelWidth

' Render the HTML file as a PDF document.
Dim pdfFromHtmlFile = IronRenderer.RenderHtmlFileAsPdf("C:\HTML Website\website\index.html")

' Save the rendered PDF document to a file.
pdfFromHtmlFile.SaveAs("C:/IronPDF Test.pdf")

O método RenderHtmlFileAsPdf é usado para gerar um PDF a partir do arquivo HTML. Esta função lê todo o conteúdo do arquivo HTML, carregando os arquivos CSS e JavaScript relacionados. A saída do método RenderHtmlFileAsPdf é exibida abaixo.

IronPDF HTML para PDF

O IronPDF gera PDFs a partir de HTML de forma muito elegante. Este resultado é diferente e melhor do que o PDF gerado pela Telerik.

URL para PDF

Você pode usar o seguinte código para gerar um PDF a partir de uma URL.

using IronPdf.Rendering;
using IronPdf;

// Create an instance of ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set the paper size for rendering the PDF.
renderer.RenderingOptions.PaperSize = PdfPaperSize.A2;

// Render the specified URL as a PDF document.
PdfDocument myPdf = renderer.RenderUrlAsPdf("https://dotnet.microsoft.com/en-us/");

// Save the rendered PDF document to a file.
myPdf.SaveAs(@"C:/dotnet.pdf");

using IronPdf.Rendering;
using IronPdf;

// Create an instance of ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Set the paper size for rendering the PDF.
renderer.RenderingOptions.PaperSize = PdfPaperSize.A2;

// Render the specified URL as a PDF document.
PdfDocument myPdf = renderer.RenderUrlAsPdf("https://dotnet.microsoft.com/en-us/");

// Save the rendered PDF document to a file.
myPdf.SaveAs(@"C:/dotnet.pdf");

Imports IronPdf.Rendering
Imports IronPdf

' Create an instance of ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

' Set the paper size for rendering the PDF.
renderer.RenderingOptions.PaperSize = PdfPaperSize.A2

' Render the specified URL as a PDF document.
Dim myPdf As PdfDocument = renderer.RenderUrlAsPdf("https://dotnet.microsoft.com/en-us/")

' Save the rendered PDF document to a file.
myPdf.SaveAs("C:/dotnet.pdf")

Imports IronPdf.Rendering
Imports IronPdf

' Create an instance of ChromePdfRenderer
Private renderer As New ChromePdfRenderer()

' Set the paper size for rendering the PDF.
renderer.RenderingOptions.PaperSize = PdfPaperSize.A2

' Render the specified URL as a PDF document.
Dim myPdf As PdfDocument = renderer.RenderUrlAsPdf("https://dotnet.microsoft.com/en-us/")

' Save the rendered PDF document to a file.
myPdf.SaveAs("C:/dotnet.pdf")

A função RenderUrlAsPdf converte a URL de uma página da web em um PDF. O programa aguarda o carregamento de todos os arquivos relacionados antes de renderizar, produzindo resultados extraordinários. Preserva todas as cores, designs e interface do usuário. Você pode ver o resultado abaixo.

URL para PDF

Você pode encontrar mais tutoriais sobre o IronPDF e vê-los em ação na página de tutoriais do IronPDF .

Comparação

Como vimos na interface de usuário (UI) dos resultados em ASP.NET do IronPDF e do Telerik, podemos afirmar que o Telerik não é uma boa opção para conversões de HTML para PDF, pois sua qualidade de renderização não é boa. Você pode ver a diferença entre os resultados do IronPDF e do Telerik abaixo.

Comparação de resultados

Qualidade de renderização

Na imagem acima, você pode ver a clara diferença entre as saídas padrão do IronPDF e do Telerik. Vamos comparar os resultados com base nas características.

A qualidade de renderização da Telerik é ruim. Os PDFs gerados apresentam formatação deficiente, não preservando os estilos originais do documento. Por outro lado, o IronPDF possui uma qualidade de renderização excepcional, preservando todos os aspectos do documento original.

Suporte a CSS e JavaScript

O Telerik PdfProcessing foi projetado principalmente para a geração de PDFs baseada em código e não oferece suporte nativo a arquivos CSS ou JavaScript externos para conversão em HTML. Seu foco está na criação programática de documentos, em vez da renderização de HTML.

Por outro lado, o IronPDF oferece suporte completo para declarações CSS e JavaScript internas e externas. O processamento de JavaScript pode ser ativado ou desativado conforme necessário no IronPDF.

Limitações do processamento de documentos Telerik

Em resumo, seguem algumas limitações adicionais do Telerik PdfProcessing para fluxos de trabalho de HTML para PDF:

1. O Telerik PdfProcessing não oferece suporte nativo a arquivos CSS ou JavaScript externos para conversão em HTML.
2. Capacidades limitadas de renderização de HTML em comparação com geradores de PDF baseados em navegador.
3. Não possui funcionalidade integrada de conversão de URL para PDF.
4. Projetado para a criação programática de PDFs, em vez da conversão de documentos HTML.
5. A qualidade da renderização HTML pode não corresponder à aparência do documento de origem.

Funcionalidades do IronPDF

As principais características do IronPDF são:

• O IronPDF suporta a conversão de URLs para PDF e de arquivos HTML para PDF.
• O IronPDF suporta arquivos externos como imagens, CSS e JS. O IronPDF carrega automaticamente todos os arquivos sem usar nenhuma biblioteca externa.
• O IronPDF possui documentação extensa.
• O IronPDF preserva a interface do usuário e oferece uma qualidade de renderização perfeita.

Existem muitas outras funcionalidades do IronPDF. Você pode visitar a Página de Recursos do IronPDF para obter as melhores informações.

Funcionalidades do IronPDF

Conclusão

Neste artigo, comparamos o IronPDF com as bibliotecas de processamento de documentos PDF da Telerik e descobrimos que o IronPDF é muito superior à biblioteca da Telerik para conversão de HTML para PDF.

IronPDF é uma excelente biblioteca para todas as operações relacionadas a PDFs. Você pode criar, editar e modificar arquivos PDF em todas as versões mais recentes dos frameworks .NET e .NET Core . Visite a Página de Licenciamento do IronPDF para mais informações sobre a distribuição e o licenciamento dos pacotes de produtos IronPDF.