Criando um gerador de PDF em ASP.NET Core usando IronPDF
Se você é um desenvolvedor .NET , provavelmente já se deparou com a tarefa de gerar arquivos PDF a partir de páginas da web em seus aplicativos web. Felizmente, no ASP.NET Core, esse processo é facilitado pela biblioteca IronPDF PDF. Isso permite criar um PDF com uma única linha de código. Vamos explorar exatamente como você pode usar o IronPDF para criar um arquivo PDF.
Tópicos abordados neste tutorial
Este tutorial abordará os seguintes tópicos:
- IronPDF
- Criar um aplicativo Web ASP.NET Core
- Instale a biblioteca IronPDF
- Gerenciador de Pacotes NuGet
- Console do Gerenciador de Pacotes NuGet
- Utilizando o arquivo DLL
- Criar um documento PDF usando aplicações web ASP.NET Core
- Criar um documento PDF usando ASP.NET WebForms (ASPX)
- Criar um documento PDF em ASP.NET Core a partir de um arquivo HTML
- Resumo
IronPDF
A biblioteca IronPDF .NET permite que os desenvolvedores criem documentos PDF facilmente em C#, F# e VB .NET for .NET Core e .NET Framework. A renderização do IronPDF é uma cópia perfeita, pixel por pixel, das versões para desktop do Google Chrome. Ele processa documentos PDF sem o Adobe Acrobat. O IronPDF pode ser usado para criar um arquivo PDF a partir de páginas da web ASP.NET , conteúdo HTML, URLs ou de dentro de aplicativos Model View Controller.
Algumas características importantes da biblioteca IronPDF .NET :
- Cria documentos PDF a partir de HTML , CSS e JavaScript
- Gera documentos PDF a partir de URLs ou páginas da web
- Carregar URLs com credenciais de login de rede personalizadas , agentes de usuário, proxies, cookies , cabeçalhos HTTP e variáveis de formulário (permitindo login por trás de formulários de login HTML)
- Leia e preencha os dados dos campos do formulário em PDF.
- Extrair imagens e textos de arquivos PDF
- Assinatura digital
Vamos começar aprendendo como usar a biblioteca IronPDF para criar um documento PDF.
Criar um aplicativo Web ASP.NET Core
Este tutorial pressupõe que você tenha a versão mais recente do Visual Studio instalada.
- Abra o Visual Studio
- Criar uma nova aplicação Web ASP.NET Core
Aplicativo Web
- Dê um nome ao projeto (Ex: Geração_PDF )
- A versão mais recente e estável do .NET Framework é a 6.0. Selecione esta versão do framework.
.NET Framework
Instale a biblioteca IronPDF.
Para criar um documento PDF, o primeiro passo é instalar a biblioteca IronPDF . Você pode instalá-lo usando qualquer um dos métodos abaixo.
1. Gerenciador de Pacotes NuGet
Para instalar a biblioteca IronPDF C# .NET Core a partir do Gerenciador de Pacotes NuGet :
- Abra o Gerenciador de Pacotes NuGet clicando em Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para a Solução .
Gerenciador de Pacotes NuGet
Ou clique com o botão direito do mouse no projeto no Solution Explorer e clique em Gerenciar Pacotes NuGet .
Gerenciador de Pacotes NuGet - Explorador de Soluções
- Pesquise por IronPDF. Selecione IronPDF e clique em Instalar. A instalação na biblioteca começará em breve.
Gerenciador de Pacotes NuGet - Explorador de Soluções
2. Console do Gerenciador de Pacotes NuGet
Abra o Gerenciador de Pacotes NuGet clicando em Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes . Digite o seguinte comando no terminal.
Install-Package IronPdf
Gerenciador de Pacotes NuGet - Explorador de Soluções
3. Utilizando um arquivo DLL
A terceira maneira de incluir o IronPDF em seu projeto é adicionar um arquivo DLL da biblioteca IronPDF . Você pode baixar o arquivo DLL diretamente desta página de download do pacote IronPDF .
- Baixe o arquivo zip da DLL e extraia-o para uma pasta específica.
- Abra o projeto no Visual Studio. No Explorador de Soluções , clique com o botão direito do mouse em Referências e navegue até o arquivo DLL do IronPDF .
Criar um documento PDF em aplicações web ASP.NET Core
O IronPDF está pronto e agora você pode criar PDFs em aplicações Web ASP.NET Web Forms (ASPX) e ASP.NET Core .
Existem várias maneiras de criar um documento PDF. Vejamos alguns deles abaixo, usando exemplos de código.
1. Criar um PDF usando ASP.NET WebForms (ASPX)
Esta seção demonstrará como gerar arquivos PDF a partir do ASP.NET WebForms, que suporta apenas a versão 4 do .NET Framework. Portanto, é necessário instalar o IronPDF, disponível na página oficial do NuGet para ASPX . Não está disponível no .NET Core porque o ASPX foi substituído pelo modelo MVC.
Abra o arquivo de origem da página web ASPX que você deseja converter em um documento PDF; neste caso, crie uma nova página Default.aspx.
Gerenciador de Pacotes NuGet - Explorador de Soluções
Abra o arquivo Default.aspx.cs e adicione o namespace IronPDF no topo dele.
using IronPdf;
using IronPdf;
Imports IronPdf
Em seguida, escreva a seguinte linha de código na função Page_Load():
// This code renders the current ASPX page as a PDF file and displays it in the browser.
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
// This code renders the current ASPX page as a PDF file and displays it in the browser.
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
' This code renders the current ASPX page as a PDF file and displays it in the browser.
AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser)
Com apenas uma linha de código, um novo documento PDF é criado a partir de uma página web ASP.NET .
O método RenderThisPageAsPdf é usado dentro da classe AspxToPdf para converter a página ASPX em um arquivo PDF.
Ao executar o projeto, um PDF da página da web será exibido no navegador. Isso é feito no lado do servidor.
O código acima apenas exibe o documento PDF no navegador. Também é possível baixar o documento PDF diretamente para o computador adicionando esta linha de código na função Page_Load():
// This code downloads the generated PDF file of the current ASPX page to the client.
AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);
// This code downloads the generated PDF file of the current ASPX page to the client.
AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);
' This code downloads the generated PDF file of the current ASPX page to the client.
AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment)
Este código fará o download do arquivo PDF da página web ASPX para o diretório do projeto .NET .
Saída:
Página ASPX para PDF
2. Criar um PDF usando ASP.NET Core a partir de um arquivo HTML
Esta seção demonstrará como gerar arquivos PDF no ASP.NET Core. O IronPDF consegue converter todo o conteúdo de um arquivo HTML, incluindo imagens, CSS, formulários, etc., diretamente para um documento PDF. Adicione um botão que, ao ser clicado, gere PDFs.
Adicione o código abaixo a qualquer página .cshtml de sua escolha (aqui será usado o código (index.cshtml).
<div>
<form method="post" asp-page="Index" asp-page-handler="GeneratePDF">
<input type="Submit" value="GeneratePDF"/>
</form>
</div>
<div>
<form method="post" asp-page="Index" asp-page-handler="GeneratePDF">
<input type="Submit" value="GeneratePDF"/>
</form>
</div>
No arquivo index.cshtml.cs, crie um método chamado OnPostGeneratePDF. Esta função será usada para renderizar o HTML como um PDF.
public void OnPostGeneratePDF()
{
// Placeholder method that will handle PDF generation.
}
public void OnPostGeneratePDF()
{
// Placeholder method that will handle PDF generation.
}
Public Sub OnPostGeneratePDF()
' Placeholder method that will handle PDF generation.
End Sub
Em seguida, adicione uma nova página HTML à sua aplicação web.
Adicionar uma nova página da Web
Adicione algum texto ao corpo desta página, por exemplo: "Gerando arquivos PDF a partir de páginas HTML".
Por fim, adicione o seguinte código no método de ação OnPostGeneratePDF.
public void OnPostGeneratePDF()
{
// Create a new instance of the ChromePdfRenderer class to handle PDF rendering.
var renderer = new ChromePdfRenderer();
// Render the HTML file as a PDF by specifying the path and save the resulting PDF file.
var pdf = renderer.RenderHtmlFileAsPdf("Pages/htmlpage.html");
// Save the generated PDF document with the specified name.
pdf.SaveAs("MyPdf.pdf");
}
public void OnPostGeneratePDF()
{
// Create a new instance of the ChromePdfRenderer class to handle PDF rendering.
var renderer = new ChromePdfRenderer();
// Render the HTML file as a PDF by specifying the path and save the resulting PDF file.
var pdf = renderer.RenderHtmlFileAsPdf("Pages/htmlpage.html");
// Save the generated PDF document with the specified name.
pdf.SaveAs("MyPdf.pdf");
}
Public Sub OnPostGeneratePDF()
' Create a new instance of the ChromePdfRenderer class to handle PDF rendering.
Dim renderer = New ChromePdfRenderer()
' Render the HTML file as a PDF by specifying the path and save the resulting PDF file.
Dim pdf = renderer.RenderHtmlFileAsPdf("Pages/htmlpage.html")
' Save the generated PDF document with the specified name.
pdf.SaveAs("MyPdf.pdf")
End Sub
Acima, a função RenderHtmlFileAsPdf é usada para criar PDFs a partir de arquivos HTML, especificando o caminho para o arquivo HTML que será convertido.
Execute o projeto e clique no botão "Gerar PDF". O arquivo PDF gerado aparecerá na pasta do projeto ASP.NET Core .
Saída:
Página HTML ASP.NET para PDF
Visite as páginas de tutoriais para aprender como converter visualizações MVC em PDFs no ASP.NET Core .
Resumo
IronPDF .NET Core é uma solução completa para trabalhar com documentos PDF. Oferece a possibilidade de converter documentos de diferentes formatos para um novo documento PDF. Basta algumas linhas de código para criar e formatar arquivos PDF programaticamente.
O principal destaque do IronPDF é o conversor de HTML, que renderiza documentos HTML usando uma instância de um navegador web real e compatível com os padrões nos bastidores. O HTML é renderizado com total precisão, em um formato vetorial adequado aos mais altos padrões de impressão comercial. O resultado é um PDF limpo e de alta qualidade.
O IronPDF é ideal para desenvolvedores e empresas que precisam manipular arquivos PDF em seus softwares. Informações sobre licenciamento comercial e preços estão disponíveis no site.
Você pode experimentar a versão gratuita da biblioteca IronPDF para testar suas funcionalidades. Uma chave de licença de avaliação gratuita permitirá que você teste todos os recursos do IronPDF.
Além disso, uma oferta especial permite que você adquira todos os cinco produtos da Iron Software pelo preço de apenas dois. Mais informações sobre licenciamento podem ser encontradas nesta página de informações sobre licenciamento da Iron Software .
Perguntas frequentes
Como posso gerar um documento PDF em ASP.NET Core sem perder a formatação?
Você pode usar o IronPDF para criar PDFs de alta qualidade e com precisão de pixels a partir de conteúdo HTML, CSS e JavaScript. O mecanismo de renderização do IronPDF, baseado no Google Chrome, garante que a formatação seja preservada.
Qual é a maneira mais fácil de criar um PDF a partir de HTML no ASP.NET Core?
O método mais simples para criar um PDF a partir de HTML no ASP.NET Core é usando o método RenderHtmlAsPdf do IronPDF, que converte strings HTML em documentos PDF com facilidade.
Posso usar uma biblioteca de PDF para converter páginas da web em PDFs no ASP.NET Core?
Sim, o IronPDF permite converter páginas da web em PDFs no ASP.NET Core, renderizando o conteúdo HTML da página da web como um documento PDF usando a classe ChromePdfRenderer .
Existe alguma maneira de instalar uma biblioteca PDF no ASP.NET Core sem usar o NuGet?
Sim, além de usar o Gerenciador de Pacotes NuGet, você pode adicionar diretamente o arquivo DLL do IronPDF ao seu projeto para instalar a biblioteca em sua aplicação ASP.NET Core.
Como posso garantir que meu aplicativo ASP.NET Core suporte a geração de PDFs a partir de URLs?
Com o IronPDF, você pode gerar PDFs a partir de URLs, utilizando sua capacidade de renderizar páginas da web como PDFs, facilitando a conversão de qualquer URL acessível em um documento PDF.
Quais são as vantagens de usar uma biblioteca PDF no ASP.NET Core?
Utilizar o IronPDF no ASP.NET Core oferece diversas vantagens, incluindo a capacidade de gerar PDFs a partir de vários tipos de conteúdo, extrair texto e imagens, realizar assinaturas digitais e manter a formatação por meio de um mecanismo de renderização confiável.
Como adiciono credenciais de rede ao gerar PDFs no ASP.NET Core?
O IronPDF permite adicionar credenciais de rede personalizadas durante a geração de PDFs, garantindo o acesso a recursos protegidos ao criar PDFs em aplicações ASP.NET Core.
Posso testar os recursos de geração de PDF de uma biblioteca sem precisar comprá-la?
Sim, você pode testar todos os recursos do IronPDF usando a versão de avaliação gratuita, que permite avaliar suas capacidades de geração de PDF antes de efetuar a compra.
É possível usar uma biblioteca PDF para ASP.NET WebForms juntamente com ASP.NET Core?
Sim, o IronPDF é compatível com versões anteriores do ASPX, permitindo que você o utilize para geração de PDFs tanto em aplicações ASP.NET WebForms quanto em aplicações ASP.NET Core.
O IronPDF é compatível com o .NET 10?
Sim. O IronPDF é totalmente compatível com o .NET 10, além do .NET 8 e .NET 9. Ele oferece suporte ao .NET 10 em todos os principais tipos de projeto — web, desktop, console e nuvem — e não requer soluções alternativas ou ajustes. O IronPDF permanece preparado para o futuro, acompanhando o lançamento de novas inovações do .NET. (Veja o suporte multiplataforma do IronPDF for .NET 10)


