如何使用 C# 旋轉 PDF 中的文字 | IronPDF

使用 IronPDF 在 C# 中旋轉 PDF 文字與頁面

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

IronPDF 讓 C# 開發人員能夠透過程式化方式旋轉 PDF 頁面與文字,使用如 SetPageRotation() 來處理整頁,或 CSS3 變換來處理特定文字元素,支援 180270 度順時針旋轉。

旋轉 PDF 文字或頁面會變更 PDF 文件中整頁或特定文字元素的方向。 此旋轉功能以度為單位(通常為 180270),用於將內容順時針或逆時針重新定位。此功能對於修正掃描文件、製作橫向報告,或根據特定檢視需求調整內容呈現方式至關重要。

快速入門:使用 IronPDF for .NET 在 PDF 中旋轉頁面

使用 IronPDF,您可在 .NET 應用程式中輕鬆旋轉 PDF 頁面。 只需幾行程式碼,您即可將 PDF 內容的旋轉方向調整至任何所需的角度。 本快速入門指南將向您展示如何將 PDF 文件的第一頁旋轉 90 度,並輕鬆儲存變更。 非常適合希望以最少的努力來提升文件呈現效果的開發人員。

  1. using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf
  2. 請複製並執行此程式碼片段。

    IronPdf.PdfDocument.FromFile("input.pdf")
      .SetAllPageRotations(IronPdf.PdfPageRotation.Clockwise90)
      .SaveAs("rotated.pdf");
  3. 部署至您的生產環境進行測試

    立即透過免費試用,在您的專案中開始使用 IronPDF

    arrow pointer


如何透過程式碼旋轉 PDF 頁面?

針對不同的旋轉情境,我應該使用哪些方法?

請分別使用 SetPageRotationsSetAllPageRotations 方法,來設定單一頁面、多頁及所有頁面的旋轉角度。 這些方法會完全以指定角度(順時針方向)覆寫當前的頁面旋轉角度。若原始頁面旋轉角度已與目標角度相符,這些方法將不會影響輸出檔案。

IronPdf 函式庫提供全面的頁面方向與旋轉功能,可無縫整合至現有的 PDF 工作流程中。 無論您處理的是新建立的 PDF 檔案或現有文件,這些旋轉方法都能精確控制頁面方向,同時不影響實際的內容結構。

支援哪些旋轉角度?

IronPDF 支援四種標準旋轉角度:180° 以及 270°(順時針)。這些角度涵蓋了 PDF 文件的所有常見旋轉需求。 旋轉效果是套用在頁面層級,這意味著整個頁面內容(包括文字、圖片和圖形)會作為單一整體進行旋轉。 此方法可維持頁面元素之間的空間關係。

:path=/static-assets/pdf/content-code-examples/how-to/rotating-text-set-page-rotation.cs
using IronPdf;
using IronPdf.Rendering;
using System.Linq;

// Import PDF
PdfDocument pdf = PdfDocument.FromFile("multi-page.pdf");

// Set rotation for a single page
pdf.SetPageRotation(0, PdfPageRotation.Clockwise90);

// Set rotation for multiple pages
pdf.SetPageRotations(Enumerable.Range(1,3), PdfPageRotation.Clockwise270);

// Set rotation for the entire document
pdf.SetAllPageRotations(PdfPageRotation.Clockwise180);

pdf.SaveAs("rotated.pdf");
Imports IronPdf
Imports IronPdf.Rendering
Imports System.Linq

' Import PDF
Private pdf As PdfDocument = PdfDocument.FromFile("multi-page.pdf")

' Set rotation for a single page
pdf.SetPageRotation(0, PdfPageRotation.Clockwise90)

' Set rotation for multiple pages
pdf.SetPageRotations(Enumerable.Range(1,3), PdfPageRotation.Clockwise270)

' Set rotation for the entire document
pdf.SetAllPageRotations(PdfPageRotation.Clockwise180)

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

在處理頁面旋轉時,必須了解其與其他 PDF 功能的互動方式。 例如,若您同時使用自訂紙張尺寸,旋轉效果將在設定頁面尺寸後生效。 這意味著將 90 度旋轉的直向頁面,實際上將轉為橫向排列。


如何使用 CSS3 旋轉 PDF 中的文字?

為何使用 CSS3 變換而非頁面旋轉?

在 .NET 中將 HTML 轉換為 PDF 後,您可能需要透過程式設計方式旋轉文字或整頁內容。 常見的需求之一是利用 HTML5 和 CSS3 在 PDF 中呈現垂直對齊的文字。相較於頁面層級的旋轉,CSS3 變換功能提供更細緻的控制,讓您能夠旋轉個別的文字元素或區塊,同時保持頁面其餘部分的原始方向。

