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)

A biblioteca C# PDF

Explore IronPDF Comece seu teste gratuito

HTML para PDF

Online Demo Veja todos os exemplos de código %s

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

using IronPdf;

// Disable local disk access or cross-origin requests
Installation.EnableWebSecurity = true;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();

// Create a PDF from a HTML string using C#
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

// Export to a file or Stream
pdf.SaveAs("output.pdf");

// Advanced Example with HTML Assets
// Load external html assets: Images, CSS and JavaScript.
// An optional BasePath 'C:\site\assets\' is set as the file location to load assets from
var myAdvancedPdf = renderer.RenderHtmlAsPdf("<img src='icons/iron.png'>", @"C:\site\assets\");
myAdvancedPdf.SaveAs("html-with-assets.pdf");

PM >Install-Package IronPdf

Install-Package IronPdf

USANDO O IRONPDF

Como adicionar números de página em um PDF usando C#

Curtis Chau

Updated: 4 de setembro de 2026

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
1. Gerenciador de Pacotes NuGet
2. Console do Gerenciador de Pacotes NuGet
3. Utilizando o arquivo DLL
Criar um documento PDF usando aplicações web ASP.NET Core
1. Criar um documento PDF usando ASP.NET WebForms (ASPX)
2. 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

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 1: Aplicação Web 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.

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 2: .NET 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 .

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 3: Gerenciador de Pacotes NuGet Gerenciador de Pacotes NuGet

Ou clique com o botão direito do mouse no projeto no Solution Explorer e clique em Gerenciar Pacotes NuGet .

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 4: Gerenciador de Pacotes NuGet - Explorador de Soluções 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.

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 5: Gerenciador de Pacotes NuGet - Explorador de Soluções 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.

PM > Install-Package IronPdf

Install-Package IronPdf

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 6: Gerenciador de Pacotes NuGet - Explorador de Soluções 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 fonte da página web ASPX que você deseja converter em um documento PDF, neste caso, crie uma nova página Default.aspx.

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 7: Gerenciador de Pacotes NuGet - Explorador de Soluções 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

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)

' 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 .

The RenderThisPageAsPdf method is used within the AspxToPdf class to convert the ASPX page into a PDF file.

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 fazer o download do documento PDF diretamente no 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)

' 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:

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 8: Página ASPX para PDF 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 a marcação abaixo a qualquer página .cshtml de sua escolha (index.cshtml será usado aqui).

<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>

HTML

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

Public Sub OnPostGeneratePDF()
	' Placeholder method that will handle PDF generation.
End Sub

Em seguida, adicione uma nova página HTML à sua aplicação web.

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 9: Adicionar uma Nova Página 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".

Finalmente, 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 As 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

Public Sub OnPostGeneratePDF()
    ' Create a new instance of the ChromePdfRenderer class to handle PDF rendering.
    Dim renderer As 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:

Criando um Gerador de PDF em ASP.NET usando IronPDF, Figura 10: Página HTML ASP.NET para PDF 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 .

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

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 bem estruturados e visualmente atraentes.

...