Criar PDF em C# - Um guia completo para usar o IronPDF

Introdução

Criar documentos PDF a partir de conteúdo HTML tornou-se um requisito essencial para várias aplicações, variando desde a geração de faturas até o arquivamento de conteúdo web. IronPDF é uma biblioteca .NET poderosa e versátil que simplifica o processo de conversão de HTML para PDF, tornando fácil para desenvolvedores criar documentos PDF de alta qualidade em C#. Neste artigo, exploraremos os recursos do IronPDF e forneceremos um guia passo a passo para usá-lo na criação de PDFs.

Como criar arquivos PDF em C# usando a biblioteca IronPDF

1. Crie um novo projeto no Visual Studio
2. Adicione a biblioteca IronPDF a partir do gerenciador de pacotes NuGet
3. Crie um arquivo PDF simples.
4. Modifique arquivos PDF.
5. Adicionando Cabeçalhos e Rodapés
6. Incluindo Folhas de Estilo e Scripts Externos
7. Incluindo Imagens e bitmaps.
8. Conversão de arquivos HTML para PDF.
9. Conversão de URL para PDF.

Introdução ao IronPDF

IronPDF é uma biblioteca .NET que permite aos desenvolvedores converter HTML em PDF com facilidade. Ele oferece suporte a uma ampla gama de recursos, incluindo CSS, JavaScript e até mesmo imagens incorporadas. Com o IronPDF , você pode criar PDFs que são exatamente iguais às suas páginas web em HTML, garantindo uma transição perfeita entre os formatos. Esta biblioteca é particularmente útil para aplicações web que precisam gerar documentos PDF dinâmicos em tempo real.

O IronPDF permite que os desenvolvedores integrem perfeitamente a funcionalidade de PDF em aplicativos .NET sem a necessidade de gerenciar manualmente as estruturas de arquivos PDF. IronPDF aproveita o motor de renderização baseado no Chrome para converter páginas HTML (incluindo CSS, JavaScript e imagens complexos) em documentos PDF bem estruturados. Pode ser utilizado para gerar relatórios, faturas, livros eletrônicos ou qualquer tipo de documento que precise ser apresentado em formato PDF.

O IronPDF é versátil, oferecendo funcionalidades que não apenas renderizam PDFs, mas também fornecem uma ampla gama de opções de manipulação de PDFs, como edição, tratamento de formulários, criptografia e muito mais.

Principais Recursos do IronPDF C# para criar arquivos PDF

1. Conversão de HTML para PDF

   • Renderização HTML: IronPDF pode converter documentos HTML ou páginas da web (incluindo HTML com CSS, imagens e JavaScript) diretamente em um documento PDF com apenas algumas linhas, tornando-o ideal para gerar PDFs a partir de conteúdo web dinâmico.

   • Suporte para HTML/CSS Moderno: IronPDF lida com HTML5, CSS3 e JavaScript modernos, garantindo que seu conteúdo baseado na web seja renderizado com precisão como um PDF, preservando o layout, fontes e elementos interativos.

   • Renderização Avançada: Ele usa o motor de renderização do Chrome (via Chromium) para geração de PDFs precisa e de alta qualidade, tornando-o mais confiável do que muitas outras bibliotecas de HTML para PDF.

   • URL de Site para PDF: IronPDF pode receber uma string de URL do site como entrada e convertê-la em PDF.

2. Cabeçalhos e rodapés personalizados

   • IronPDF permite aos desenvolvedores adicionar cabeçalhos e rodapés personalizados a documentos PDF, que podem incluir conteúdo dinâmico, como números de página, título do documento ou texto personalizado.

   • Cabeçalhos e rodapés podem ser adicionados a páginas individuais ou como elementos consistentes em todo o documento.

3. Suporte for JavaScript em PDFs

   • IronPDF permite execução de JavaScript dentro do conteúdo HTML antes da geração do PDF. Isso permite a renderização de conteúdo dinâmico, como cálculos em formulários ou interatividade nos PDFs gerados.

