如何在 .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 文件,然後透過簡單的方法呼叫應用所需的旋轉或方向。 儲存更新後的文件,確保您的排版符合特定要求。 本指南可協助您快速上手。

Nuget Icon立即開始使用 NuGet 建立 PDF 檔案:

  1. 使用 NuGet 套件管理器安裝 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 時,您會發現 [ 渲染選項](https://ironpdf.com/how-to/rendering-options/) 提供了廣泛的 PDF 生成方式控制。 在將 HTML 文件、網頁或其他格式轉換為 PDF 時,方向設定尤其重要,因為它決定了頁面的基本排版。

何時應該使用橫向方向? <!--說明:說明程式碼概念的圖表或截圖 --> 橫向是需要較多水平空間的內容的理想選擇,例如寬表、圖表、儀表板或簡報。 當您[將 HTML 檔案轉換為 PDF](https://ironpdf.com/how-to/html-file-to-pdf/) 時,橫向模式可確保寬內容正確顯示,而不會出現不想要的文字包覆或元素溢出。 此方向對於包含財務資料、專案時間表或任何專為寬螢幕檢視而設計的內容的報告特別有用。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-orientation.cs ``` `ChromePdfRenderer` 類在設定方向時提供額外的彈性。 您還可以指定 [ 自訂紙張尺寸](https://ironpdf.com/how-to/custom-paper-size/)以及方向設定,以建立符合精確規格的 PDF。 這在為專門的列印需求或獨特的顯示格式製作文件時特別有價值。

橫向輸出是什麼樣子?

如何在 C# 中旋轉 PDF 頁面? --> <!--說明:顯示程式碼執行輸出或結果的截圖 --> IronPDF提供了四種可能的旋轉角度: - `None` :0 度或未旋轉的文件。 - `Clockwise90` :順時針旋轉90度。 - `Clockwise180` :順時針旋轉180度。 - `Clockwise270` :順時針旋轉 270 度。 以下所有頁面索引位置均採用從零開始的索引方式。 在 [ 程式化編輯 PDF](https://ironpdf.com/tutorials/csharp-edit-pdf-complete-tutorial/) 時,頁面旋轉是一項基本功能。 與渲染時應用的方向設定不同,旋轉可以套用至現有的 PDF 文件。 這使得它成為修正掃描文件、調整匯入內容或為特定檢視需求準備文件的必要工具。

我應該使用哪些方法來輪轉頁面? 使用下列方法設定單一頁面、多頁面或所有頁面的旋轉。 - `SetAllPageRotations` :設定所有頁面的旋轉角度。 - `SetPageRotation` :設定單一頁面的旋轉角度。 - `SetPageRotations` :設定選定頁面清單的旋轉角度。 IronPDF 的旋轉方法可與其他頁面處理功能無縫配合。 您可以將旋轉與其他[轉換操作](https://ironpdf.com/how-to/transform-pdf-pages/)結合,以實現複雜的文件佈局,或將它們與[旋轉文字和頁面的方法](https://ironpdf.com/how-to/rotating-text/)一起使用,以建立複雜的文件結構。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-set-rotation.cs ``` 在進行旋轉操作時,必須了解該操作會影響整個頁面內容,包括文字、圖片和任何註解。 這與文字特定旋轉不同,文字特定旋轉只會影響個別文字元素。 若要對文件排版進行更仔細的控制,請探索全面的 [ PDF 製作教程](https://ironpdf.com/tutorials/csharp-create-pdf-complete-tutorial/),其中涵蓋進階格式化技術。

旋轉後的 PDF 是什麼樣子?

如何檢查目前的網頁旋轉? 使用`GetPageRotation`方法檢索 PDF 文件中任何特定頁面的旋轉角度。 只需將頁面索引提供給該方法即可。 在處理混合方向的文件或需要在合併的文件中維持一致的旋轉時,此方法特別有用。 查詢目前旋轉狀態的能力可實現智慧型文件處理工作流程,尤其是結合其他 [ 頁面方向範例](https://ironpdf.com/examples/pdf-page-orientation/)時。 ```csharp :path=/static-assets/pdf/content-code-examples/how-to/page-orientation-rotation-get-rotation.cs ``` ## 頁面方向與旋轉的最佳實務 在您的應用程式中實作頁面方向和旋轉時,請考慮這些最佳實務: 1.**Determine Orientation Before Rendering**(渲染前確定方向):在渲染前設定方向,以確保最佳佈局。 2.**批次處理**:對多個頁面使用 `SetPageRotations` 以改善效能。 3.**保留原始檔案**:以新的檔案名稱儲存旋轉版本,以保留原始檔案。 4.**考慮使用者經驗**:請記住旋轉會影響 PDF 檢視器的顯示。 5.**與其他功能合併**:使用旋轉與標頭、合併或水印。 ## 疑難排解常見問題 如果您遇到頁面方向或旋轉的問題,請考慮這些解決方案: - **Content Cut-off in Landscape**:確保 HTML 內容是反應式的或調整檢視埠寬度 - **Rotation Not Applied**:確認您在套用旋轉方法後呼叫 `SaveAs` - **混合方向**:合併前可分開處理直式與橫式頁面 如需其他支援和進階技術,請探索全面的 [IronPDF 文件](https://ironpdf.com/docs/),或查看更多 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擁有卡爾頓大學電腦科學學士學位,專長於前端開發,精通Node.js、TypeScript、JavaScript和React。他熱衷於打造直覺美觀的使用者介面,喜歡使用現代框架,並擅長撰寫結構清晰、視覺效果出色的使用者手冊。

除了開發工作之外,柯蒂斯對物聯網 (IoT) 也抱有濃厚的興趣,致力於探索硬體和軟體整合的創新方法。閒暇時,他喜歡玩遊戲和製作 Discord 機器人,將他對科技的熱愛與創造力結合。

準備好開始了嗎?
Nuget 下載 17,012,929 | 版本: 2025.12 剛剛發布