1. IronPDF
  2. 如何
  3. 方向與旋轉
如何在.NET C#中設置頁面方向和旋轉

如何在 .NET C# 中設定頁面方向與旋轉

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

IronPDF 讓您能在 PDF 渲染過程中設定頁面方向（直式/橫式），並透過簡單的 C# 方法將現有或新建立的 PDF 頁面旋轉至 0°、90°、180° 或 270° 角度。

頁面方向（Page Orientation）指的是頁面的排版方式，分為垂直（直向）或水平（橫向）。

頁面旋轉是指調整頁面的角度，讓您能夠變更其方向，這對於修正對齊問題或滿足特定的檢視偏好非常有用。 頁面旋轉角度可設定為 90、180 及 270 度。

IronPDF 允許您在渲染過程中將頁面方向指定為直向或橫向。 此外，您可以根據需要，將新渲染或現有的 PDF 頁面分別旋轉至 0、90、180 或 270 度。

快速入門：在 C# 中設定 PDF 頁面方向與旋轉

using .NET C# 中的 IronPDF 設定 PDF 檔案的頁面方向與旋轉。 首先載入您的 PDF 檔案，接著透過簡單的函式呼叫，即可套用所需的旋轉或方向調整。 請儲存更新後的文件，並確保版面配置符合特定要求。 本指南可協助您快速上手。

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼片段。

    var pdf = IronPdf.PdfDocument.FromFile("file.pdf");
pdf.SetAllPageRotations(IronPdf.Rendering.PdfPageRotation.Clockwise90);
pdf.SaveAs("file-rotated.pdf");

  3. 部署以在您的實時環境中測試

    今天就開始在您的專案中使用IronPDF，透過免費試用

    arrow pointer

簡化工作流程（5 個步驟）

  1. 下載 IronPDF C# 函式庫，用於 PDF 頁面方向與旋轉
  2. 使用 PaperOrientation 屬性在渲染前設定頁面方向
  3. 透過 IronPDF 探索所有頁面旋轉選項
  4. 學習如何旋轉單一或多個 PDF 頁面
  5. 使用 IronPDF 還原 PDF 頁面旋轉


如何在 IronPDF 中設定頁面方向？

僅在將其他格式轉換為 PDF 文件時，才可設定頁面方向。 您可以從 RenderingOptions 類別存取 PaperOrientation 屬性。 此屬性可設定為直向或橫向。 直式為預設的頁面方向設定。

using IronPDF 時，您會發現其渲染選項能讓您對 PDF 的生成方式進行全面控制。 在將 HTML 文件、網頁或其他格式轉換為 PDF 時，方向設定至關重要，因為它決定了頁面的基本版面配置。

何時應使用橫向排版？

橫向排版最適合需要更多水平空間的內容，例如寬幅表格、圖表、儀表板或簡報。 將 HTML 檔案轉換為 PDF 時，橫向模式可確保寬幅內容正確顯示，避免出現不必要的文字換行或元素溢出。 此排版方式特別適用於包含財務資料、專案時程表，或任何專為寬螢幕檢視設計的內容之報告。

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-orientation.cs
using IronPdf;
using IronPdf.Rendering;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Change paper orientation
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;

PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

pdf.SaveAs("landscape.pdf");
Imports IronPdf
Imports IronPdf.Rendering

Private renderer As New ChromePdfRenderer()

' Change paper orientation
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape

Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

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

ChromePdfRenderer 類別在設定方向時提供了額外的靈活性。 您亦可配合頁向設定指定自訂紙張尺寸，以建立符合精確規格的 PDF 檔案。 這對於製作具有特殊列印需求或獨特顯示格式的文件時，尤為重要。

最終的翻譯成果會是什麼樣子？

如何在 C# 中旋轉 PDF 頁面？

IronPDF 提供四種旋轉角度選項：

  • None：0 度或未旋轉的文件。
  • Clockwise90：順時針旋轉 90 度。
  • Clockwise180：順時針旋轉 180 度。
  • Clockwise270：順時針旋轉 270 度。

請注意以下提及的所有頁面索引位置均採用零起始索引。

頁面旋轉是程式化編輯 PDF 時的一項基本功能。 與僅在渲染時生效的方向設定不同，旋轉功能可套用至現有的 PDF 文件。 這使其成為修正掃描文件、調整匯入內容，或為特定檢視需求準備文件時不可或缺的工具。

我應該使用哪些方法來旋轉頁面？

請使用以下方法設定單一頁面、多個頁面或所有頁面的旋轉角度。

  • SetAllPageRotations：設定所有頁面的旋轉角度。
  • SetPageRotation：設定單一頁面的旋轉角度。
  • SetPageRotations：設定選取頁面清單的旋轉角度。

IronPDF 的旋轉方法可與其他頁面處理功能無縫整合。 您可以將旋轉功能與其他變換操作結合，以實現複雜的文件版面配置；或搭配文字與頁面旋轉方法，共同建立精緻的文件結構。

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-set-rotation.cs
using IronPdf;
using IronPdf.Rendering;
using System.Collections.Generic;

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

