Guia de Início Rápido do IronPDF

1. Pré-requisitos

• .NET Framework 4.6.2 ou superior OU .NET Core 3.1 ou superior OU .NET 5 ou superior
• Visual C++ Redistributable (para Windows).

2. Instale o IronPDF

A instalação padrão do IronPDF é executada localmente. Se você deseja implantar em Docker/microsserviços, consulte o Guia do Modo de Mecanismo Remoto .

Acesse a biblioteca NuGet do IronPDF:

1. No Explorador de Soluções, clique com o botão direito do mouse em Referências.
2. Selecione 'Gerenciar Pacotes NuGet' > 'Procurar' > Pesquisar IronPDF

Install-Package IronPdf

• Baixe o pacote DLL do IronPDF
• Descompacte o arquivo ZIP correspondente ao seu sistema operacional em um local dentro do diretório da sua solução.
• No Solução Explorer do Visual Studio, clique com o botão direito do mouse em 'Dependências'.
• 'Adicionar Referência de Projeto' > Selecione 'Procurar' para incluir todas as DLLs extraídas do arquivo zip.

**RELACIONADO:** Mais sobre configurações

Guias específicos para cada plataforma

Windows

Linux

MacOS

Docker

Azure

AWS

---

3. Aplicar chave de licença

Ao adquirir licenças do IronPDF ou optar por iniciar com um período de avaliação de 30 dias, uma chave de licença será enviada para o seu e-mail. Copie a chave e adicione-a no início do seu aplicativo.

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"

Veja o licenciamento do IronPDF

4. Crie seu primeiro PDF

O IronPDF ajuda você a criar PDFs ou converter HTML, DOCX, RTF, Markdown e imagens para PDF com total fidelidade. Explore mais tipos de conversões de PDF.

Adicione isso no início do seu arquivo .cs.

using IronPdf;

using IronPdf;

Imports IronPdf

A maneira mais simples de criar um objeto PDF utiliza apenas a largura e a altura. Este construtor PdfDocument cria um PDF em branco, pronto para personalização.

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");

using IronPdf;

PdfDocument pdf = new PdfDocument(270, 270);
pdf.SaveAs("blankPage.pdf");

Imports IronPdf

Dim pdf As New PdfDocument(270, 270)
pdf.SaveAs("blankPage.pdf")

Utilizando o método ChromePdfRenderer.RenderHtmlAsPdf , você pode transformar qualquer HTML (incluindo HTML5) em um PDF usando o mecanismo Chromium integrado.

using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");

using IronPdf;

IronPdf.ChromePdfRender
       .StaticRenderHtmlAsPdf("<p>Hello Word</p>")
       .SaveAs("string-to-pdf.pdf");

Imports IronPdf

IronPdf.ChromePdfRender.StaticRenderHtmlAsPdf("<p>Hello Word</p>").SaveAs("string-to-pdf.pdf")

**ARTIGO RELACIONADO COM TUTORIAIS:** Como converter uma string HTML em PDF usando C#

Converta documentos do Word para PDF com a classe DocxToPdfRenderer . Assim, você pode renderizar arquivos DOCX diretamente em PDFs personalizáveis ​​para integração perfeita em aplicativos .NET.

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");

using IronPdf;

DocxToPdfRenderer renderer = new DocxToPdfRenderer();
PdfDocument pdf = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx");
pdf.SaveAs("pdfFromDocx.pdf");

Imports IronPdf

Private renderer As New DocxToPdfRenderer()
Private pdf As PdfDocument = renderer.RenderDocxAsPdf("Modern-chronological-resume.docx")
pdf.SaveAs("pdfFromDocx.pdf")

**ARTIGO RELACIONADO COM TUTORIAIS:** Como converter Microsoft Word para PDF em C#

5. Exemplos mais avançados

Além da criação e conversão simples de PDFs, o IronPDF também oferece opções de personalização de PDF mais avançadas.

Crie cabeçalhos ou rodapés de texto instanciando um objeto TextHeaderFooter , adicionando o texto desejado e anexando-o ao PDF.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>");

// Create text header
TextHeaderFooter textHeader = new TextHeaderFooter
{
    CenterText = "This is the header!",
};

// Create text footer
TextHeaderFooter textFooter = new TextHeaderFooter
{
    CenterText = "This is the footer!",
};

// Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader);
pdf.AddTextFooters(textFooter);

pdf.SaveAs("addTextHeaderFooter.pdf");

Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World!</h1>")

' Create text header
Dim textHeader As New TextHeaderFooter With {
    .CenterText = "This is the header!"
}

' Create text footer
Dim textFooter As New TextHeaderFooter With {
    .CenterText = "This is the footer!"
}

' Add text header and footer to the PDF
pdf.AddTextHeaders(textHeader)
pdf.AddTextFooters(textFooter)

pdf.SaveAs("addTextHeaderFooter.pdf")

**ARTIGO RELACIONADO COM TUTORIAIS:** Como adicionar cabeçalhos e rodapés

Redija texto com facilidade usando RedactTextOnAllPages para remover uma frase de todo o documento.

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");

using IronPdf;

PdfDocument pdf = PdfDocument.FromFile("novel.pdf");

// Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric");

pdf.SaveAs("redacted.pdf");

Imports IronPdf

Private pdf As PdfDocument = PdfDocument.FromFile("novel.pdf")

' Redact 'Alaric' phrase from all pages
pdf.RedactTextOnAllPages("Alaric")

pdf.SaveAs("redacted.pdf")

**ARTIGO RELACIONADO COM TUTORIAIS:** Como converter URL em PDF

Mescle dois arquivos PDF em C# com o método Merge . Use ReplaceTextOnAllPages em qualquer PdfDocument , novo ou importado, para substituir o texto antigo pelo novo.

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>");

string oldText = ".NET6";
string newText = ".NET7";

// Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText);

pdf.SaveAs("replaceText.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>.NET6</h1>")

Private oldText As String = ".NET6"
Private newText As String = ".NET7"

' Replace text on all pages
pdf.ReplaceTextOnAllPages(oldText, newText)

pdf.SaveAs("replaceText.pdf")

**ARTIGO RELACIONADO COM TUTORIAIS:** Como mesclar ou dividir PDFs

Solução rápida de problemas

Próximos passos