1. IronPDF
  2. Tutoriais
  3. Criar novos PDFs

Como criar novos PDFs em C# com IronPDF

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

O IronPDF permite que desenvolvedores C# criem novos documentos PDF programaticamente usando o construtor PdfDocument para PDFs em branco, importando PDFs existentes de várias fontes ou convertendo HTML, imagens, RTF, Markdown e XML para o formato PDF. Para converter imagem em PDF ou criar PDF a partir de qualquer fonte de dados, o IronPDF oferece as ferramentas para geração de PDFs em aplicativos .NET .

Início Rápido: Crie seu primeiro PDF em C#

// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);

// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");

// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");
// 1. Install IronPDF from NuGet
// 2. Create a blank PDF
var pdf = new IronPdf.PdfDocument(270, 270);

// 3. Or convert HTML to PDF
var renderer = new IronPdf.ChromePdfRenderer();
var pdfFromHtml = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>");

// 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf");
' 1. Install IronPDF from NuGet
' 2. Create a blank PDF
Dim pdf As New IronPdf.PdfDocument(270, 270)

' 3. Or convert HTML to PDF
Dim renderer As New IronPdf.ChromePdfRenderer()
Dim pdfFromHtml As IronPdf.PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello PDF!</h1>")

' 4. Save your PDF
pdf.SaveAs("myNewPdf.pdf")
$vbLabelText   $csharpLabel

  1. Instale IronPDF com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronPdf

  2. Copie e execute este trecho de código.

    new IronPdf.PdfDocument { DefaultPageSize = new IronPdf.PageSize(270,270) }.SaveAs("blankPage.pdf");

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

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

    arrow pointer

Fluxo de trabalho mínimo (5 etapas)

  1. Baixe o IronPDF do NuGet para criar novos PDFs.
  2. Use o construtor **`PdfDocument`** para criar um PDF em branco.
  3. Importe um PDF existente a partir de um arquivo, URL, matriz de bytes ou JSON.
  4. Converta diversos formatos para PDF, como HTML, RTF, Markdown, imagens e XML.
  5. Exportar o documento PDF


Como faço para criar um exemplo de PDF em branco?

Existem várias maneiras de criar um objeto PDF. Comece com o método mais simples, que requer apenas a largura e a altura do PDF. Este construtor PdfDocument cria um novo PDF em branco, pronto para personalização e uso. As dimensões são especificadas em pontos (1/72 de polegada), permitindo um dimensionamento preciso para diversas aplicações, como etiquetas, cartões de visita ou formatos de documentos personalizados.

Para desenvolvedores que precisam de maior controle sobre as dimensões da página, o IronPDF oferece suporte a tamanhos de papel personalizados e vários formatos predefinidos, incluindo os tamanhos Carta, A4 e Ofício. Você pode definir diferentes orientações usando os recursos de orientação da página .

Quais parâmetros são necessários para um PDF em branco?

:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs.cs
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")
$vbLabelText   $csharpLabel

Depois de criar um PDF em branco, você pode aprimorá-lo adicionando cabeçalhos e rodapés , aplicando marcas d'água ou inserindo imagens .

Como posso importar um PDF de um arquivo?

Antes que um PDF possa ser modificado ou convertido, ele deve primeiro ser importado como um objeto PdfDocument. Use o método estático FromFile da classe PdfDocument para realizar isso. A importação de PDFs a partir de JSON, arrays de bytes, fluxos e URLs é suportada na mesma classe. Essa flexibilidade é adequada para cenários em que você precisa mesclar vários PDFs , extrair páginas específicas ou modificar documentos existentes.

Ao trabalhar com PDFs armazenados em serviços de nuvem, o IronPDF se integra ao Azure Blob Storage e a outras plataformas de nuvem. Você pode carregar PDFs a partir de fluxos de memória para um processamento eficiente sem acesso ao sistema de arquivos.

Quais métodos de importação estão disponíveis?

:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-file.cs
using IronPdf;

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

pdf.SaveAs("export.pdf");
Imports IronPdf

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

pdf.SaveAs("export.pdf")
$vbLabelText   $csharpLabel

Após a importação, você pode realizar diversas operações, como extrair texto e imagens , adicionar anotações ou aplicar assinaturas digitais .

Como faço para converter de outros formatos?

Além dos métodos já mencionados para obter um objeto PdfDocument, você pode converter vários formatos em PDF. O método mais sofisticado é a conversão de HTML para PDF, que renderiza o HTML juntamente com todos os seus recursos — incluindo JavaScript, imagens, links e estilos CSS — usando o mecanismo do Chrome. Além de HTML, você pode converter outros formatos para PDF, como imagens, RTF, Markdown e XML.

O mecanismo de renderização Chrome do IronPDF garante conversões perfeitas em termos de pixels, mantendo a fidelidade visual do conteúdo original. O renderizador é compatível com os padrões modernos da web, incluindo HTML5, CSS3 e frameworks JavaScript , tornando-o adequado para converter páginas web complexas ou visualizações Razor em PDFs.

