1. IronPDF
  2. 操作指南
  3. 方向與旋轉
如何在 .NET C# 中設定頁面方向與旋轉 | IronPDF

如何在 .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. using 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

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

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

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

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

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

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

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

常見問題排除

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

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

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

常見問題

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

using 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 University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？
Nuget 下載 19,014,616 | 版本： 2026.5 just released
Still Scrolling Icon

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例 觀看您的 HTML 轉為 PDF。