Como posso gerar um PDF a partir de um modelo HTML usando C#?

Você pode usar o IronPDF para gerar um PDF a partir de um modelo HTML em C#. Primeiro, crie uma string HTML com marcadores de posição de dados usando a classe StringBuilder . Em seguida, preencha o modelo com seus dados e use o método RenderHtmlAsPdf do IronPDF para converter o HTML em um documento PDF.

Quais métodos o IronPDF oferece para converter HTML em PDF?

O IronPDF oferece vários métodos para converter HTML em PDF, incluindo RenderHtmlAsPdf para strings HTML, RenderHtmlFileAsPdf para arquivos HTML locais e RenderUrlAsPdf para páginas da web por URL. Esses métodos permitem a criação flexível de PDFs a partir de diferentes fontes HTML.

Como instalo o IronPDF no meu projeto C#?

Para instalar o IronPDF em um projeto C#, você pode usar o Gerenciador de Pacotes NuGet no Visual Studio. Pesquise por 'IronPDF' e clique em instalar ou use o Console do Gerenciador de Pacotes com o comando Install-Package IronPDF .

O IronPDF consegue lidar com HTML5 e JavaScript complexos ao converter para PDF?

Sim, o IronPDF consegue lidar com HTML5 e JavaScript complexos, garantindo que a conversão de páginas web complexas em documentos PDF mantenha a formatação e a funcionalidade pretendidas.

Quais são alguns usos comuns para gerar PDFs a partir de modelos em C#?

Em C#, é comum usar a geração de PDFs a partir de modelos para criar faturas, relatórios e formulários. O IronPDF permite automatizar esses processos, convertendo modelos HTML dinâmicos preenchidos com dados em documentos PDF com aparência profissional.

O IronPDF é compatível com ASP.NET e Windows Forms?

Sim, o IronPDF é compatível com vários tipos de projetos do .NET Framework, incluindo ASP.NET e Windows Forms, o que o torna versátil para diferentes ambientes de desenvolvimento de aplicativos.

Como posso criar um novo projeto no Visual Studio para usar o IronPDF na geração de PDFs?

Para criar um novo projeto do Visual Studio para usar o IronPDF, abra o Visual Studio, selecione "Novo Projeto", escolha "Aplicativo de Console", especifique o nome e o local do projeto, selecione um framework .NET e clique em "Criar". Depois disso, instale o IronPDF via NuGet.

O IronPDF consegue gerar PDFs a partir de páginas web seguras com formulários de login?

Sim, o IronPDF pode gerar PDFs a partir de páginas da web que exigem autenticação por meio de formulários de login HTML, permitindo que você lide com conteúdo da web seguro e protegido de forma eficaz.

O IronPDF é totalmente compatível com o .NET 10 e o que essa compatibilidade implica?

Sim, o IronPDF é totalmente compatível com o .NET 10. Ele funciona imediatamente em projetos .NET 10 sem qualquer configuração adicional, suporta destinos de implantação modernos (Windows, Linux, contêineres) e aproveita as novas melhorias de desempenho do .NET 10, mantendo a mesma API e conjunto de recursos. (Fonte: Documentação do IronPDF sobre compatibilidade com o .NET 10)

How can I merge multiple PDF documents using IronPDF?

With IronPDF, you can merge multiple PDF documents by using its merging functionality, which allows you to combine multiple PDFs into a single document seamlessly.

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 gerar um PDF em ASP.NET usando C#

Curtis Chau

Updated: 23 de abril de 2026

Os documentos em PDF são comuns na cultura atual, sendo utilizados por diversas empresas para a criação de faturas e outros documentos. Ao selecionar uma biblioteca .NET para projetos, deve-se levar em consideração a facilidade de criação, leitura e gravação de arquivos PDF.

Como gerar PDFs a partir de um modelo em C#

Instale a biblioteca C# para gerar PDF a partir de um modelo.
Construir uma string HTML com a classe StringBuilder
Preencha o modelo HTML com os dados armazenados das listas.
Use o método RenderHtmlAsPdf para gerar um PDF a partir do modelo.
Salve o PDF gerado como um novo documento.

