Passo 1: Configurando seu projeto do Visual Studio para geração de PDFs em C

O primeiro passo é criar um projeto no Visual Studio. Para este tutorial, usaremos o modelo de aplicativo Windows Forms, mas o IronPDF funciona perfeitamente com aplicativos Web (ASP.NET), aplicativos de console, WPF e muito mais.

Abra o Visual Studio.

Clique em "Criar novo projeto".

Selecione "Aplicativo Windows Forms (.NET Framework ou .NET Core)" nos modelos e clique em "Avançar". A seguinte janela será exibida. Dê um nome ao seu projeto (ex: MyCSharpPdfGenerator).

>Como dar nome ao projeto

Em seguida, clique em 'Avançar'. No menu suspenso, escolha a .NET Framework desejada (o IronPDF suporta uma ampla variedade).

Selecionando o .NET Framework

Clique no botão 'Criar'. O projeto será criado e estará pronto para a próxima etapa.

Passo 2: Instalando a biblioteca IronPDF C# - Sua chave para a geração de PDFs

O IronPDF pode ser facilmente adicionado ao seu projeto usando o NuGet. Esta é a forma recomendada para garantir que você tenha a versão mais recente e todas as dependências necessárias.

Install-Package IronPdf

Etapa 3: Projetando uma interface simples de formulário do Windows (Opcional)

Neste tutorial, criaremos uma interface de usuário básica para acionar a geração de PDFs. Se você estiver criando um aplicativo web ou de console, integrará a lógica do IronPDF diretamente em seus controladores, serviços ou classes.

Acesse a Caixa de Ferramentas no Visual Studio (Exibir > Caixa de Ferramentas). Arraste e solte os seguintes controles na sua superfície de design do Form1:

• Um Label (por exemplo, para intitular seu aplicativo "Demonstração do Gerador de PDF em C#").
• Um RichTextBox (nomeie-o como PdfText) para entrada de HTML/texto.
• Um TextBox (nomeie-o como URL) para inserir um URL.

• Dois controles Button.

  • Defina o texto do primeiro botão como "Gerar PDF a partir do texto" (nomeie-o como GeneratePDFFromTextButton).
  • Defina o texto do segundo botão como "Gerar PDF a partir de URL" (nomeie-o como GeneratePDFFromURLButton).

Etapa 4: Escrevendo código C# para gerar PDFs a partir de texto/HTML

Agora, vamos adicionar a lógica em C#. Clique duas vezes no botão "Gerar PDF a partir do texto" (GeneratePDFFromTextButton) no editor de formulários. Isso criará um método de tratamento de eventos no seu arquivo Form1.cs.

Primeiro, adicione o namespace IronPDF no início do seu arquivo Form1.cs:

using IronPdf;

using IronPdf;

Imports IronPdf

Em seguida, implemente o manipulador de eventos click do botão. Este código irá pegar o texto (que pode ser texto simples ou HTML) do RichTextBox e convertê-lo em um documento PDF.

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

private void GeneratePDFFromTextButton_Click(object sender, EventArgs e)
{
    // It's recommended to set your license key once at application startup.
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
    // If no key is set, IronPDF will watermark PDFs after a trial period.

    // Use SaveFileDialog to let the user choose where to save the PDF
    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments); // Default to My Documents
    saveFileDialog1.Title = "Save PDF File As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1; // Start with PDF files selected
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;

        // The core of PDF generation from HTML/Text using IronPDF
        // IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
        var renderer = new ChromePdfRenderer();

        // The RenderHtmlAsPdf method converts an HTML string to a PDF document.
        // This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
        // from HTML templates.
        using (var pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text))
        {
            pdfDocument.SaveAs(filename);
        }

        MessageBox.Show("PDF Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
    }
}