4. Editar PDFs existentes

   • IronPDF fornece a capacidade de editar PDFs existentes. Você pode modificar textos, imagens e adicionar anotações a arquivos PDF existentes. Essa funcionalidade é útil para adicionar marcas d'água a documentos, inserir assinaturas ou atualizar o conteúdo de arquivos PDF.

   • Extração e modificação de texto permitem manipular o conteúdo de um documento PDF programaticamente.

5. Mesclar e dividir PDFs

   • IronPDF permite mesclar vários arquivos PDF em um único documento ou dividir um grande PDF em arquivos menores, ideal para fluxos de trabalho onde documentos precisam ser combinados ou divididos em partes mais gerenciáveis.

6. Suporte para formulários interativos

   • Você pode criar, preencher e manipular formulários PDF usando IronPDF. Oferece suporte completo para formulários interativos (como campos de texto, caixas de seleção e botões de opção) e permite preencher formulários previamente com dados.

7. Manipulação de Páginas

   • IronPDF oferece métodos para manipular páginas individuais dentro de um documento PDF, como girar páginas, excluir páginas ou reorganizá-las.

8. Segurança e Criptografia

   • IronPDF permite aplicar proteção por senha e criptografia a PDFs, garantindo que seus documentos estejam seguros. Você pode definir permissões de usuário para impedir a impressão, cópia ou edição do PDF.

9. Marca d'água e identidade visual

   • Adicionar marcas d'água a documentos PDF é fácil com IronPDF. Você pode sobrepor texto ou imagens como marcas d'água nas páginas, proporcionando proteção contra cópia ou distribuição não autorizada de seus documentos.

10. Extração de Texto e Imagem

    • IronPDF permite a extração de texto e imagens de documentos PDF, permitindo que os desenvolvedores extraiam dados para processamento ou reutilização.

11. Suporte a Unicode e a vários idiomas

    • IronPDF tem suporte robusto a Unicode, o que significa que pode lidar com caracteres internacionais e fontes, tornando-o ideal para gerar PDFs em vários idiomas.

12. Otimizado para desempenho

    • IronPDF está otimizado para desempenho, capaz de lidar com grandes documentos PDF e altos volumes de requisições. A biblioteca garante geração de PDF rápida e eficiente mesmo com grandes conjuntos de dados ou imagens.

13. API e ferramentas amigáveis ​​para desenvolvedores

    • IronPDF vem com uma API abrangente e fácil de usar. Os desenvolvedores podem começar rapidamente usando chamadas de método simples para executar tarefas complexas.

14. Suporte multiplataforma

    • IronPDF é compatível com várias plataformas, o que significa que pode ser usado em ambientes Windows e Linux, permitindo que você gere e manipule PDFs em diferentes sistemas operacionais.

Passo 1: Crie um novo projeto no Visual Studio

Agora vamos começar a criar um novo projeto, abra o Visual Studio e crie um novo projeto conforme abaixo.

Selecione criar aplicação de console.

Forneça o nome e a localização do projeto.

Selecione a versão do .NET

Crie um novo projeto.

Passo 2: Adicione a biblioteca IronPDF a partir do gerenciador de pacotes NuGet

Usando o Gerenciador de Pacotes NuGet na aplicação de console do Visual Studio, você pode usar o comando abaixo para adicionar a biblioteca IronPDF NuGet.

Além disso, o IronPDF pode ser instalado usando o Visual Studio Package Manager.

Passo 3: Crie um arquivo PDF simples.

Gere documentos PDF com facilidade usando a biblioteca IronPDF. Agora vamos começar com um arquivo PDF simples e em branco.

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a new PDF document with specific dimensions (270x270 points)
        PdfDocument pdf = new PdfDocument(270, 270);

        // Save the blank PDF document to disk
        pdf.SaveAs("simple.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Create a new PDF document with specific dimensions (270x270 points)
        PdfDocument pdf = new PdfDocument(270, 270);

        // Save the blank PDF document to disk
        pdf.SaveAs("simple.pdf");
    }
}