Funcionalidades do IronPDF

O IronPDF é um dos melhores conversores de HTML para PDF disponíveis no mercado. O IronPDF consegue lidar com praticamente qualquer operação que um navegador seja capaz de realizar. Ele pode criar arquivos PDF a partir de HTML5, JavaScript, CSS e imagens. A biblioteca .NET PDF facilita a criação/geração de arquivos PDF, a leitura de PDFs existentes e a edição de arquivos PDF. As possíveis modificações incluem a alteração do tamanho da fonte, paginação, conteúdo do texto, etc. Os usuários do IronPDF podem criar campos de formulário em documentos PDF renderizados.

O IronPDF é compatível com todos os tipos de projetos do .NET Framework , incluindo ASP.NET, Windows Forms e outros tipos de aplicativos tradicionais do Windows. O IronPDF é capaz de renderizar componentes de visualização ASPX, Razor e outros componentes MVC diretamente em PDFs.

O conjunto completo de funcionalidades do IronPDF inclui:

Converter imagens em PDFs (e páginas de PDF em imagens)
Unir e dividir PDFs
Preencha formulários PDF programaticamente
Extrair texto e imagens de PDFs O IronPDF pode converter arquivos de imagem e arquivos HTML para PDF.
Crie PDFs a partir de páginas da web, marcação HTML e documentos HTML offline.
Gere PDFs a partir de páginas web protegidas por formulários de login HTML.
Anotar PDFs . Adicione cabeçalhos, rodapés , texto, imagens, marcadores, marcas d'água e muito mais.

Criando um novo projeto no Visual Studio

Este artigo demonstrará as capacidades de geração de documentos do IronPDF com um aplicativo de console simples.

Abra o software Visual Studio e acesse o menu Arquivo. Selecione "Novo projeto" e, em seguida, selecione "Aplicativo de console".

Como gerar PDF a partir de um modelo em C#, Figura 1: Novo Projeto Novo projeto

Especifique o nome do projeto e sua localização. Clique no botão Próximo e escolha uma .NET Framework.

Como gerar PDF a partir de um modelo em C#, Figura 2: Seleção do .NET Framework Seleção do .NET Framework

Por fim, clique em Criar para gerar o novo projeto do Visual Studio.

Como gerar PDF a partir de um modelo em C#, Figura 3: .NET Program.cs Programa .NET

3. Instale a biblioteca IronPDF.

A biblioteca IronPDF pode ser baixada e instalada de quatro maneiras.

Essas quatro maneiras são:

Utilize o Visual Studio.
Utilize a linha de comando do Visual Studio.
Faça o download diretamente do site do NuGet .
Faça o download diretamente do site da IronPDF .

3.1 Usando o Visual Studio

O Gerenciador de Pacotes NuGet está disponível no software Visual Studio para facilitar a instalação de pacotes do NuGet. A captura de tela abaixo mostra como abrir a interface gráfica do Gerenciador de Pacotes NuGet .

Como gerar PDF a partir de um modelo em C#, Figura 4: Gerenciador de Pacotes NuGet Gerenciador de Pacotes NuGet

Procure por "IronPDF" na aba Procurar da interface gráfica do Gerenciador de Pacotes.

Como gerar PDF a partir de um modelo em C#, Figura 5: Instalação do IronPDF Instalação do IronPDF

Escolha o pacote IronPdf (primeira opção) e clique no botão Instalar para adicioná-lo à Solução.

3.2 Usando a linha de comando do Visual Studio

No Visual Studio, acesse Ferramentas > Gerenciador de Pacotes NuGet > Console do Gerenciador de Pacotes.

Digite o seguinte comando na guia Console do Gerenciador de Pacotes e pressione ENTER.

PM > Install-Package IronPdf

Install-Package IronPdf

Como gerar PDF a partir de um modelo em C#, Figura 6: Instalar IronPDF Instale o IronPDF

3.3 Faça o download diretamente do site do NuGet

Acesse a página do pacote NuGet do IronPDF .
Clique em "Baixar pacote" no menu à direita.
Clique duas vezes no pacote baixado no Explorador de Arquivos do Windows para instalá-lo automaticamente em seu projeto.

