Orientação retrato e paisagem

Frequentemente, ao criar documentos PDF dinâmicos, você precisará personalizar a orientação do documento. É aqui que entra o PaperOrientation do IronPDF. Esta ferramenta permite que os desenvolvedores acessem a classe PdfPaperOrientation. Com isso, você pode escolher entre a orientação de página paisagem ou retrato ao renderizar documentos PDF a partir de conteúdo HTML ou de URL.

  • Para orientação Paisagem, você usaria: PdfPaperOrientation.Landscape
  • Para orientação Retrato, você usa: PdfPaperOrientation.Portrait

Se você estiver trabalhando com documentos PDF existentes, você pode usar o PageRotation para personalizar a orientação do documento PDF. Para definir a rotação das páginas em seu documento, você deve:

  • Use SetPageRotation quando você estiver procurando rotacionar uma página específica dentro do PDF
  • Use SetAllPageRotations se você quiser girar todas as páginas de seu documento PDF

Para começar, precisamos decidir se vamos usar um documento PDF existente ou se vamos gerar um novo. Primeiro, vamos analisar os passos para definir a orientação de um documento PDF recém-renderizado e, em seguida, como isso funciona para um PDF já existente.

Primeiro, você precisará criar uma nova instância ChromePdfRenderer(). Esta função irá criar um novo documento PDF a partir de conteúdo HTML ou de URL. Em seguida, antes de renderizar, a orientação do papel é definida usando renderer.RenderingOptions.PaperOrientation. Ao escolher PdfPaperOrientation.Landscape, o PDF gerado aparecerá em modo paisagem em vez de na orientação padrão retrato. Vamos usar o método de renderização RenderHtmlAsPdf, que pega uma string HTML e a converte instantaneamente em um PDF.

Agora, vamos ver como você pode definir uma orientação personalizada para documentos PDF existentes. Primeiro, carregaremos um arquivo chamado old_report.pdf em um objeto PdfDocument, permitindo acesso às suas páginas. Usando Pages[0].PageRotation, você pode verificar o estado de rotação da primeira página. Para fazer alterações, SetPageRotation rotaciona uma única página, neste caso girando a página um em 90 graus no sentido horário.

Em conjunto, esses exemplos ilustram como o IronPDF não apenas cria PDFs refinados a partir de HTML e fontes da web, mas também fornece ferramentas poderosas para ajustar a orientação e a rotação da página em documentos PDF existentes, otimizando os fluxos de trabalho de PDF para desenvolvedores .NET .

Saiba mais sobre orientação e rotação de páginas em PDFs.

Pronto para começar?
Nuget Downloads 19,936,792 | Versão: 2026.7 recém-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.