Criar arquivo PDF programaticamente em C#

Antes de prosseguirmos, devemos instalar a biblioteca IronPdf em nosso projeto. Podemos fazer isso de várias maneiras.

Método 1: Gerenciador de Pacotes NuGet

Podemos instalar a biblioteca C# IronPdf 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 . Isso abrirá o Explorador de Soluções do Gerenciador de Pacotes NuGet .

Abra o Gerenciador de Pacotes NuGet

Clique em "Procurar" e digite IronPDF na barra de pesquisa. O seguinte resultado será exibido. Selecione IronPDF e clique no botão Instalar; A instalação na biblioteca começará em breve.

Procure e instale o pacote IronPDF.

Método 2: Console do Gerenciador de Pacotes NuGet

Podemos usar o Console do Gerenciador de Pacotes NuGet para instalar nossa biblioteca rapidamente. Não requer privilégios administrativos para a instalação. Você pode usar um comando NuGet para instalar a biblioteca IronPdf em seu projeto.

Install-Package IronPdf

Instale o pacote IronPDF via linha de comando.

Método 3: Utilizando um arquivo DLL

A terceira maneira de usar o IronPDF em seu projeto é adicionar um arquivo DLL da biblioteca IronPDF . Você pode baixar o arquivo DLL .

• Baixe o arquivo zip da DLL. Extraia-o para uma pasta específica.
• Abra um projeto no Visual Studio. No Explorador de Soluções, clique com o botão direito do mouse em Referências e procure o arquivo DLL do IronPDF .

Consulte um guia de instalação mais detalhado sobre como instalar o IronPDF .

Analisaremos vários métodos para criar PDFs usando o IronPDF. Veremos como é fácil usar funções simples para criar arquivos PDF. Vamos começar a criar PDFs usando uma string HTML.

4.1. Criar PDFs programaticamente usando strings HTML

Na biblioteca IronPDF , o HTML é usado para fins de estilização. É necessário ter conhecimento básico da linguagem HTML para gerar documentos PDF usando a biblioteca IronPDF .

A biblioteca IronPDF facilita muito o processamento de strings HTML e sua conversão para o formato PDF. Vamos ver como fazer isso usando código.

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// HTML content to be converted into a PDF
string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// HTML content to be converted into a PDF
string htmlString = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' HTML content to be converted into a PDF
Dim htmlString As String = "<h1> Generated PDF File!</h1> <p> This file is generated by IronPDF library from HTML String!</p> <p>It is a great Library to manipulate PDF Files.</p>"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlString).SaveAs("PDF from HTML String.pdf")

Este código irá gerar um arquivo PDF contendo o conteúdo armazenado na variável htmlString. Neste exemplo de código, foi utilizada a função RenderHtmlAsPdf . Esta função realiza a conversão de uma string HTML em um documento PDF.

Você precisa estar familiarizado com tags HTML para gerar arquivos PDF usando a biblioteca IronPDF . A função SaveAs é usada para salvar o arquivo PDF de saída. Você pode ver o arquivo PDF de saída abaixo.

Saída:

Saída em formato PDF

4.2. Criar PDFs programaticamente usando arquivos HTML

A biblioteca IronPDF oferece um recurso fantástico para criar um arquivo PDF a partir de um arquivo HTML. O IronPDF converte diretamente tudo em um arquivo HTML, incluindo imagens, CSS, formulários, etc., em um documento PDF. Não requer nenhuma outra biblioteca ou função para processamento posterior. O IronPDF converte diretamente qualquer arquivo HTML em um arquivo PDF.

Vejamos um exemplo de código para criar um arquivo PDF a partir de um arquivo HTML:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert an HTML file to a PDF and save it
var pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert an HTML file to a PDF and save it
Dim pdf = renderer.RenderHtmlFileAsPdf("IronFile.html").SaveAs("IronPDF file.pdf")

Usamos a função RenderHtmlFileAsPdf para criar PDFs a partir de arquivos HTML. Você pode fornecer o local do arquivo HTML no parâmetro da função ou colocar o arquivo HTML na pasta bin do código-fonte, então você só precisará colocar o nome do arquivo com a extensão no parâmetro da função RenderHtmlFileAsPdf. O arquivo PDF resultante será salvo na pasta bin ao executar este código. A função SaveAs ajuda a salvar arquivos PDF criados.

4.3. Criar PDFs programaticamente usando URLs

Às vezes, precisamos criar arquivos PDF a partir de uma URL programaticamente em nosso programa. Essa pode ser uma tarefa muito técnica se codificarmos tudo do zero. O IronPDF nos ajuda nesse sentido, fornecendo uma excelente função para criar PDFs a partir de URLs. Você pode usar qualquer URL para criar um PDF.

