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

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

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

IronPDF 使 C# 開發人員能夠使用簡單的方法,如 SetPageRotation() 對完整的頁面進行旋轉,或 CSS3 對特定的文字元素進行轉換,以程式化的方式旋轉 PDF 頁面和文字,並支援 90, 180270 度的順時針旋轉。

旋轉 PDF 文字或頁面可改變 PDF 文件中整頁或特定文字元素的方向。 這種旋轉是以度為單位(通常為 90180270),以順時針或逆時針來重新定位內容。此功能對於修正掃瞄文件、建立橫向報告,或調整內容呈現方式以符合特定檢視需求是非常重要的。

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

使用 IronPDF,您可以在 .NET 應用程式中輕鬆旋轉 PDF 頁面。 只要幾行程式碼,您就可以將 PDF 內容的方向調整到任何想要的角度。 本快速入門指南教您如何將 PDF 文件的第一頁旋轉 90 度,並毫不費力地儲存變更。 非常適合希望以最少的努力提昇文件演示效果的開發人員。

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

  1. 使用 NuGet 套件管理器安裝 IronPDF

    PM > Install-Package IronPdf

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

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

    立即開始在您的專案中使用 IronPDF,免費試用!
    arrow pointer


如何以程式方式旋轉 PDF 頁面?

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

使用SetPageRotationSetPageRotationsSetAllPageRotations方法分別設定單一頁面、多個頁面和所有頁面的旋轉角度。 這些方法會以指定的程度完全覆寫目前頁面的旋轉,以順時針方向測量。如果原始的頁面旋轉度已經符合所需的程度,這些方法將不會影響輸出檔案。

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

支援哪些旋轉角度?

IronPdf 支援四種標準旋轉角度:(不旋轉)、90°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");
$vbLabelText   $csharpLabel

在使用頁面旋轉時,瞭解它們如何與其他 PDF 功能互動是非常重要的。 例如,如果您同時使用 自訂紙張尺寸,則會在設定頁面尺寸後套用旋轉功能。 這表示將縱向頁面旋轉 90 度後,實際上會變成橫向頁面。


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

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

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

這種方法在製作混合方向的文件時特別有用,例如在圖表上有垂直標籤的報告或有旋轉標題的表格。 IronPDF 中的 HTML 到 PDF 的轉換過程完全支援 CSS3 變換,確保您的樣式化內容在最終 PDF 中完全符合預期效果。

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

使用您之前安裝的 IronPDF for .NET Library 將 HTML 轉換為 PDF 後,CSS3 允許文字旋轉到任何角度。 這是透過 CSS3 樣式transform: rotate(...)實現的,它可以將任何 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");
$vbLabelText   $csharpLabel

CSS3 變換屬性支援各種旋轉單位,包括度 (deg)、弧度 (rad)、梯度 (grad) 和圈數。 對於 PDF 的產生,度數是最常用的。 您也可以將旋轉與其他變形(如縮放和轉換)結合,以達到複雜的定位效果。 在 IronPDF 中使用 響應式 CSS 時,這些轉換可以無縫適應不同的頁面大小和方向。

對於更進階的情境,您可能想要探索 在初始呈現之後,以程式化的方式轉換 PDF 頁面。 這可讓您將額外的轉換套用至現有的 PDF,或是將基於 CSS 的旋轉與頁面層級的轉換結合,以進行複雜的文件佈局。

準備好看看您還能做些什麼嗎? 在此查看我們的教學頁面:編輯 PDFs 或探索如何 使用自訂方向從頭開始建立新的 PDFs。 如需在同一文件中管理不同的頁面方向,請參閱我們的 portrait and landscape orientation 指南。

常見問題解答

如何使用 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 擁有電腦科學學士學位(卡爾頓大學),專長於前端開發,精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情,他喜歡使用現代化的架構,並製作結構良好且視覺上吸引人的手冊。

除了開發之外,Curtis 對物聯網 (IoT) 也有濃厚的興趣,他喜歡探索整合硬體與軟體的創新方式。在空閒時間,他喜歡玩遊戲和建立 Discord bots,將他對技術的熱愛與創意結合。

準備好開始了嗎?
Nuget 下載 17,527,568 | 版本: 2026.2 剛剛發布