O trecho de código a seguir demonstra a conversão de HTML para PDF. A conversão para HTML utiliza o mecanismo de renderização do IronPDF para manter a integridade do conteúdo com todos os estilos aplicados. Você também pode converter Markdown para PDF , XML para PDF e imagens para PDF .

Quais opções de renderização devo configurar?

:path=/static-assets/pdf/content-code-examples/how-to/create-new-pdfs-from-html.cs
using IronPdf;

// Instantiate Renderer
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.PrintHtmlBackgrounds = true;
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800);
renderer.RenderingOptions.WaitFor.RenderDelay(5000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

// 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");
Imports IronPdf

' Instantiate Renderer
Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.PrintHtmlBackgrounds = True
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1800)
renderer.RenderingOptions.WaitFor.RenderDelay(5000)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

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

' Export to a file or Stream
pdf.SaveAs("url.pdf")
$vbLabelText   $csharpLabel

Quais formatos podem ser convertidos para PDF?

O IronPDF suporta a conversão de vários formatos:

O PDF gerado pode ser visualizado usando um visualizador de PDF incorporado, como mostrado aqui. O iframe abaixo exibe o PDF gerado.

Para cenários avançados, explore a renderização de sites WebGL , o tratamento de atrasos em JavaScript ou a implementação de registros personalizados para solucionar problemas de conversão.

Perguntas frequentes

Como faço para instalar a biblioteca para começar a criar PDFs em C#?

Instale o IronPDF através do Gerenciador de Pacotes NuGet no Visual Studio. Você pode pesquisar por ' IronPDF' na interface do Gerenciador de Pacotes NuGet ou usar o Console do Gerenciador de Pacotes com o comando ' Install-Package IronPdf '. Após a instalação, você poderá começar a criar PDFs imediatamente usando o construtor PdfDocument ou a classe ChromePdfRenderer .

Qual é a maneira mais rápida de criar um documento PDF em branco?

A maneira mais rápida de criar um PDF em branco com o IronPDF é usando o construtor PdfDocument com parâmetros de largura e altura: new IronPdf.PdfDocument(270, 270).SaveAs('blank.pdf') . As dimensões são especificadas em pontos (1/72 de polegada). Você também pode definir tamanhos de página e orientações personalizados, além de adicionar metadados como autor e título.

Posso converter conteúdo HTML para o formato PDF?

Sim, o IronPDF se destaca na conversão de HTML para PDF usando a classe ChromePdfRenderer . Basta criar uma instância do renderizador e usar o método RenderHtmlAsPdf() : var renderer = new IronPdf.ChromePdfRenderer(); var pdf = renderer.RenderHtmlAsPdf('

Hello PDF!

') . Isso oferece suporte completo à renderização em HTML5, CSS3 e JavaScript .

Quais formatos de arquivo podem ser convertidos para PDF?

O IronPDF suporta a conversão de vários formatos para PDF, incluindo HTML, imagens (JPG, PNG, GIF, BMP), documentos RTF, arquivos Markdown e XML. Cada formato possui métodos específicos — por exemplo, use RenderHtmlAsPdf() para HTML, ImageToPdf() para imagens e renderizadores especializados para outros formatos.

Como adiciono metadados personalizados aos meus documentos PDF?

Após criar um PdfDocument com o IronPDF, acesse a propriedade MetaData para definir informações personalizadas: pdf.MetaData.Author = 'Your Name'; pdf.MetaData.Title = 'Document Title'; pdf.MetaData.CreationDate = DateTime.Now. Esses metadados auxiliam na organização e na busca do documento.

Posso importar PDFs existentes de diferentes fontes?

O IronPDF permite importar PDFs existentes de diversas fontes, incluindo arquivos locais, URLs, arrays de bytes ou dados JSON. Use PdfDocument.FromFile() para arquivos locais, FromUrl() para PDFs da web ou FromBytes() para dados de array de bytes. Isso permite que você trabalhe com documentos PDF existentes e os modifique.

Como faço para adicionar várias páginas a um documento PDF?

Use o método AppendPage() do seu objeto PdfDocument para adicionar páginas em branco dinamicamente. O IronPDF também permite inserir páginas em posições específicas, copiar páginas de outros PDFs e mesclar vários documentos PDF. Cada nova página herda o tamanho de página padrão, a menos que seja especificado o contrário.

Quais tamanhos e orientações de página são suportados?

O IronPDF suporta tamanhos de papel personalizados especificados em pontos, além de formatos predefinidos como Carta, A4 e Ofício. Você pode definir a orientação da página (retrato ou paisagem) e criar documentos com tamanhos de página mistos. As dimensões personalizadas oferecem controle preciso para aplicações específicas, como etiquetas ou cartões de visita.

Curtis Chau
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 ...

Leia mais
Pronto para começar?
Nuget Downloads 18,318,263 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronPdf
executar um exemplo Veja seu HTML se transformar em um PDF.