Passo 4: Modificar arquivos PDF

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Load the existing PDF document
        var pdf = new PdfDocument("simple.pdf");

        // Create a renderer for converting HTML to PDF
        var renderer = new ChromePdfRenderer();

        // Render HTML content as a PDF
        var pagePdf = renderer.RenderHtmlAsPdf("<h1>Awesome IronPDF Library</h1>");

        // Prepend the rendered page as the first page of the existing PDF
        pdf.PrependPdf(pagePdf);

        // Save the modified PDF with a new filename
        pdf.SaveAs("simple_WithTitle.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Load the existing PDF document
        var pdf = new PdfDocument("simple.pdf");

        // Create a renderer for converting HTML to PDF
        var renderer = new ChromePdfRenderer();

        // Render HTML content as a PDF
        var pagePdf = renderer.RenderHtmlAsPdf("<h1>Awesome IronPDF Library</h1>");

        // Prepend the rendered page as the first page of the existing PDF
        pdf.PrependPdf(pagePdf);

        // Save the modified PDF with a new filename
        pdf.SaveAs("simple_WithTitle.pdf");
    }
}

Passo 5: Adicionando Cabeçalhos e Rodapés

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

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

        // Define the HTML content
        string htmlContent = "<html><body><h1>IronPDF: An Awesome PDF Generation Library</h1><h2>Report</h2><p>This is a sample report.</p></body></html>";

        // Define headers and footers as HTML
        string headerHtml = "<div style='text-align: right;'>Page {page} of {total-pages}</div>";
        string footerHtml = "<div style='text-align: center;'>Confidential</div>";

        // Convert the HTML content to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Add headers and footers to the PDF document
        pdfDocument.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
        {
            HtmlHeader = new HtmlHeaderFooter() { HtmlFragment = headerHtml },
            HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = footerHtml }
        });

        // Save the PDF document with headers and footers
        pdfDocument.SaveAs("report.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

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

        // Define the HTML content
        string htmlContent = "<html><body><h1>IronPDF: An Awesome PDF Generation Library</h1><h2>Report</h2><p>This is a sample report.</p></body></html>";

        // Define headers and footers as HTML
        string headerHtml = "<div style='text-align: right;'>Page {page} of {total-pages}</div>";
        string footerHtml = "<div style='text-align: center;'>Confidential</div>";

        // Convert the HTML content to a PDF document
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Add headers and footers to the PDF document
        pdfDocument.AddHtmlHeadersAndFooters(new ChromePdfRenderOptions
        {
            HtmlHeader = new HtmlHeaderFooter() { HtmlFragment = headerHtml },
            HtmlFooter = new HtmlHeaderFooter() { HtmlFragment = footerHtml }
        });

        // Save the PDF document with headers and footers
        pdfDocument.SaveAs("report.pdf");
    }
}

Passo 6: Incluindo Folhas de Estilo e Scripts Externos

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Define the HTML content with links to external CSS and JS files
        string htmlContent = @"
        <html>
            <head>
                <link rel='stylesheet' type='text/css' href='styles.css'>
                <script src='script.js'></script>
            </head>
            <body>
                <h1>IronPDF: An Awesome PDF Generation Library</h1>
                <h2>Styled Content</h2>
                <p id='dynamic-text'>This content is styled using an external CSS file and JavaScript.</p>
            </body>
        </html>";

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

        // Render HTML content to a PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to disk
        pdfDocument.SaveAs("awesomeIronPDF_styled_content.pdf");
    }
}

using IronPdf;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

        // Define the HTML content with links to external CSS and JS files
        string htmlContent = @"
        <html>
            <head>
                <link rel='stylesheet' type='text/css' href='styles.css'>
                <script src='script.js'></script>
            </head>
            <body>
                <h1>IronPDF: An Awesome PDF Generation Library</h1>
                <h2>Styled Content</h2>
                <p id='dynamic-text'>This content is styled using an external CSS file and JavaScript.</p>
            </body>
        </html>";

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

        // Render HTML content to a PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to disk
        pdfDocument.SaveAs("awesomeIronPDF_styled_content.pdf");
    }
}

