IRONSOFTWAREHOME

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

Curtis Chau
Curtis Chau
Updated: 2026年9月5日

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. 1Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

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

    var pdf = IronPdf.PdfDocument.FromFile("file.pdf");
    pdf.SetAllPageRotations(IronPdf.Rendering.PdfPageRotation.Clockwise90);
    pdf.SaveAs("file-rotated.pdf");
    C#
  3. 3部署以在您的實時環境中測試

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

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

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

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

何時應使用橫向排版?

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

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");

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

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


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

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

  • None:0 度或未旋轉的文件。
  • Clockwise90:順時針旋轉 90 度。
  • Clockwise180:順時針旋轉 180 度。
  • Clockwise270:順時針旋轉 270 度。
請注意: 以下提及的所有頁面索引位置均採用零起始索引。

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

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

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

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

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

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");

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

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

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

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

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

using IronPdf;
using IronPdf.Rendering;

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

PdfPageRotation rotation = pdf.GetPageRotation(1);

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

Milan Jovanovic

Microsoft MVP

查看案例研究

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

Brent Matzelle

首席技術官,OPYN

查看案例研究

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

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頁面的當前旋轉角度。此功能有助於您在進行調整之前確定現有方向,或驗證您的旋轉變更已正確應用。

What should I consider when using landscape orientation in PDFs?

Landscape orientation is best for content that requires more horizontal space, such as wide tables or charts. It helps display wide content correctly without text wrapping issues.

How can I check the current rotation of a specific PDF page?

You can check the current rotation of a PDF page by using the `GetPageRotation` method, supplying the page index as a parameter to retrieve the rotation degree of that page.

Is it possible to set different page orientations for merged PDFs using IronPDF?

Yes, IronPDF provides options to manage page orientation for PDFs prior to merging. It's advisable to process pages with different orientations separately before merging them.

How does page rotation affect the overall PDF layout?

Page rotation affects the entire content of the page, including text, images, and annotations. It is typically used for document alignment corrections or specific viewing requirements.

What best practices should I follow for page orientation and rotation in PDF files?

Best practices include determining orientation before rendering, using batch processing for rotation, preserving original files, considering user experience, and combining rotation with features like headers or watermarks.

Curtis Chau
技術作家

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

...
閱讀更多

準備開始了嗎?

Nuget Downloads 20,878,335版本:2026.9剛剛發布

立即獲取免費

立即獲取 30天試用金鑰

bullet_checked無需信用卡或註冊帳號
bullet_test在生產
環境中進行測試,且不顯示浮水印
bullet_calendar30 天全
功能產品
bullet_support試用期間提供 24/5 技術
支援
立即獲取您的免費30天試用密鑰
不需要信用卡或建立賬戶
C# 用於PDF的NuGet程式庫
使用NuGet安裝

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解決方案資源管理器,右鍵點選參考,管理NuGet包
  2. 選擇瀏覽並搜尋"IronPdf"
  3. 選擇套件並安裝
C# PDF DLL
下載DLL

版本: 2026.9

或者點擊此處下載Windows安裝程式。

  1. 下載並解壓IronPDF到類似~/Libs的位置,位於您的解決方案目錄中
  2. 在Visual Studio解決方案資源管理器,右鍵點選參考。選擇瀏覽,"IronPdf.dll"

授權從$999

有問題嗎?聯絡我們的開發團隊。

Key in blue circle

立即免費取得 30 天試用金鑰

Your trial license will be sent to your email address

無任何限制。100% 解鎖。無需信用卡。

bullet_checked無需信用卡或建立帳號無任何限制。100% 解鎖。無需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
預訂您的免費現場演示
Booking Badge

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務諮詢
填寫以下表格或電子郵件sales@ironsoftware.com
您的詳細資訊將始終保密
受到全球數百萬工程師的信任
Iron Software的客戶標誌
立即獲取您的30天試用金鑰
無需信用卡或帳戶建立