3.4 Faça o download diretamente do site do IronPDF

Baixe o arquivo ZIP do IronPDF diretamente com a versão mais recente do pacote IronPDF .

Após o download, siga os passos abaixo para adicionar o pacote ao projeto.

Clique com o botão direito do mouse no projeto na janela do Explorador de Soluções. Em seguida, selecione a opção Referência e localize o arquivo de referência baixado. Em seguida, clique em OK para adicionar a referência.

4. Criar um documento PDF a partir de um modelo

O exemplo de código abaixo mostra como criar arquivos PDF a partir de um modelo HTML fornecido com apenas algumas linhas de código.

using System;
using System.Collections.Generic;
using System.Text;
using IronPdf;

class Program
{
    static void Main()
    {
        // Create an instance of ChromePdfRenderer
        var renderer = new IronPdf.ChromePdfRenderer();
        
        // Render the HTML as PDF and save it as Test.pdf
        renderer.RenderHtmlAsPdf(BuildTemplate()).SaveAs("Test.pdf");
    }

    /// <summary>
    /// Builds an HTML template string using StringBuilder
    /// </summary>
    /// <returns>HTML string representation of a table</returns>
    static string BuildTemplate()
    {
        var builder = new StringBuilder();
        builder.Append("<table border='1'>");
        builder.Append("<tr>");
        builder.Append("<th>");
        builder.Append("Cat Family");
        builder.Append("</th>");
        builder.Append("</tr>");
        
        // Iterate over the data and populate the table rows
        foreach (var item in GetData())
        {
            builder.Append("<tr>");
            builder.Append("<td>");
            builder.Append(item.ToString());
            builder.Append("</td>");
            builder.Append("</tr>");
        }
        
        builder.Append("</table>");
        return builder.ToString();
    }

    /// <summary>
    /// Provides a list of data representing different members of the cat family
    /// </summary>
    /// <returns>List of strings</returns>
    static List<string> GetData()
    {
        List<string> data = new List<string>
        {
            "Lion",
            "Tiger",
            "Cat",
            "Cheetah",
            "Lynx"
        };
        
        return data;
    }
}

using System;
using System.Collections.Generic;
using System.Text;
using IronPdf;

class Program
{
    static void Main()
    {
        // Create an instance of ChromePdfRenderer
        var renderer = new IronPdf.ChromePdfRenderer();
        
        // Render the HTML as PDF and save it as Test.pdf
        renderer.RenderHtmlAsPdf(BuildTemplate()).SaveAs("Test.pdf");
    }

    /// <summary>
    /// Builds an HTML template string using StringBuilder
    /// </summary>
    /// <returns>HTML string representation of a table</returns>
    static string BuildTemplate()
    {
        var builder = new StringBuilder();
        builder.Append("<table border='1'>");
        builder.Append("<tr>");
        builder.Append("<th>");
        builder.Append("Cat Family");
        builder.Append("</th>");
        builder.Append("</tr>");
        
        // Iterate over the data and populate the table rows
        foreach (var item in GetData())
        {
            builder.Append("<tr>");
            builder.Append("<td>");
            builder.Append(item.ToString());
            builder.Append("</td>");
            builder.Append("</tr>");
        }
        
        builder.Append("</table>");
        return builder.ToString();
    }

    /// <summary>
    /// Provides a list of data representing different members of the cat family
    /// </summary>
    /// <returns>List of strings</returns>
    static List<string> GetData()
    {
        List<string> data = new List<string>
        {
            "Lion",
            "Tiger",
            "Cat",
            "Cheetah",
            "Lynx"
        };
        
        return data;
    }
}

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports IronPdf