Vamos examinar como fazer isso:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
var renderer = new ChromePdfRenderer();

// Convert a URL to a PDF and save it
var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer = New ChromePdfRenderer()

' Convert a URL to a PDF and save it
Dim pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/blog/using-ironpdf/csharp-generate-pdf-tutorial/").SaveAs("IronPDF Generate PDF.pdf")

O código acima criará um PDF do parâmetro de URL fornecido para a função RenderUrlAsPdf . Esta função cria um PDF da URL. Caso contrário, essa seria uma tarefa muito complexa se você tentasse fazê-la do zero, então o IronPDF oferece aos desenvolvedores um processo simples para converter qualquer URL em PDF. A função SaveAs é usada para salvar arquivos de saída na pasta bin. Para definir o formato do arquivo como PDF, você deve especificar uma extensão .pdf com um parâmetro de nome de arquivo na função SaveAs. Você pode ver a pasta bin na pasta do seu projeto. O resultado é apresentado abaixo.

Saída:

Criar arquivo PDF a partir de URL

4.4. Criar PDFs programaticamente usando ASP.NET Web Forms

ASP.NET é uma estrutura de programação do lado do servidor que estende a funcionalidade do HTML e oferece suporte ao desenvolvimento web em um navegador. As páginas ASP.NET são escritas em HTML, CSS e JavaScript, e podem ser codificadas como arquivos ASPX (.aspx). Os formulários web ASP.NET criam sites, bancos online, intranets e sistemas de contabilidade fáceis de usar e ricos em funcionalidades.

Usaremos a biblioteca IronPDF para converter formulários web ASP.NET em PDF. Inicialmente renderizado como uma página da web, transformaremos isso em um PDF para visualização e download em um navegador da web. Usaremos a classe AspxToPdf do IronPDF para concluir a conversão.

Vejamos como fazer isso:

1. Crie um projeto de formulário web ASP.NET no Visual Studio. Recomenda-se a versão mais recente do Visual Studio.
2. Instale a biblioteca IronPDF usando o Gerenciador de Pacotes NuGet ou o arquivo DLL, conforme sua preferência. Você também pode usar o Console do Gerenciador de Pacotes NuGet para instalá-la.
3. Agora, abra o código de qualquer página web ASPX que você queira converter em um arquivo PDF. Aqui, criaremos um PDF da página Default.aspx do projeto.

Estrutura do projeto Web Form no Visual Studio

4. Abra o arquivo Default.aspx.cs. Adicione o namespace IronPdf ao arquivo, que é a linha mais importante.

using IronPdf;

using IronPdf;

Imports IronPdf

5. Escreva a seguinte linha de código na função Page_Load para criar um documento PDF da página.

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);

AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser)

E é isso! Foi criado um arquivo PDF da página web ASPX. Ao executar o projeto, você verá um PDF da página da web no navegador. O resultado é o mesmo que quando você cria um PDF pressionando Ctrl+P. Aqui, você não precisou pressionar Ctrl+P para criar um PDF do arquivo ASPX.

Isso foi feito no lado do servidor. Neste código, usamos a classe AspxToPdf do IronPDF. A função RenderThisPageAsPdf cria o PDF da página web ASPX.

O código acima exibe o arquivo PDF no navegador. Podemos baixar o arquivo PDF diretamente para o nosso sistema adicionando a seguinte linha de código na função Page_Load:

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment);

AspxToPdf.RenderThisPageAsPdf(IronPdf.AspxToPdf.FileBehavior.Attachment)

Este código fará o download do arquivo PDF da página web ASPX no sistema. Também podemos definir o nome do arquivo ASPX PDF. Existem diversas opções disponíveis para modificações e formatação, como cabeçalhos, rodapés, opções de impressão, qualidade, etc. Para mais detalhes, consulte este tutorial completo sobre como converter ASPX para PDF .

Saída:

Resultado da renderização de um arquivo PDF a partir do servidor.

Explore a mais recente tecnologia da Microsoft para aplicações Blazor na criação de arquivos PDF.

4.5. Criar PDFs programaticamente com formatação

Ao criar PDFs, a maioria dos problemas surge durante a formatação dos documentos. Formatar PDFs programaticamente não é fácil. Mas agora temos uma solução na forma do IronPDF. O IronPDF oferece diversas opções de formatação que nos permitem personalizar o arquivo PDF que estamos criando. Ele nos fornece métodos para adicionar cabeçalhos, rodapés, margens e muitas outras opções de formatação.

O uso do IronPDF permite definir a orientação da página, o tamanho da página e os títulos. Também permite alterar o tamanho da fonte, a cor da fonte, o tipo de fonte e realizar outras operações relacionadas à fonte. Você pode adicionar rodapés e cabeçalhos com uma linha divisória e texto personalizado. Vamos ver como personalizar arquivos PDF usando o IronPDF.