Private Sub GeneratePDFFromTextButton_Click(ByVal sender As Object, ByVal e As EventArgs)
	' It's recommended to set your license key once at application startup.
	' IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 
	' If no key is set, IronPDF will watermark PDFs after a trial period.

	' Use SaveFileDialog to let the user choose where to save the PDF
	Dim saveFileDialog1 As New SaveFileDialog()
	saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) ' Default to My Documents
	saveFileDialog1.Title = "Save PDF File As"
	saveFileDialog1.DefaultExt = "pdf"
	saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*"
	saveFileDialog1.FilterIndex = 1 ' Start with PDF files selected
	saveFileDialog1.RestoreDirectory = True

	If saveFileDialog1.ShowDialog() = DialogResult.OK Then
		Dim filename As String = saveFileDialog1.FileName

		' The core of PDF generation from HTML/Text using IronPDF
		' IronPDF's ChromePdfRenderer accurately renders HTML, CSS, and JavaScript.
		Dim renderer = New ChromePdfRenderer()

		' The RenderHtmlAsPdf method converts an HTML string to a PDF document.
		' This is incredibly powerful for generating dynamic reports, invoices, tickets, etc.
		' from HTML templates.
		Using pdfDocument = renderer.RenderHtmlAsPdf(PdfText.Text)
			pdfDocument.SaveAs(filename)
		End Using

		MessageBox.Show("PDF Generated Successfully at: " & filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
	End If
End Sub

Explicação do código C# para geração de PDF:

• IronPdf.License.LicenseKey: É uma boa prática definir sua chave de licença do IronPDF . Se você tiver uma, remova o comentário da linha e substitua "YourLicenseKey..." pela sua chave real. O IronPDF funciona sem chave de licença, mas os documentos terão uma marca d'água após o período de avaliação.
• SaveFileDialog: Isso fornece uma caixa de diálogo padrão do Windows para o usuário escolher o local de salvamento e o nome do arquivo PDF.
• ChromePdfRenderer: Este é o núcleo da funcionalidade de conversão de HTML para PDF do IronPDF. Ele utiliza um mecanismo Chromium integrado para máxima fidelidade.
• RenderHtmlAsPdf(PdfText.Text): Esta chamada de método única pega o conteúdo da string do seu RichTextBox (que pode ser HTML rico) e o converte em um objeto de documento PDF.
• SaveAs(filename): Este método salva o documento PDF gerado no caminho especificado pelo usuário.
• O uso da declaração using para pdfDocument garante que os recursos sejam gerenciados corretamente.

Observe como o IronPDF simplifica uma tarefa potencialmente complexa, como a conversão de HTML para PDF, em apenas algumas linhas de código essenciais. Essa é uma vantagem significativa para desenvolvedores que precisam gerar PDFs em C# de forma rápida e confiável.

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

<h1>My First C# PDF Document</h1>
<p>This PDF was generated using <strong>IronPDF</strong> in a C# application.</p>
<p>IronPDF makes it very easy to convert HTML content, including styles and images, into professional PDF files.</p>
<ul>
    <li>Easy to use</li>
    <li>Accurate rendering</li>
    <li>Feature-rich</li>
</ul>

Etapa 5: Escrevendo código C# para gerar PDFs a partir de uma URL

Gerar um PDF a partir de uma página da web em tempo real é outro requisito comum. O IronPDF torna isso igualmente simples. Dê um duplo clique no botão "Gerar PDF a partir de URL" (GeneratePDFFromURLButton) no designer de formulários para criar o manipulador de eventos de clique.

Adicione o seguinte código C#:

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

private void GeneratePDFFromURLButton_Click(object sender, EventArgs e)
{
    // IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

    if (string.IsNullOrWhiteSpace(URL.Text))
    {
        MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning);
        return;
    }

    SaveFileDialog saveFileDialog1 = new SaveFileDialog();
    saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
    saveFileDialog1.Title = "Save PDF From URL As";
    saveFileDialog1.DefaultExt = "pdf";
    saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*";
    saveFileDialog1.FilterIndex = 1;
    saveFileDialog1.RestoreDirectory = true;

    if (saveFileDialog1.ShowDialog() == DialogResult.OK)
    {
        string filename = saveFileDialog1.FileName;
        try
        {
            var renderer = new ChromePdfRenderer();
            // RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
            // This is excellent for archiving web pages or creating PDFs from online reports.
            using (var pdfDocument = renderer.RenderUrlAsPdf(URL.Text))
            {
                pdfDocument.SaveAs(filename);
            }
            MessageBox.Show("PDF from URL Generated Successfully at: " + filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information);
        }
        catch (Exception ex)
        {
            MessageBox.Show("Error generating PDF from URL: " + ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error);
        }
    }
}