Module Program
    Sub Main()
        ' Create an instance of ChromePdfRenderer
        Dim renderer = New IronPdf.ChromePdfRenderer()

        ' Render the HTML as PDF and save it as Test.pdf
        renderer.RenderHtmlAsPdf(BuildTemplate()).SaveAs("Test.pdf")
    End Sub

    ''' <summary>
    ''' Builds an HTML template string using StringBuilder
    ''' </summary>
    ''' <returns>HTML string representation of a table</returns>
    Private Function BuildTemplate() As String
        Dim builder = New StringBuilder()
        builder.Append("<table border='1'>")
        builder.Append("<tr>")
        builder.Append("<th>")
        builder.Append("Cat Family")
        builder.Append("</th>")
        builder.Append("</tr>")

        ' Iterate over the data and populate the table rows
        For Each item In GetData()
            builder.Append("<tr>")
            builder.Append("<td>")
            builder.Append(item.ToString())
            builder.Append("</td>")
            builder.Append("</tr>")
        Next

        builder.Append("</table>")
        Return builder.ToString()
    End Function

    ''' <summary>
    ''' Provides a list of data representing different members of the cat family
    ''' </summary>
    ''' <returns>List of strings</returns>
    Private Function GetData() As List(Of String)
        Dim data As New List(Of String) From {
            "Lion",
            "Tiger",
            "Cat",
            "Cheetah",
            "Lynx"
        }

        Return data
    End Function
End Module

Imports System
Imports System.Collections.Generic
Imports System.Text
Imports IronPdf

Module Program
    Sub Main()
        ' Create an instance of ChromePdfRenderer
        Dim renderer = New IronPdf.ChromePdfRenderer()

        ' Render the HTML as PDF and save it as Test.pdf
        renderer.RenderHtmlAsPdf(BuildTemplate()).SaveAs("Test.pdf")
    End Sub

    ''' <summary>
    ''' Builds an HTML template string using StringBuilder
    ''' </summary>
    ''' <returns>HTML string representation of a table</returns>
    Private Function BuildTemplate() As String
        Dim builder = New StringBuilder()
        builder.Append("<table border='1'>")
        builder.Append("<tr>")
        builder.Append("<th>")
        builder.Append("Cat Family")
        builder.Append("</th>")
        builder.Append("</tr>")

        ' Iterate over the data and populate the table rows
        For Each item In GetData()
            builder.Append("<tr>")
            builder.Append("<td>")
            builder.Append(item.ToString())
            builder.Append("</td>")
            builder.Append("</tr>")
        Next

        builder.Append("</table>")
        Return builder.ToString()
    End Function

    ''' <summary>
    ''' Provides a list of data representing different members of the cat family
    ''' </summary>
    ''' <returns>List of strings</returns>
    Private Function GetData() As List(Of String)
        Dim data As New List(Of String) From {
            "Lion",
            "Tiger",
            "Cat",
            "Cheetah",
            "Lynx"
        }

        Return data
    End Function
End Module

No código acima:

Primeiro, criamos uma instância da classe IronPDF ChromePdfRenderer para acessar os recursos de criação de PDFs.
Em seguida, chamamos RenderHtmlAsPdf passando a string HTML construída pelo método BuildTemplate. Este método converte o HTML em um PDF.
O método BuildTemplate usa um StringBuilder para construir uma tabela HTML preenchida com dados.
GetData retorna uma lista de strings representando a 'família de gatos', que preenche as linhas da tabela HTML.

Abaixo está um exemplo de arquivo PDF, gerado a partir do código acima com apenas algumas linhas usando o modelo fornecido.

Como gerar PDF a partir de um modelo em C#, Figura 7: Arquivo PDF Gerado Arquivo PDF gerado

Qualquer tipo de tag HTML pode ser usada para criar um modelo que auxilie o usuário a gerar formulários, recibos, etc., utilizando um modelo de exemplo, mas com dados diferentes.

It is possible to use the method RenderUrlAsPdf or RenderHtmlFileAsPdf to generate PDF files from different sources. O primeiro método aceita um URL para uma página da web, enquanto o segundo aceita uma string contendo a localização de um arquivo HTML no computador.

Leia este tutorial sobre como gerar PDFs a partir de HTML para obter mais informações.

Conclusão

Utilize o IronPDF em produção sem marca d'água com uma chave de avaliação gratuita . O IronPDF está disponível com licenciamento SaaS e de redistribuição OEM por um custo adicional. Para saber mais, consulte a página de licenciamento do IronPDF .

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.

...