O IronPDF permite que desenvolvedores C# convertam HTML em PDF em apenas 5 etapas usando um aplicativo Windows Forms simples, exigindo apenas a instalação do pacote NuGet e algumas linhas de código para renderizar o HTML como documentos PDF profissionais.
Os desenvolvedores de C# podem usar o IronPDF para gerar PDFs a partir de HTML. Este artigo demonstrará esse processo com um aplicativo Windows Forms em C# criado usando o .NET Framework.
Siga estes passos para criar um projeto no Visual Studio 2019.
Primeiro, abra o Visual Studio 2019 .
Clique em 'Criar um novo projeto'.
Agora, selecione 'Aplicativo do Windows Forms' no modelo e clique em 'Avançar'. A seguinte janela será exibida:
Insira o nome do projeto 'Criar PDF usando o IronPDF'.
Clique no botão 'Criar'. O projeto será criado conforme mostrado abaixo.
O Windows Forms oferece um ambiente visual simples para iniciantes que estão aprendendo a gerar PDFs em C# . Oferece um editor do tipo "arrastar e soltar" que facilita a criação de interfaces de usuário sem a necessidade de conhecimento aprofundado de HTML ou desenvolvimento web. O modelo de programação orientado a eventos do Windows Forms se alinha bem com a forma como os desenvolvedores iniciantes pensam sobre o fluxo de aplicativos, tornando-o ideal para demonstrar os principais recursos de conversão de HTML para PDF do IronPDF .
Para aplicações de produção, você pode considerar o ASP.NET Core para geração de PDFs baseada na web ou aplicações de console para processamento em lote . No entanto, o Windows Forms continua sendo uma excelente opção para ferramentas internas, utilitários de desktop e ambientes de aprendizagem onde é necessário um feedback visual rápido durante o desenvolvimento.
O Visual Studio 2019 ou posterior oferece a melhor experiência para o desenvolvimento em IronPDF . Estas versões incluem gestão aprimorada de pacotes NuGet, melhor suporte IntelliSense para recursos modernos do C# e capacidades de depuração melhoradas que ajudam ao solucionar problemas de geração de PDF.
Embora o Visual Studio 2022 ofereça os recursos mais recentes e melhorias de desempenho, o Visual Studio 2019 continua sendo amplamente utilizado e totalmente suportado. Ambas as versões funcionam perfeitamente com os pacotes NuGet do IronPDF . Para desenvolvedores que usam o Visual Studio Code, ainda é possível trabalhar com o IronPDF, embora seja necessário usar a interface de linha de comando para o gerenciamento de pacotes e, consequentemente, alguns recursos de design visual mostrados neste tutorial não estarão disponíveis.
Absolutamente! O IronPDF oferece suporte completo ao .NET Core, .NET 5, .NET 6 e .NET 7+ . Na verdade, usar o .NET Core ou versões mais recentes oferece diversas vantagens, incluindo compatibilidade entre plataformas, melhor desempenho e acesso aos recursos mais recentes da linguagem C#.
Para usar o .NET Core, basta selecionar a estrutura de destino apropriada ao criar seu projeto. Os exemplos de código neste tutorial funcionam da mesma forma em todas as estruturas suportadas. Para maior flexibilidade de implantação, os aplicativos .NET Core podem ser executados em Linux e macOS, além do Windows, tornando-os ideais para implantações em nuvem e ambientes conteinerizados.
Primeiro, clique no botão 'Ferramentas' na barra de menu.
Você verá uma nova tela sob a linha de comando. Nela, escreva o comando para instalar o pacote IronPDF.
Pressione Enter após digitar o comando. Certifique-se de que seu computador/laptop esteja conectado à internet. O pacote IronPDF será adicionado automaticamente ao seu projeto existente.
A tela acima mostra o pacote adicionado com sucesso ao seu projeto.
Além do Gerenciador de Pacotes, você tem várias opções para instalar o IronPDF :
Interface do Gerenciador de Pacotes NuGet : Clique com o botão direito do mouse no seu projeto, selecione "Gerenciar Pacotes NuGet ", procure por "IronPDF" e clique em Instalar. Ótimo para iniciantes que preferem interfaces gráficas.
PackageReference no .csproj: Para projetos modernos .NET, você pode adicionar o IronPDF diretamente ao arquivo do seu projeto:
<PackageReference Include="IronPdf" Version="*" />O NuGet precisa de uma conexão com a internet para baixar o IronPDF e suas dependências do repositório NuGet. O pacote inclui a biblioteca principal do IronPDF e os binários do mecanismo de renderização do Chrome necessários para a conversão de HTML para PDF.
Para instalações offline, você pode:
Note que o mecanismo de renderização do IronPDF requer componentes de tempo de execução adicionais que podem ser baixados no primeiro uso, portanto, a geração inicial do PDF também se beneficia da conectividade com a internet.
Após a instalação, verifique se o IronPDF está funcionando corretamente, consultando estes indicadores:
Nó de Referências : No Explorador de Soluções, expanda o nó de Referências. Você deve ver "IronPDF" listado entre suas referências de projeto.
Suporte IntelliSense: Digite using IronPdf; no topo de um arquivo C#. IntelliSense deve reconhecer o namespace sem erros.
Código de teste simples : Adicione este teste básico para verificar a funcionalidade:
using IronPdf;
// Quick verification test
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf("<h1>Test</h1>");
// If no exceptions occur, IronPDF is installed correctlyImports IronPdf
' Quick verification test
Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf("<h1>Test</h1>")
' If no exceptions occur, IronPDF is installed correctlyGet-Package IronPdf no Console do Gerenciador de Pacotes para ver informações de versão.Se você encontrar problemas, consulte o guia de solução de problemas ou verifique se o seu sistema atende aos requisitos .
Agora, adicione um rótulo e defina o texto como "Criar um PDF a partir de HTML usando o IronPDF".
Em seguida, adicione uma caixa de texto formatado e um botão da caixa de ferramentas. Defina o texto do botão como 'Converter'.
RichTextBox em vez de um TextBox comum?Um RichTextBox oferece várias vantagens para entrada de HTML em cenários de geração de PDF:
Suporte para múltiplas linhas: HTML normalmente abrange várias linhas, e RichTextBox lida com isso de forma natural enquanto TextBox requer a configuração Multiline = true.
Preservação de formatação: Enquanto estamos inserindo HTML simples, RichTextBox preserva a formatação como recuo e quebras de linha, tornando o HTML mais legível durante o desenvolvimento.
Maior capacidade: RichTextBox pode lidar com maiores volumes de texto, útil ao trabalhar com documentos HTML completos em vez de trechos.
Potencial de realce de sintaxe: Embora não implementado neste exemplo básico, RichTextBox pode ser estendido para fornecer realce de sintaxe para HTML, melhorando a experiência do desenvolvedor.
Para aplicações de produção, considere usar um editor HTML dedicado ou integrar-se a editores externos para uma melhor experiência do usuário.
Para criar um aplicativo de geração de PDF mais robusto, considere adicionar estes controles:
Controle WebBrowser: Exiba uma prévia do HTML antes da conversão, ajudando os usuários a ver como ficará seu PDF. Isso imita o motor de renderização Chrome do IronPDF.
ProgressBar: Mostre o progresso da conversão para documentos grandes ou operações em lote.
ComboBox para Modelos: Proporcione modelos HTML predefinidos para tipos comuns de documentos como faturas ou relatórios.
PropertyGrid: Permita que usuários modifiquem configurações de renderização PDF como tamanho de página, margens e orientação.
TabControl: Separe HTML de entrada, prévia e configurações de PDF em guias organizadas.
Exemplo de como adicionar uma barra de status para feedback:
// Add to your form
StatusStrip statusStrip = new StatusStrip();
ToolStripStatusLabel statusLabel = new ToolStripStatusLabel("Ready");
statusStrip.Items.Add(statusLabel);
this.Controls.Add(statusStrip);' Add to your form
Dim statusStrip As New StatusStrip()
Dim statusLabel As New ToolStripStatusLabel("Ready")
statusStrip.Items.Add(statusLabel)
Me.Controls.Add(statusStrip)Seguir convenções de nomenclatura consistentes melhora a legibilidade e a manutenção do código. Aqui estão as práticas recomendadas para o seu formulário de geração de PDF:
Use Prefixos Descritivos:
txtHtml para o HTML de entrada RichTextBoxbtnConvert para o botão ConverterlblTitle para o rótulo do títuloSeja Consistente: Escolha camelCase ou PascalCase e mantenha esse padrão em todo o seu projeto.
Avoid Default Names: Substitua richTextBox1 por nomes significativos como rtbHtmlInput.
Agrupar controles relacionados : Para formulários complexos, use prefixos que agrupem funcionalidades:
pdfPageSize, pdfOrientation para configurações específicas de PDFhtmlTemplate, htmlPreview para controles relacionados ao HTMLConsidere a Acessibilidade: Defina a propriedade Name para leitores de tela e AccessibleName para melhor usabilidade.
Uma boa nomenclatura torna seu código autoexplicativo e facilita a implementação de funcionalidades como a extração de dados de formulários .
Clique duas vezes no botão "Converter". Uma janela de código com um evento de clique no botão "Converter" será aberta.
Adicione código para importar a biblioteca IronPDF no topo do arquivo .cs.
Primeiro, adicione o seguinte código para usar os métodos da biblioteca IronPDF .
using IronPdf;Imports IronPdfAbaixo está o código inicial para o evento btnConvert_Click, que atualmente está vazio:
private void btnConvert_Click(object sender, EventArgs e)
{
}Private Sub btnConvert_Click(ByVal sender As Object, ByVal e As EventArgs)
End SubAgora escreva o seguinte código no evento de clique do botão:
private void btnConvert_Click(object sender, EventArgs e)
{
// Declare an HtmlToPdf object
var HtmlLine = new HtmlToPdf();
// Get HTML text from the user
string strHtml = txtHtml.Text;
// Create SaveFileDialog to choose the save path for the PDF file
SaveFileDialog saveFileDialog = new SaveFileDialog
{
InitialDirectory = @"D:\",
Title = "Save PDF",
CheckPathExists = true,
DefaultExt = "pdf",
Filter = "pdf files (*.pdf)|*.pdf",
FilterIndex = 2,
RestoreDirectory = true
};
// If the user presses Save
if (saveFileDialog.ShowDialog() == DialogResult.OK)
{
// Get the file path from the user
string filePath = saveFileDialog.FileName;
// Convert HTML to PDF and save at the specified path
using var PDF = HtmlLine.RenderHtmlAsPdf(strHtml);
PDF.SaveAs(filePath);
// Clear the TextBox and show a message confirming the successful creation
txtHtml.Text = "";
MessageBox.Show("File created successfully.");
}
}Private Sub btnConvert_Click(sender As Object, e As EventArgs) Handles btnConvert.Click
' Declare an HtmlToPdf object
Dim HtmlLine = New HtmlToPdf()
' Get HTML text from the user
Dim strHtml As String = txtHtml.Text
' Create SaveFileDialog to choose the save path for the PDF file
Dim saveFileDialog As New SaveFileDialog() With {
.InitialDirectory = "D:\",
.Title = "Save PDF",
.CheckPathExists = True,
.DefaultExt = "pdf",
.Filter = "pdf files (*.pdf)|*.pdf",
.FilterIndex = 2,
.RestoreDirectory = True
}
' If the user presses Save
If saveFileDialog.ShowDialog() = DialogResult.OK Then
' Get the file path from the user
Dim filePath As String = saveFileDialog.FileName
' Convert HTML to PDF and save at the specified path
Using PDF = HtmlLine.RenderHtmlAsPdf(strHtml)
PDF.SaveAs(filePath)
End Using
' Clear the TextBox and show a message confirming the successful creation
txtHtml.Text = ""
MessageBox.Show("File created successfully.")
End If
End SubExplicação:
HtmlToPdf é criado para utilizar as capacidades de conversão do IronPDF.SaveFileDialog é usado para solicitar ao usuário especificar onde o PDF resultante deve ser salvo.RenderHtmlAsPdf e salvo no caminho escolhido.
Após salvar, a caixa de texto é limpa e uma caixa de mensagem é exibida para confirmar a criação do PDF.Um tratamento robusto de erros é crucial para aplicações de geração de PDFs em produção . Aqui está uma versão aprimorada com tratamento de erros abrangente:
private void btnConvert_Click(object sender, EventArgs e)
{
try
{
// Validate input
if (string.IsNullOrWhiteSpace(txtHtml.Text))
{
MessageBox.Show("Please enter HTML content.", "Validation Error",
MessageBoxButtons.OK, MessageBoxIcon.Warning);
return;
}
var renderer = new ChromePdfRenderer();
string strHtml = txtHtml.Text;
SaveFileDialog saveFileDialog = new SaveFileDialog
{
InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments),
Title = "Save PDF",
CheckPathExists = true,
DefaultExt = "pdf",
Filter = "pdf files (*.pdf)|*.pdf",
FilterIndex = 1,
RestoreDirectory = true
};
if (saveFileDialog.ShowDialog() == DialogResult.OK)
{
try
{
// Show progress cursor
Cursor.Current = Cursors.WaitCursor;
using var pdf = renderer.RenderHtmlAsPdf(strHtml);
pdf.SaveAs(saveFileDialog.FileName);
txtHtml.Text = "";
MessageBox.Show("PDF created successfully!", "Success",
MessageBoxButtons.OK, MessageBoxIcon.Information);
}
catch (IronPdf.Exceptions.IronPdfProductException ex)
{
// Handle licensing issues
MessageBox.Show($"Licensing error: {ex.Message}", "License Error",
MessageBoxButtons.OK, MessageBoxIcon.Error);
}
finally
{
Cursor.Current = Cursors.Default;
}
}
}
catch (Exception ex)
{
MessageBox.Show($"An error occurred: {ex.Message}", "Error",
MessageBoxButtons.OK, MessageBoxIcon.Error);
// Log the full exception for debugging
System.Diagnostics.Debug.WriteLine(ex.ToString());
}
}Private Sub btnConvert_Click(sender As Object, e As EventArgs) Handles btnConvert.Click
Try
' Validate input
If String.IsNullOrWhiteSpace(txtHtml.Text) Then
MessageBox.Show("Please enter HTML content.", "Validation Error", MessageBoxButtons.OK, MessageBoxIcon.Warning)
Return
End If
Dim renderer As New ChromePdfRenderer()
Dim strHtml As String = txtHtml.Text
Dim saveFileDialog As New SaveFileDialog With {
.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments),
.Title = "Save PDF",
.CheckPathExists = True,
.DefaultExt = "pdf",
.Filter = "pdf files (*.pdf)|*.pdf",
.FilterIndex = 1,
.RestoreDirectory = True
}
If saveFileDialog.ShowDialog() = DialogResult.OK Then
Try
' Show progress cursor
Cursor.Current = Cursors.WaitCursor
Using pdf = renderer.RenderHtmlAsPdf(strHtml)
pdf.SaveAs(saveFileDialog.FileName)
End Using
txtHtml.Text = ""
MessageBox.Show("PDF created successfully!", "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
Catch ex As IronPdf.Exceptions.IronPdfProductException
' Handle licensing issues
MessageBox.Show($"Licensing error: {ex.Message}", "License Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
Finally
Cursor.Current = Cursors.Default
End Try
End If
Catch ex As Exception
MessageBox.Show($"An error occurred: {ex.Message}", "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
' Log the full exception for debugging
System.Diagnostics.Debug.WriteLine(ex.ToString())
End Try
End SubPrincipais melhorias no tratamento de erros:
O IronPDF oferece ampla personalização através da classe ChromePdfRenderOptions . Veja como implementar personalizações comuns:
private void ConvertWithCustomSettings()
{
var renderer = new ChromePdfRenderer();
// Configure rendering options
renderer.RenderingOptions = new ChromePdfRenderOptions
{
// Page setup
PaperSize = PdfPaperSize.A4,
PaperOrientation = PdfPaperOrientation.Portrait,
MarginTop = 25, // millimeters
MarginBottom = 25,
MarginLeft = 20,
MarginRight = 20,
// Rendering behavior
EnableJavaScript = true,
RenderDelay = 500, // milliseconds
CreatePdfFormsFromHtml = true,
// Headers and footers
TextHeader = new TextHeaderFooter
{
CenterText = "My Document",
FontSize = 12,
DrawDividerLine = true
},
TextFooter = new TextHeaderFooter
{
RightText = "Page {page} of {total-pages}",
FontSize = 10
}
};
// Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print;
// Generate PDF with custom settings
var pdf = renderer.RenderHtmlAsPdf(txtHtml.Text);
pdf.SaveAs("custom-output.pdf");
}Private Sub ConvertWithCustomSettings()
Dim renderer As New ChromePdfRenderer()
' Configure rendering options
renderer.RenderingOptions = New ChromePdfRenderOptions With {
' Page setup
.PaperSize = PdfPaperSize.A4,
.PaperOrientation = PdfPaperOrientation.Portrait,
.MarginTop = 25, ' millimeters
.MarginBottom = 25,
.MarginLeft = 20,
.MarginRight = 20,
' Rendering behavior
.EnableJavaScript = True,
.RenderDelay = 500, ' milliseconds
.CreatePdfFormsFromHtml = True,
' Headers and footers
.TextHeader = New TextHeaderFooter With {
.CenterText = "My Document",
.FontSize = 12,
.DrawDividerLine = True
},
.TextFooter = New TextHeaderFooter With {
.RightText = "Page {page} of {total-pages}",
.FontSize = 10
}
}
' Apply custom CSS for print
renderer.RenderingOptions.CssMediaType = PdfCssMediaType.Print
' Generate PDF with custom settings
Dim pdf = renderer.RenderHtmlAsPdf(txtHtml.Text)
pdf.SaveAs("custom-output.pdf")
End SubPara opções de personalização mais avançadas, explore tamanhos de papel personalizados , margens personalizadas e configurações de viewport .
using para gerar PDFs?A declaração using é essencial para gerenciamento adequado de recursos na geração de PDF:
Descarte automático : documentos PDF podem consumir uma quantidade significativa de memória, especialmente com imagens ou conteúdo extenso. A declaração using garante que o objeto PDF seja devidamente descartado após o uso.
Liberação do identificador de arquivo : Sem o descarte adequado, os identificadores de arquivo podem permanecer bloqueados, impedindo operações subsequentes no arquivo PDF.
Gerenciamento de memória : O mecanismo de renderização do IronPDF usa recursos nativos que precisam ser liberados para evitar vazamentos de memória em aplicativos de longa duração.
Aqui está a comparação de padrões:
// Recommended approach with using
using (var pdf = renderer.RenderHtmlAsPdf(html))
{
pdf.SaveAs("output.pdf");
} // Resources automatically released here
// Alternative with try-finally (more verbose)
PdfDocument pdf = null;
try
{
pdf = renderer.RenderHtmlAsPdf(html);
pdf.SaveAs("output.pdf");
}
finally
{
pdf?.Dispose();
}' Recommended approach with Using
Using pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
End Using ' Resources automatically released here
' Alternative with Try-Finally (more verbose)
Dim pdf As PdfDocument = Nothing
Try
pdf = renderer.RenderHtmlAsPdf(html)
pdf.SaveAs("output.pdf")
Finally
If pdf IsNot Nothing Then
pdf.Dispose()
End If
End TryPara operações assíncronas, use await using no C# 8.0+:
await using var pdf = await renderer.RenderHtmlAsPdfAsync(html);Await Using pdf = Await renderer.RenderHtmlAsPdfAsync(html)O mecanismo de renderização do IronPDF para Chrome suporta todas as tags HTML5 modernas, mas algumas funcionam particularmente bem para a geração de PDFs:
Estrutura do documento:
<html>
<head>
<meta charset="UTF-8">
<style>
@media print { /* PDF-specific styles */ }
body { font-family: Arial, sans-serif; }
.page-break { page-break-after: always; }
</style>
</head>
<body>
<h1>Document Title</h1>
<div class="page-break"></div>
<h2>New Page Content</h2>
</body>
</html>Etiquetas com melhor desempenho para PDFs:
<h1> para <h6>: Cria uma hierarquia de documentos clara<table>: Excelente para dados estruturados e faturas<img>: Suporta imagens incorporadas e dados base64<div> com CSS: Controle preciso de layout<p> e <span>: Formatação de texto padrão<ul> e <ol>: Formatação de lista limpaConsiderações especiais:
Ao executar o projeto, você verá a seguinte tela:
Insira o código HTML no RichTextBox, por exemplo:
<h1>A Simple PDF File</h1><br><h6>Heading 6</h6>Clique em 'Converter'. Uma caixa de diálogo para salvar o arquivo será exibida.
Ao clicar no botão Salvar, o arquivo será salvo no caminho especificado, com o nome e a localização definidos.
Comece com estes exemplos de HTML progressivamente mais complexos para entender os recursos de renderização do IronPDF :
Formatação básica de texto:
<!DOCTYPE html>
<html>
<head>
<style>
body { font-family: Arial, sans-serif; margin: 40px; }
.highlight { background-color: yellow; }
.important { color: red; font-weight: bold; }
</style>
</head>
<body>
<h1>Test Document</h1>
<p>This is <strong>bold</strong> and <em>italic</em> text.</p>
<p class="highlight">Highlighted text example.</p>
<p class="important">Important notice!</p>
</body>
</html>Mesa com decoração:
<table style="border-collapse: collapse; width: 100%;">
<tr style="background-color: #f2f2f2;">
<th style="border: 1px solid #ddd; padding: 8px;">Product</th>
<th style="border: 1px solid #ddd; padding: 8px;">Price</th>
</tr>
<tr>
<td style="border: 1px solid #ddd; padding: 8px;">IronPDF</td>
<td style="border: 1px solid #ddd; padding: 8px;">$999</td>
</tr>
</table>Funcionalidades avançadas:
<!-- Images -->
<img src="___PROTECTED_URL_118___" width="200" alt="Company Logo">
<!-- Page breaks -->
<div style="page-break-after: always;"></div>
<!-- Lists -->
<ul>
<li>First item</li>
<li>Second item</li>
</ul>Teste esses elementos para garantir que sua conversão de HTML para PDF funcione conforme o esperado.
Quando a geração de PDF falhar, siga esta abordagem sistemática de depuração:
IronPdf.Logging.Logger.EnableDebugging = true;
IronPdf.Logging.Logger.LogFilePath = "IronPdfLog.txt";
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All;IronPdf.Logging.Logger.EnableDebugging = True
IronPdf.Logging.Logger.LogFilePath = "IronPdfLog.txt"
IronPdf.Logging.Logger.LoggingMode = IronPdf.Logging.Logger.LoggingModes.All// Validate HTML before conversion
private bool IsValidHtml(string html)
{
try
{
var doc = new HtmlAgilityPack.HtmlDocument();
doc.LoadHtml(html);
return doc.ParseErrors.Count() == 0;
}
catch
{
return false;
}
}' Validate HTML before conversion
Private Function IsValidHtml(html As String) As Boolean
Try
Dim doc As New HtmlAgilityPack.HtmlDocument()
doc.LoadHtml(html)
Return doc.ParseErrors.Count() = 0
Catch
Return False
End Try
End FunctionDevTools:
Salve seu HTML em um arquivo e abra-o no Chrome.
Pressione F12 para verificar erros de JavaScript .// Start with the simplest possible HTML
var testHtml = "<h1>Test</h1>";
var pdf = new ChromePdfRenderer().RenderHtmlAsPdf(testHtml);
pdf.SaveAs("test.pdf");' Start with the simplest possible HTML
Dim testHtml = "<h1>Test</h1>"
Dim pdf = New ChromePdfRenderer().RenderHtmlAsPdf(testHtml)
pdf.SaveAs("test.pdf")Aqui estão os problemas mais frequentes que os desenvolvedores juniores encontram e suas soluções:
"IronPdf.Exceptions.IronPdfDeploymentException"
Solução: Certifique-se de que o Visual C++ Runtime esteja instalado.
Execute o Windows Update para obter os tempos de execução mais recentes.
Erros de "Acesso Negado"
Environment.SpecialFolder para caminhos segurosTamanhos de arquivo grandes
pdf.CompressImages(90); // 90% qualitypdf.CompressImages(90) ' 90% qualityDesempenho lento
Conteúdo Ausente
Para problemas persistentes, consulte o guia completo de resolução de problemas .
O documento PDF resultante terá a seguinte aparência:
Melhore a qualidade dos seus PDFs com estas técnicas profissionais:
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.ImageQuality = 95; // Higher quality for images
renderer.RenderingOptions.DPI = 300; // Print-quality resolutionrenderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.ImageQuality = 95 ' Higher quality for images
renderer.RenderingOptions.DPI = 300 ' Print-quality resolution<style>
@page {
size: A4;
margin: 2cm;
}
body {
font-family: 'Segoe UI', Tahoma, sans-serif;
line-height: 1.6;
color: #333;
}
h1 {
color: #2c3e50;
border-bottom: 2px solid #3498db;
padding-bottom: 10px;
}
</style>Diversos fatores podem causar diferenças de renderização entre a pré-visualização HTML e a saída em PDF:
@media print {
.no-print { display: none; }
body { font-size: 12pt; }
}@font-face {
font-family: 'MyFont';
src: url('data:font/woff2;base64,...') format('woff2');
}renderer.RenderingOptions.RenderDelay = 2000; // Wait 2 secondsrenderer.RenderingOptions.RenderDelay = 2000 ' Wait 2 secondsDiferenças entre navegadores : O IronPDF usa o Chromium, portanto, teste no Chrome para obter uma pré-visualização precisa. Saiba mais sobre o renderizador do Chrome .
Resolução e escala : O DPI do monitor difere do DPI de impressão. Use as configurações de viewport para uma renderização consistente.
Para uma renderização perfeita em pixels, siga o guia de melhores práticas de conversão de HTML para PDF .
O tutorial acima explica como criar um PDF a partir de HTML usando a biblioteca IronPDF .
Para obter mais informações, visite o site oficial do IronPDF . A biblioteca também oferece outras funcionalidades que suportam arquivos PDF totalmente personalizáveis , mesclagem e divisão de arquivos programaticamente , ou simplesmente a verificação de códigos de exemplo que demonstram vários recursos .
Você pode avaliá-lo usando a chave de teste de 30 dias . Atualmente, está disponível uma excelente oferta em que você pode adquirir cinco produtos da Iron Software pelo preço de apenas dois. Visite a página de Informações sobre Licenciamento do IronPDF para obter mais informações sobre licenciamento.
Após dominar a conversão básica de HTML para PDF, explore estes recursos avançados:
// Create interactive form fields
pdf.Form.Fields.Add(new PdfTextField("name", "Enter your name", 100, 100));' Create interactive form fields
pdf.Form.Fields.Add(New PdfTextField("name", "Enter your name", 100, 100))Assinaturas digitais : Adicione segurança e autenticidade aos documentos.
Comece com as funcionalidades mais relevantes para os requisitos do seu projeto.
A transição da fase de testes para a produção envolve várias etapas importantes:
Escolha a licença correta :
Aplique sua chave de licença :
// In application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
// Or via configuration
// appsettings.json (for .NET Core)
{
"IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY"
}' In application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
' Or via configuration
' appsettings.json (for .NET Core)
' {
' "IronPdf.License.LicenseKey": "YOUR-LICENSE-KEY"
' }Remover marcas d'água de avaliação : As versões licenciadas removem automaticamente as marcas d'água de avaliação de todos os PDFs gerados.
Considerações sobre desempenho :
Lista de verificação para implantação :
Para obter orientações detalhadas sobre licenciamento, consulte as perguntas frequentes sobre licenciamento .
Amplie seu conhecimento sobre IronPDF com estes recursos abrangentes:
Recursos comunitários :
Comece com exemplos mais próximos do seu caso de uso e explore gradualmente recursos mais avançados conforme necessário.
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.