// Set all pages
pdf.SetAllPageRotations(PdfPageRotation.Clockwise90);

// Set a single page
pdf.SetPageRotation(1, PdfPageRotation.Clockwise180);

// Set multiple pages
List<int> selectedPages = new List<int>() { 0, 3 };
pdf.SetPageRotations(selectedPages, PdfPageRotation.Clockwise270);

pdf.SaveAs("rotatedLandscape.pdf");
Imports IronPdf
Imports IronPdf.Rendering
Imports System.Collections.Generic

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

' Set all pages
pdf.SetAllPageRotations(PdfPageRotation.Clockwise90)

' Set a single page
pdf.SetPageRotation(1, PdfPageRotation.Clockwise180)

' Set multiple pages
Dim selectedPages As New List(Of Integer)() From {0, 3}
pdf.SetPageRotations(selectedPages, PdfPageRotation.Clockwise270)

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

進行旋轉操作時，請注意此操作會影響整個頁面內容，包括文字、圖片及任何註解。 這與僅影響個別文字元素的"文字特定旋轉"不同。 若需更精細地控制文件版面配置，請參閱涵蓋進階排版技巧的完整 PDF 製作教學指南。

旋轉後的 PDF 檔案看起來是什麼樣子？

如何查看當前頁面的旋轉狀態？

using GetPageRotation 方法來取得 PDF 文件中任何特定頁面的旋轉角度。 只需將頁面索引傳入該方法即可。

此方法在處理混合方向的文件時特別有用，或在需要維持合併文件間旋轉方向一致性時。 查詢當前旋轉狀態的能力，可實現智慧型文件處理工作流程，特別是在結合其他頁面方向範例時。

:path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-get-rotation.cs
using IronPdf;
using IronPdf.Rendering;

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

PdfPageRotation rotation = pdf.GetPageRotation(1);
Imports IronPdf
Imports IronPdf.Rendering

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

Private rotation As PdfPageRotation = pdf.GetPageRotation(1)
$vbLabelText   $csharpLabel
Icon Quote related to 如何查看當前頁面的旋轉狀態？

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic related to 如何查看當前頁面的旋轉狀態？

Milan Jovanovic

Microsoft MVP

查看案例研究
Icon Quote related to 如何查看當前頁面的旋轉狀態？

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle related to 如何查看當前頁面的旋轉狀態？

Brent Matzelle

首席技術官，OPYN

查看案例研究
Icon Quote related to 如何查看當前頁面的旋轉狀態？

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones related to 如何查看當前頁面的旋轉狀態？

David Jones

首席軟體工程師，Agorus Build

查看案例研究

頁面方向與旋轉的最佳實務

在應用程式中實作頁面方向與旋轉功能時，請參考以下最佳實務：

  1. 渲染前確定方向：在渲染前設定方向，以確保最佳版面配置。

  2. 批次處理：針對多頁文件請使用 SetPageRotations 以提升效能。

  3. 保留原始檔案：將旋轉後的版本以新檔名儲存，以保留原始檔案。

  4. 考量使用者體驗：請注意，旋轉會影響 PDF 檢視器的顯示效果。

  5. 結合其他功能：搭配標題旋轉、合併或浮水印功能使用。

常見問題排除

若遇到頁面方向或旋轉問題，請考慮以下解決方案：

  • 橫向顯示時內容截斷：確保 HTML 內容具備響應式設計，或調整視口寬度
  • 未套用旋轉：請確認在套用旋轉方法後，已呼叫 SaveAs
  • 混合方向：在合併前，請分別處理直向與橫向頁面

如需更多支援與進階技巧，請參閱詳盡的 IronPDF 文件，或查閱更多關於 PDF 處理的專業教學。

常見問題

如何在建立PDF時將頁面方向設置為橫向？

透過IronPDF，您可以使用RenderingOptions類中的PaperOrientation屬性設置頁面方向。只需在從HTML或其他格式渲染PDF之前將其設置為橫向或縱向即可。縱向是預設設置。

頁面方向與頁面旋轉有何不同？

IronPDF中的頁面方向決定從其他格式渲染PDF時的初始佈局（縱向或橫向）。頁面旋轉允許您在建立後將現有PDF頁面調整到0°、90°、180°或270°的角度，非常適合用於校正對齊問題。

我可以旋轉個別頁面還是必須旋轉整個PDF？

IronPDF提供靈活性來旋轉單個頁面和整個PDF。您可以使用方法按索引旋轉特定頁面或使用SetAllPageRotations方法一次性將旋轉應用於所有頁面。

什麼時候應該將我的PDF設置為橫向方向？

IronPDF中的橫向方向非常適合寬闊的內容，如表格、圖表、儀表板或簡報。特別是當轉換包含財務資料、專案時間線或任何為寬螢幕顯示而設計的內容時，它可以防止文字換行或元素溢出。

我如何檢查PDF頁面的當前旋轉角度？

IronPDF允許您程式化地檢索任何PDF頁面的當前旋轉角度。此功能有助於您在進行調整之前確定現有方向，或驗證您的旋轉變更已正確應用。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 20,088,359 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。