/* styles.css */
body {
    font-family: Arial, sans-serif;
    margin: 20px;
}
h1 {
    color: #007BFF;
}
p {
    font-size: 14px;
    line-height: 1.6;
}

// script.js
document.addEventListener('DOMContentLoaded', function() {
    var dynamicText = document.getElementById('dynamic-text');
    dynamicText.textContent = "This content has been modified by JavaScript.";
});

// script.js
document.addEventListener('DOMContentLoaded', function() {
    var dynamicText = document.getElementById('dynamic-text');
    dynamicText.textContent = "This content has been modified by JavaScript.";
});

Passo 7: Incluindo Imagens e bitmaps.

using IronPdf;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

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

        // Import image file as bytes
        byte[] base64Bytes = File.ReadAllBytes("image.jpg"); // Use your own image file here

        // Convert image bytes to Base64 string
        string imgDataUri = @"data:image/png;base64," + Convert.ToBase64String(base64Bytes);

        // Create HTML content with the embedded Base64 image
        string imgHtml = $"<img src='{imgDataUri}'>";

        // Render HTML content to a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(imgHtml);

        // Save the PDF with the embedded image
        pdf.SaveAs("embedded_sample.pdf");
    }
}

using IronPdf;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        // Set your IronPDF license key
        IronPdf.License.LicenseKey = "your key";

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

        // Import image file as bytes
        byte[] base64Bytes = File.ReadAllBytes("image.jpg"); // Use your own image file here

        // Convert image bytes to Base64 string
        string imgDataUri = @"data:image/png;base64," + Convert.ToBase64String(base64Bytes);

        // Create HTML content with the embedded Base64 image
        string imgHtml = $"<img src='{imgDataUri}'>";

        // Render HTML content to a PDF
        PdfDocument pdf = renderer.RenderHtmlAsPdf(imgHtml);

        // Save the PDF with the embedded image
        pdf.SaveAs("embedded_sample.pdf");
    }
}

Passo 8: Conversão de Arquivos HTML para PDF.

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from an existing HTML file using C#
        var pdf = renderer.RenderHtmlFileAsPdf("sample.html");

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

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from an existing HTML file using C#
        var pdf = renderer.RenderHtmlFileAsPdf("sample.html");

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

Passo 9: Conversão de URL para PDF.

O seguinte trecho de código demonstra o uso do IronPDF para converter URL em PDF.

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from a URL or local file path
        var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");

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

using IronPdf;

class Program
{
    static void Main()
    {
        // Instantiate Renderer
        var renderer = new ChromePdfRenderer();

        // Create a PDF from a URL or local file path
        var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");

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

Casos de Uso do IronPDF

IronPDF é uma biblioteca poderosa para trabalhar com PDFs em C#. Ela permite que desenvolvedores gerem, modifiquem e manipulem documentos PDF facilmente. Abaixo estão alguns casos de uso comuns de IronPDF em aplicações C#:

Informações de Licença (Teste disponível)

IronPDF oferece um teste gratuito. Coloque-o antes de usar a biblioteca desta forma:

IronPdf.License.LicenseKey = "your key";

IronPdf.License.LicenseKey = "your key";

Conclusão

IronPDF, a biblioteca PDF for .NET, torna a geração de PDF em C# simples e poderosa. Quer você esteja gerando faturas, relatórios ou outros tipos de documentos, IronPDF oferece recursos robustos como conversão de HTML para PDF, cabeçalhos e rodapés personalizados, edição de PDF, manipulação de formulários, e muito mais. Ele oferece uma maneira perfeita de trabalhar com PDFs.

Com o IronPDF, você pode criar PDFs de alta qualidade facilmente em C#, permitindo que você se concentre em oferecer uma ótima funcionalidade aos seus usuários em vez de se preocupar com as complexidades do formato de documentos. Quer você esteja trabalhando com conteúdo web dinâmico ou criando relatórios estáticos, IronPDF é uma solução confiável para suas necessidades de PDF.