Private Sub GeneratePDFFromURLButton_Click(ByVal sender As Object, ByVal e As EventArgs)
	' IronPdf.License.LicenseKey = "YourLicenseKey-GetYourKeyFromIronPdf.com"; 

	If String.IsNullOrWhiteSpace(URL.Text) Then
		MessageBox.Show("Please enter a valid URL.", "Input Error", MessageBoxButtons.OK, MessageBoxIcon.Warning)
		Return
	End If

	Dim saveFileDialog1 As New SaveFileDialog()
	saveFileDialog1.InitialDirectory = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments)
	saveFileDialog1.Title = "Save PDF From URL As"
	saveFileDialog1.DefaultExt = "pdf"
	saveFileDialog1.Filter = "PDF files (*.pdf)|*.pdf|All files (*.*)|*.*"
	saveFileDialog1.FilterIndex = 1
	saveFileDialog1.RestoreDirectory = True

	If saveFileDialog1.ShowDialog() = DialogResult.OK Then
		Dim filename As String = saveFileDialog1.FileName
		Try
			Dim renderer = New ChromePdfRenderer()
			' RenderUrlAsPdf fetches the content from the URL and converts it to PDF.
			' This is excellent for archiving web pages or creating PDFs from online reports.
			Using pdfDocument = renderer.RenderUrlAsPdf(URL.Text)
				pdfDocument.SaveAs(filename)
			End Using
			MessageBox.Show("PDF from URL Generated Successfully at: " & filename, "Success", MessageBoxButtons.OK, MessageBoxIcon.Information)
		Catch ex As Exception
			MessageBox.Show("Error generating PDF from URL: " & ex.Message, "Error", MessageBoxButtons.OK, MessageBoxIcon.Error)
		End Try
	End If
End Sub

Explicação:

• URL.Text: Isso obtém a string da URL do controle TextBox no seu formulário.
• RenderUrlAsPdf(URL.Text): Este poderoso método do IronPDF navega até a URL fornecida, renderiza seu conteúdo (incluindo HTML, CSS, JavaScript e imagens) e o converte em um documento PDF.
• O tratamento de erros (try-catch) está incluído para maior robustez, visto que podem ocorrer problemas de rede ou URLs inválidos.

Conclusão: Simplifique a geração de PDFs em C# com o IronPDF

Como este tutorial demonstra, o IronPDF oferece uma solução notavelmente poderosa e, ao mesmo tempo, simples para todas as suas necessidades de geração de PDFs em C# . Seja para converter páginas HTML complexas com CSS e JavaScript sofisticados, gerar relatórios dinâmicos a partir de dados, criar PDFs a partir de URLs em tempo real ou necessitar de recursos robustos de edição de PDF em seus aplicativos .NET , o IronPDF oferece as ferramentas e o desempenho necessários para realizar o trabalho com eficiência.

Ao gerar projetos PDF em C# , você frequentemente se depara com escolhas entre bibliotecas gratuitas que podem ter limitações na fidelidade de renderização ou nos conjuntos de recursos, ou soluções mais complexas que exigem uma quantidade significativa de código repetitivo. O IronPDF se destaca como uma biblioteca .NET PDF abrangente e com suporte comercial, que simplifica o desenvolvimento, garante resultados de alta qualidade e oferece um conjunto robusto de recursos que vão além da criação básica de PDFs.

Pronto para experimentar a melhor maneira de gerar e manipular PDFs em C#?

Comece hoje mesmo seu teste GRATUITO do IronPDF

• Explore a documentação detalhada e mais exemplos.
• Ver opções de licenciamento Descubra o Iron Suite: Obtenha mais ferramentas .NET por menos (O Iron Suite inclui diversas bibliotecas .NET , oferecendo excelente custo-benefício se você trabalha com outros formatos de documento ou tarefas).

Ao escolher o IronPDF, você equipa seus projetos C# com um mecanismo líder de geração e manipulação de PDFs, economizando tempo valioso de desenvolvimento e garantindo documentos PDF de qualidade profissional e com perfeição de pixels sempre. Saiba mais sobre como converter HTML para PDF em C# com este guia detalhado .