Guia de Início Rápido do IronPDF

Q: Como configuro o IronPDF para conectar-se a um servidor IronPDFEngine remoto?

Para configurar o IronPDF para um servidor remoto, use Installation.ConnectTo IronPDFHost com o método IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer , especificando o endereço IP e a porta do servidor.

Q: Qual pacote devo usar para minimizar o tamanho do aplicativo ao usar o IronPDFEngine?

Você deve usar o pacote IronPdf.Slim do NuGet, pois ele inclui apenas os componentes necessários para executar o IronPDF com o IronPDFEngine, reduzindo assim o tamanho do aplicativo.

Curtis Chau

Updated: 17 de setembro de 2026

Instale o IronPDF e crie seu primeiro PDF em apenas cinco minutos. Com sua API simples, você pode converter HTML, DOCX, imagens e muito mais em PDFs com qualidade impecável.

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 .

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
Install-Package IronPdf
```

2Copie e execute este trecho de código.

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

IronPdf.ChromePdfRenderer
       .StaticRenderHtmlAsPdf("<p>Hello World</p>")
       .SaveAs("pixelperfect.pdf");

Dim Renderer = New IronPdf.ChromePdfRenderer()
Renderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("pixelperfect.pdf")

Dim Renderer = New IronPdf.ChromePdfRenderer()
Renderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("pixelperfect.pdf")

3Implante para testar em seu ambiente de produção.

Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita

Gerenciador de Pacotes NuGet

Download do arquivo DLL

Acesse a biblioteca NuGet do IronPDF:

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

PM > Install-Package 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.

Guias específicos para cada plataforma

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";

Imports IronPdf

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

Imports IronPdf

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

4. Crie seu primeiro PDF

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

using IronPdf;

using IronPdf;

Imports IronPdf

Imports IronPdf

Criar um PDF em branco

Converter string HTML em PDF

Converter DOCX para PDF

A maneira mais simples de criar um objeto PDF usa apenas a largura e a altura. Este PdfDocument construtor 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")

Imports IronPdf

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

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

using IronPdf;

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

using IronPdf;

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

Dim Renderer = New IronPdf.ChromePdfRenderer()
Renderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf")

Dim Renderer = New IronPdf.ChromePdfRenderer()
Renderer.StaticRenderHtmlAsPdf("<p>Hello World</p>").SaveAs("string-to-pdf.pdf")

Converta documentos Word para PDF com a classe DocxToPdfRenderer, você pode renderizar arquivos DOCX diretamente em PDFs personalizáveis para uma 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")

Imports IronPdf

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

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.

Adicionar cabeçalhos e rodapés

Redigir texto

Mesclar PDFs

Crie cabeçalhos ou rodapés de texto instanciando TextHeaderFooter, adicionando seu texto 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")

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")

Redija texto com facilidade usando RedactTextOnAllPages para remover uma frase em 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")

Imports IronPdf

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

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

pdf.SaveAs("redacted.pdf")

Una dois arquivos PDF em C# com o método Merge. Use ReplaceTextOnAllPages em qualquer PdfDocument, novo ou importado, para trocar texto antigo por 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")

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")

Solução rápida de problemas

Emitir	Solução
Runtime do Visual C++ ausente	Instale o Visual C++ Redistributable - ambas as versões, x86 e x64, são necessárias para o mecanismo do Chrome.
Licença não reconhecida	Verifique com a propriedade `IronPdf.License.IsLicensed` . Certifique-se de que a licença esteja aplicada antes de qualquer operação com o IronPDF.
Renderização inicial lenta	Chame `IronPdf.Installation.Initialize()` na inicialização para pré-inicializar os mecanismos de renderização.
Dependências do Linux/Docker	Defina `Installation.LinuxAndDockerDependenciesAutoConfig = true` para instalação automática de dependências.

Próximos passos

Editar PDFsVeja as funcionalidades Organizar PDFsVeja as funcionalidades Assine e proteja PDFsVeja as funcionalidades

Perguntas frequentes

Como posso configurar o IronPDFEngine para geração remota de PDFs?

Para configurar o IronPDFEngine para geração remota de PDFs, instale o pacote IronPdf.Slim do NuGet e configure as definições de conexão usando a classe IronPDFConnectionConfiguration . Essa configuração permite que você conecte seu aplicativo à instância do IronPDFEngine remotamente.

Quais são os principais benefícios de usar o IronPDFEngine com minha aplicação?

Utilizar o IronPDFEngine com sua aplicação permite a execução remota de tarefas em PDF, ajudando a evitar problemas de compatibilidade específicos da plataforma, especialmente em sistemas mais antigos e plataformas móveis. Também elimina a necessidade do runtime do .NET durante a execução.

Por que eu optaria por usar o IronPDFEngine em vez da biblioteca PDF nativa?

Você pode optar pelo IronPDFEngine para executar remotamente funções de PDF que exigem alto desempenho, reduzindo problemas de compatibilidade com diferentes sistemas operacionais e melhorando o desempenho ao utilizar um renderizador idêntico ao do Chrome para conversão de HTML em PDF.

O IronPDFEngine suporta escalonamento horizontal?

Não, o IronPDFEngine atualmente não suporta escalonamento horizontal, o que significa que não pode ser balanceado em várias instâncias devido à forma como os binários de arquivos PDF são gerenciados na memória do servidor.

O IronPDFEngine pode ser executado em diferentes sistemas operacionais?

O IronPDFEngine foi projetado para ser executado em sistemas Linux usando contêineres Docker. No entanto, os binários são específicos da plataforma, portanto, você precisa garantir que está usando a versão correta para o seu sistema operacional.

O que devo fazer se meus PDFs gerados estiverem diferentes ao usar o IronPDFEngine?

Os resultados em PDF podem variar ligeiramente devido a diferentes comportamentos do sistema operacional. Para minimizar essas diferenças, certifique-se de estar usando a imagem Docker correta e verifique se há alguma configuração específica do sistema operacional que possa afetar a renderização.

Como posso garantir que meu aplicativo esteja usando a versão correta do IronPDFEngine?

Para garantir a compatibilidade, cada versão do IronPDF requer uma versão correspondente do IronPDFEngine. Certifique-se de atualizar ambos os componentes simultaneamente para evitar problemas de compatibilidade entre versões.

Quais são as limitações ao usar o IronPDFEngine no Windows?

Ao usar o IronPDFEngine no Windows, você precisa de contêineres Linux para Docker e deve garantir que a porta do servidor esteja acessível. Os binários são específicos da plataforma e a migração para contêineres Linux é necessária.

Como configuro o IronPDF para conectar-se a um servidor IronPDFEngine remoto?

Para configurar o IronPDF para um servidor remoto, use Installation.ConnectTo IronPDFHost com o método IronPdf.GrpcLayer.IronPDFConnectionConfiguration.RemoteServer , especificando o endereço IP e a porta do servidor.

Qual pacote devo usar para minimizar o tamanho do aplicativo ao usar o IronPDFEngine?

Você deve usar o pacote IronPdf.Slim do NuGet, pois ele inclui apenas os componentes necessários para executar o IronPDF com o IronPDFEngine, reduzindo assim o tamanho do aplicativo.

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.

...

Pronto para começar?

Nuget Downloads 21,253,952|Versão:2026.10recém-lançado

Download gratuito do NuGet

Total de downloads: 21,253,952

Ver licenças

Ver no GitHub

Instalar com NuGet

Versão: 2026.10

PM > Install-Package IronPdf

nuget.org/packages/IronPdf/

No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
Selecione Procurar e pesquise "IronPDF".
Selecione o pacote e instale.

Baixar DLL