Guia de Início Rápido do IronPDF
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
-
2Copie e execute este trecho de código.
IronPdf.ChromePdfRenderer .StaticRenderHtmlAsPdf("<p>Hello World</p>") .SaveAs("pixelperfect.pdf");C# -
3Implante para testar em seu ambiente de produção.
Comece a usar IronPDF em seu projeto hoje com uma avaliação gratuita
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
- 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";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;Imports IronPdfA 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");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");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");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.
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");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");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");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
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 é 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.