• Crie um projeto de console em C#. Você também pode criar um projeto com interface gráfica (GUI), dependendo das suas necessidades. Você também pode abrir projetos já existentes. Instale a biblioteca IronPDF usando o Gerenciador de Pacotes NuGet ou o arquivo DLL.
• Adicione o namespace IronPDF no início do arquivo de código.

A configuração do aplicativo já foi concluída. Em seguida, adicione o seguinte código ao arquivo PDF:

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.Title = "PDF Generated";
renderer.RenderingOptions.Zoom = 100;

// Margin Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

// Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "Header!";
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

// Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
renderer.RenderingOptions.TextFooter.FontSize = 10;
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

using IronPdf;

IronPdf.License.LicenseKey = "YourLicenseKey";

// Create a PDF renderer
ChromePdfRenderer renderer = new IronPdf.ChromePdfRenderer();

// Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40);
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.Title = "PDF Generated";
renderer.RenderingOptions.Zoom = 100;

// Margin Settings
renderer.RenderingOptions.MarginTop = 40;  
renderer.RenderingOptions.MarginLeft = 20;  
renderer.RenderingOptions.MarginRight = 20;  
renderer.RenderingOptions.MarginBottom = 40;  

renderer.RenderingOptions.FirstPageNumber = 1; 

// Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = true;
renderer.RenderingOptions.TextHeader.CenterText = "Header!";
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica;

// Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = true;
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial;
renderer.RenderingOptions.TextFooter.FontSize = 10;
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}";
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"; 

// HTML content to be converted into a PDF
string htmlStr = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>";

// Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf");

Imports IronPdf

IronPdf.License.LicenseKey = "YourLicenseKey"

' Create a PDF renderer
Dim renderer As ChromePdfRenderer = New IronPdf.ChromePdfRenderer()

' Configure rendering options
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait
renderer.RenderingOptions.SetCustomPaperSizeInInches(14, 40)
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.Title = "PDF Generated"
renderer.RenderingOptions.Zoom = 100

' Margin Settings
renderer.RenderingOptions.MarginTop = 40
renderer.RenderingOptions.MarginLeft = 20
renderer.RenderingOptions.MarginRight = 20
renderer.RenderingOptions.MarginBottom = 40

renderer.RenderingOptions.FirstPageNumber = 1

' Header Settings
renderer.RenderingOptions.TextHeader.DrawDividerLine = True
renderer.RenderingOptions.TextHeader.CenterText = "Header!"
renderer.RenderingOptions.TextHeader.Font = IronSoftware.Drawing.FontTypes.Helvetica

' Footer Settings
renderer.RenderingOptions.TextFooter.DrawDividerLine = True
renderer.RenderingOptions.TextFooter.Font = IronSoftware.Drawing.FontTypes.Arial
renderer.RenderingOptions.TextFooter.FontSize = 10
renderer.RenderingOptions.TextFooter.LeftText = "{date} {time}"
renderer.RenderingOptions.TextFooter.RightText = "{page} of {total-pages}"

' HTML content to be converted into a PDF
Dim htmlStr As String = "<h1>PDF Formatting!</h1><h3>Functions and properties for formatting </h3> <p>IronPDF is the best ever library for PDF operations and formatting. </p>"

' Convert the HTML string to a PDF and save it
renderer.RenderHtmlAsPdf(htmlStr).SaveAs("PDF-Formatted.pdf")

Este trecho de código formata os arquivos PDF. RenderingOptions é a principal ferramenta para definir diferentes propriedades durante a criação de documentos PDF.

• renderer.RenderingOptions.TextHeader
  • Esta linha de código é usada para configurar o cabeçalho do arquivo PDF. Você pode acessar mais propriedades do cabeçalho com esta linha de código.
• renderer.RenderingOptions.TextFooter
  • Esta linha de código configura as propriedades do rodapé, como texto, margens direita e esquerda, tamanho da fonte e muitas outras.
• renderer.RenderingOptions.PaperOrientation
  • Esta linha de código permite ao usuário definir a orientação da página (paisagem ou retrato) do arquivo PDF.
• renderer.RenderingOptions.Title
  • Podemos usar esta linha para definir o título do arquivo PDF.

Nas últimas linhas, usamos a função RenderHtmlAsPdf para criar um PDF a partir de uma string HTML, mas podemos usar um arquivo HTML para convertê-lo perfeitamente em PDF, preservando a formatação atual. Essa é uma funcionalidade muito útil do IronPDF que lhe dá total liberdade para personalizar tudo relacionado a documentos PDF.

Saída:

Saída em PDF com suporte para formatação