如何在 .NET C# 中設置頁面方向和旋轉 | IronPDF

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

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

IronPDF可讓您在 PDF 渲染期間設定頁面方向(縱向/橫向),並使用簡單的 C# 方法將現有或新建立的 PDF 頁面旋轉到 0°、90°、180° 或 270° 角度。

頁面方向是指頁面的佈局方式,可以是垂直方向(縱向)或水平方向(橫向)。

頁面旋轉是指調整頁面的角度,從而改變頁面的方向,這對於校正對齊方式或滿足特定的觀看偏好非常有用。 頁面角度可設定為 90 度、180 度和 270 度。

IronPDF可讓您在渲染過程中指定方向為縱向或橫向。 此外,您可以根據需要將新渲染的或現有的 PDF 頁面單獨旋轉 0、90、180 或 270 度角。

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

使用.NET C# 中的IronPDF設定 PDF 檔案的頁面方向和旋轉角度。 首先載入您的 PDF 文件,然後透過簡單的方法呼叫應用所需的旋轉或方向。 儲存更新後的文檔,確保佈局符合特定要求。 本指南可協助您快速入門。

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

    PM > Install-Package IronPdf
  2. 複製並運行這段程式碼。

    IronPdf.PdfDocument.FromFile("file.pdf")
        .SetAllPageRotations(IronPdf.PdfDocument.PageRotation.Rotate90)
        .SaveAs("rotated.pdf");
  3. 部署到您的生產環境進行測試

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

    arrow pointer


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

只有在從其他格式產生 PDF 文件時才能設定方向。 您可以從 RenderingOptions 類別存取 PaperOrientation 屬性。 此屬性可以設定為縱向或橫向。 預設頁面方向設定為縱向。

使用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");
$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");
$vbLabelText   $csharpLabel

使用旋轉功能時,需要了解該操作會影響整個頁面內容,包括文字、圖像和任何註釋。 這與文字特定的旋轉不同,文字特定的旋轉只會影響單一文字元素。 如需更精細地控製文件佈局,請探索涵蓋進階格式設定技巧的全面PDF 建立教學課程

旋轉後的PDF是什麼樣子的?

如何查看目前頁面旋轉方向?

使用 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);
$vbLabelText   $csharpLabel

頁面方向和旋轉的最佳實踐

在應用程式中實現頁面方向和旋轉時,請考慮以下最佳實踐:

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 中的橫向是表格、圖表、儀表板或簡報等寬廣內容的理想選擇。在轉換包含財務資料、專案時間表或任何專為寬螢幕檢視而設計的內容的 HTML 檔案時,它尤其有用,可防止文字包覆或元素溢出。

如何檢查 PDF 頁面目前的旋轉角度?

IronPDF 允許您以程式化的方式擷取任何 PDF 頁面的目前旋轉角度。此功能可協助您在調整之前確定現有方向,或驗證您的旋轉變更是否已正確套用。

Curtis Chau
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位,專注於前端開發,擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面,喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 有著濃厚的興趣,探索將硬體和軟體結合的創新方式。在閒暇時間,他喜愛遊戲並構建 Discord 機器人,結合科技與創意的樂趣。

準備好開始了嗎?
Nuget 下載 17,803,474 | 版本: 2026.3 剛剛發布
Still Scrolling Icon

還在滾動嗎?

想快速取得證據? PM > Install-Package IronPdf
運行範例看著你的HTML程式碼變成PDF檔。