此方法在製作混合方向的文件時特別有用,例如圖表上有垂直標籤的報告,或表頭已旋轉的表格。 IronPDF 的 HTML 轉 PDF 流程完全支援 CSS3 變換,確保您設計的樣式內容在最終 PDF 中能完全如預期般呈現。

哪些 CSS 屬性可控制文字旋轉?

透過您先前安裝的 IronPdf .NET 函式庫,將 HTML 轉換為 PDF 後,CSS3 允許將文字旋轉至任意角度。 此效果是透過 transform: rotate(...) CSS3 樣式實現的,該樣式可將任何 HTML 元素旋轉至任意角度。 您可以透過 transform-origin 屬性自訂旋轉原點,藉此完全掌控旋轉的支點位置。

:path=/static-assets/pdf/content-code-examples/how-to/rotating-text-css.cs
using IronPdf;

var renderer = new IronPdf.ChromePdfRenderer();

var pdf = renderer.RenderHtmlAsPdf(@"
<html>
<head>
 <style>
  .rotated{
  -webkit-transform: rotate(-180deg);
  width:400;
  height:400;
  }
</style>
</head>
<body>
<p class='rotated'>Rotated Text</p>
</body>
</html>
");

pdf.SaveAs("rotated.pdf");
Imports IronPdf

Private renderer = New IronPdf.ChromePdfRenderer()

Private pdf = renderer.RenderHtmlAsPdf("
<html>
<head>
 <style>
  .rotated{
  -webkit-transform: rotate(-180deg);
  width:400;
  height:400;
  }
</style>
</head>
<body>
<p class='rotated'>Rotated Text</p>
</body>
</html>
")

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

CSS3 的 transform 屬性支援多種旋轉單位,包括度 (deg)、弧度 (rad)、梯度 (grad) 以及轉 (turns)。 在 PDF 生成方面,最常使用的是度(deg)為單位。 您亦可將旋轉與縮放、平移等其他變換結合使用,以實現複雜的定位效果。 當在 IronPDF 中使用響應式 CSS 時,這些變換能無縫適應不同的頁面尺寸與方向。

若需處理更複雜的場景,您可能需要探索在初始渲染後,透過程式化方式轉換 PDF 頁面。 這讓您能夠對現有 PDF 檔案套用額外的變換,或將基於 CSS 的旋轉與頁面層級的變換結合,以處理複雜的文件版面配置。

準備好探索更多可能性了嗎? 請點此查看我們的教學頁面:編輯 PDF,或探索如何從頭開始建立具有自訂方向的新 PDF 檔案。 關於在同一份文件中管理不同頁面方向,請參閱我們關於直式與橫式方向的指南。

常見問題

如何使用 C# 旋轉 PDF 文件中的特定頁面?

IronPDF 提供三種 PDF 頁面旋轉方法:SetPageRotation() 適用於單一頁面、SetPageRotations() 適用於多個頁面,以及 SetAllPageRotations() 適用於所有頁面。這些方法支援順時針 90°、180° 和 270° 的旋轉角度,並會完全覆寫當前頁面的旋轉狀態。

PDF 頁面支援哪些旋轉角度?

IronPDF 支援四種標準旋轉角度:0°(不旋轉)、90°、180° 以及順時針 270°。旋轉操作是在頁面層級進行,這意味著所有內容(包括文字、圖片和圖形)將作為單一整體進行旋轉,同時維持元素間的空間關係。

能否僅旋轉文字元素,而不旋轉整個 PDF 頁面?

是的,IronPDF 允許您使用 CSS3 變換來旋轉特定的文字元素。這使您能夠在不影響整體頁面方向的情況下,旋轉頁面中的個別文字元件,從而精確控制文字的呈現方式。

有什麼最簡單的方法可以將 PDF 中的所有頁面旋轉 90 度?

最快速的方法是使用 IronPDF 的單行解決方案:IronPdf.PdfDocument.FromFile("input.pdf").SetAllPageRotations(IronPdf.PdfPageRotation.Clockwise90).SaveAs("rotated.pdf")。此程式碼會載入您的 PDF 檔案,將所有頁面順時針旋轉 90 度,並儲存結果。

旋轉 PDF 頁面會影響內容結構嗎?

不,IronPDF 的旋轉方法會完整保留內容結構。旋轉操作是在頁面層級進行,不會影響實際的內容關聯性。文字仍可選取、連結仍可正常運作,且文件的內部結構亦會完整保留。

如何透過程式碼修正掃描文件的方向?

IronPDF 非常適合用於修正掃描文件的頁面方向。您可以使用 SetPageRotation() 方法旋轉單一頁面,或使用 SetAllPageRotations() 來修正整個文件。這對於批次處理可能存在頁面方向不一致的掃描 PDF 文件特別有用。

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。