1. IronPDF
  2. 如何
  3. 轉換PDF頁面
如何使用IronPDF在C#中轉換PDF頁面

使用IronPDF在C#和.NET中轉換PDF頁面

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

IronPDF使.NET開發者能夠轉換PDF頁面，通過縮放和平移內容而不修改頁面尺寸。 使用Transform方法和參數來程式化重新定位和調整頁面內容的大小。

快速開始：輕鬆轉換PDF頁面

了解如何使用IronPDF程式庫在.NET中輕鬆轉換PDF頁面。 只需幾行程式碼，您就可以縮放和平移頁面內容而不影響原始頁面尺寸。 本指南展示如何應用轉換以無縫增強您的PDF文件。

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

    PM > Install-Package IronPdf

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

    IronPdf.PdfDocument.FromFile("input.pdf")
  .Pages[0].Transform(50,50,0.8,0.8)
  .SaveAs("output-transformed.pdf");

  3. 部署以在您的實時環境中測試

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

    arrow pointer

簡化工作流程（5個步驟）

  1. 下載IronPDF的C# PDF程式庫以轉換頁面
  2. 準備目標PDF文件
  3. 使用轉換方法來移動和縮放PDF頁面
  4. 通過新增HTML或圖像戳記進一步編輯PDF
  5. 將PDF導出為新文件


如何在C#中轉換PDF頁面？

Transform方法可以移動和調整內容大小。 這只影響頁面上顯示的內容外觀，並不改變物理頁面尺寸。 與修改整個頁面結構的頁面方向和旋轉不同，轉換僅調整內容定位。 讓我們在基本PDF文件範例中嘗試Transform方法。

:path=/static-assets/pdf/content-code-examples/how-to/transform-pdf-pages-transform-pdf.cs
using IronPdf;

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

pdf.Pages[0].Transform(50, 50, 0.8, 0.8);

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

Dim pdf As PdfDocument = PdfDocument.FromFile("basic.pdf")

pdf.Pages(0).Transform(50, 50, 0.8, 0.8)

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

Transform方法特別有用於在合併多個PDF或準備特定定制紙張尺寸的文件後重新定位內容。 此功能補充了其他佈局特性，例如設置自定義邊距以達到精確的文件格式。

Transform方法接受哪些參數？

Transform方法接受四個關鍵參數來控制內容定位和大小：

  • 水平平移 (TranslateX)：橫向移動頁面上的內容。 正值將內容移動到右邊，負值將其移動到左邊。 測量單位符合PDF標準（通常是點，1點 = 1/72英寸）。
  • 垂直平移 (TranslateY)：控制頁面內容的垂直移動。 正值將內容向下移動，負值將其向上移動。 這在您需要為頁眉和頁腳建立空間時非常有用。
  • 水平縮放 (ScaleX)：一個小數值調整內容寬度。 1.0的值保持原始大小，0.5縮小一半寬度，2.0倍增寬度。 此參數有助於在不影響縱橫比的情況下將內容調整到特定邊界內，當與匹配的垂直縮放一起使用時。
  • 垂直縮放 (ScaleX但影響高度。 保持相等的ScaleY值可保持內容的原始縱橫比。

這是一個展示多次轉換的高階範例：

:path=/static-assets/pdf/content-code-examples/how-to/transform-pdf-pages-3.cs
using IronPdf;
using System;

// Load an existing PDF or create a new one
PdfDocument pdf = PdfDocument.FromFile("invoice.pdf");

// Apply different transformations to multiple pages
for (int i = 0; i < pdf.Pages.Count; i++)
{
    if (i % 2 == 0)
    {
        // Even pages: Create margin space and reduce size slightly
        pdf.Pages[i].Transform(30, 30, 0.9, 0.9);
    }
    else
    {
        // Odd pages: Center content with larger margins
        pdf.Pages[i].Transform(40, 60, 0.85, 0.85);
    }
}

// Save the transformed document
pdf.SaveAs("invoice_transformed.pdf");

// You can also export to memory stream for web applications
var memoryStream = pdf.Stream;

Imports IronPdf
Imports System

' Load an existing PDF or create a new one
Dim pdf As PdfDocument = PdfDocument.FromFile("invoice.pdf")

' Apply different transformations to multiple pages
For i As Integer = 0 To pdf.Pages.Count - 1
    If i Mod 2 = 0 Then
        ' Even pages: Create margin space and reduce size slightly
        pdf.Pages(i).Transform(30, 30, 0.9, 0.9)
    Else
        ' Odd pages: Center content with larger margins
        pdf.Pages(i).Transform(40, 60, 0.85, 0.85)
    End If
Next

' Save the transformed document
pdf.SaveAs("invoice_transformed.pdf")

' You can also export to memory stream for web applications
Dim memoryStream = pdf.Stream
$vbLabelText   $csharpLabel

為什麼我需要轉換PDF頁面？

PDF頁面轉換在文件處理中提供了許多實用應用：

1. 建立適合印刷的文件：當準備專業列印的PDF時，您經常需要調整內容定位以適應出血區域、裝訂邊距或特定列印機要求。 Transform方法允許精確定位而不需重新建立文件。

2. 表單欄位對齊：在建立或編輯PDF表單後，您可能需要重新定位整個部分以對齊帶有預印刷信紙或模板。 轉換操作確保所有表單元素保持它們的相對位置。

3. 多文件編輯：當從各種來源合併文件時，每個文件可能具有不同的邊距設置。 使用Transform有助於標準化所有頁面的外觀，特別在對合併文件進行文字或圖像戳記時特別有用。

4. 響應式PDF生成：在基於使用者偏好或裝置規格生成PDF的動態應用中，Transform支持實時調整以確保在不同螢幕尺寸上達到最佳觀看效果。

PDF轉換前後顯示內容從整頁轉移到重新定位佈局

PDF轉換的最佳實踐

在實施PDF轉換時，請考慮這些優化策略：

保持縱橫比：除非需要故意失真，否則始終使用相同的ScaleY值。 這會保護文字和圖像的專業外觀。

測試邊界條件：在應用轉換之前，請確認縮放內容不會超過頁面邊界。 計算轉換後的有效內容範圍以防止裁剪。

批次處理效率：當轉換多個頁面時，考慮對大文件使用並行處理：

using IronPdf;
using System.Linq;
using System.Threading.Tasks;

public async Task TransformLargeDocument(string filePath)
{
    PdfDocument pdf = PdfDocument.FromFile(filePath);

    // Process pages in parallel for better performance
    var tasks = pdf.Pages.Select((page, index) => 
        Task.Run(() => 
        {
            // Apply consistent transformation to all pages
            page.Transform(25, 25, 0.95, 0.95);
        })
    ).ToArray();

    await Task.WhenAll(tasks);

    // Save with optimized settings
    pdf.SaveAs("transformed_optimized.pdf");
}
using IronPdf;
using System.Linq;
using System.Threading.Tasks;

public async Task TransformLargeDocument(string filePath)
{
    PdfDocument pdf = PdfDocument.FromFile(filePath);

    // Process pages in parallel for better performance
    var tasks = pdf.Pages.Select((page, index) => 
        Task.Run(() => 
        {
            // Apply consistent transformation to all pages
            page.Transform(25, 25, 0.95, 0.95);
        })
    ).ToArray();

    await Task.WhenAll(tasks);

    // Save with optimized settings
    pdf.SaveAs("transformed_optimized.pdf");
}
Imports IronPdf
Imports System.Linq
Imports System.Threading.Tasks

Public Async Function TransformLargeDocument(filePath As String) As Task
    Dim pdf As PdfDocument = PdfDocument.FromFile(filePath)

    ' Process pages in parallel for better performance
    Dim tasks = pdf.Pages.Select(Function(page, index) _
        Task.Run(Sub()
                     ' Apply consistent transformation to all pages
                     page.Transform(25, 25, 0.95, 0.95)
                 End Sub)
    ).ToArray()

    Await Task.WhenAll(tasks)

    ' Save with optimized settings
    pdf.SaveAs("transformed_optimized.pdf")
End Function
$vbLabelText   $csharpLabel

記憶體管理：對於大型文件，考慮分塊處理並保存到記憶體流，以優化伺服器環境下的資源使用。

常見的轉換場景

以下是對特定用例的實用範例：

建立縮略圖：通過縮小內容生成PDF頁面預覽，同時保持可讀性：

// Create thumbnail-sized versions of pages
pdf.Pages[0].Transform(10, 10, 0.3, 0.3);
// Create thumbnail-sized versions of pages
pdf.Pages[0].Transform(10, 10, 0.3, 0.3);
' Create thumbnail-sized versions of pages
pdf.Pages(0).Transform(10, 10, 0.3, 0.3)
$vbLabelText   $csharpLabel

新增裝訂邊距：移動內容以適應螺旋式裝訂或三孔活頁夾：

// Add 0.5 inch (36 points) binding margin on left
pdf.Pages[0].Transform(36, 0, 1.0, 1.0);
// Add 0.5 inch (36 points) binding margin on left
pdf.Pages[0].Transform(36, 0, 1.0, 1.0);
' Add 0.5 inch (36 points) binding margin on left
pdf.Pages(0).Transform(36, 0, 1.0, 1.0)
$vbLabelText   $csharpLabel

中心放置內容不足的內容：當內容不能填滿頁面時，專業地將其置中：

// Calculate centering offset (assuming standard letter size)
double pageWidth = 612; // points
double contentWidth = 500; // estimated content width
double centerOffset = (pageWidth - contentWidth) / 2;

pdf.Pages[0].Transform(centerOffset, 50, 1.0, 1.0);
// Calculate centering offset (assuming standard letter size)
double pageWidth = 612; // points
double contentWidth = 500; // estimated content width
double centerOffset = (pageWidth - contentWidth) / 2;

pdf.Pages[0].Transform(centerOffset, 50, 1.0, 1.0);
' Calculate centering offset (assuming standard letter size)
Dim pageWidth As Double = 612 ' points
Dim contentWidth As Double = 500 ' estimated content width
Dim centerOffset As Double = (pageWidth - contentWidth) / 2

pdf.Pages(0).Transform(centerOffset, 50, 1.0, 1.0)
$vbLabelText   $csharpLabel

Transform方法與IronPDF的綜合功能集無縫整合，允許您建立具有精確佈局的新PDF並修改現有文件以滿足特定需求。 無論您是構建自動文件處理系統還是建立自定義報告解決方案，掌握PDF轉換能增強您交付專業、精確格式文件的能力。

常見問題

如何在C#中程式化地轉換PDF頁面？

您可以使用IronPDF的Transform方法來轉換PDF頁面。此方法允許您縮放和翻譯頁面內容，而不修改實際的頁面尺寸。簡單地在頁面上呼叫Transform方法，帶有水平/垂直翻譯和縮放因子的參數。

Transform方法需要哪些參數？

IronPDF中的Transform方法接受四個參數：TranslateX（水平移動）、TranslateY（垂直移動）、ScaleX（水平縮放）和ScaleY（垂直縮放）。翻譯值以點（1/72英寸）為單位，縮放值為十進制乘法因子。

我可以在不改變頁面大小的情況下移動PDF內容嗎？

是的，IronPDF的Transform方法專門用於移動和調整內容的外觀，而不改變物理頁面尺寸。這與頁面旋轉或方向改變不同，因為後者會修改整個頁面結構。

如何將PDF內容縮小到其原始大小的80%？

若要使用IronPDF將PDF內容縮小到其原始大小的80%，請使用Transform方法，縮放參數設置為0.8。例如：Pages[0].Transform(0, 0, 0.8, 0.8)將把寬度和高度都縮小到80%。

我可以對PDF的特定頁面應用轉換嗎？

是的，IronPDF允許您通過Pages集合存取來轉換單個頁面。您可以根據需要對每個頁面應用不同的轉換，例如：Pages[0].Transform()用於第一頁。

正的和負的翻譯值有什麼區別？

在IronPDF的Transform方法中，正的TranslateX值會將內容向右移動，而負的值會將其向左移動。對於TranslateY，正的值會將內容向下移動，負的值會將其向上移動。這允許在任何方向上精確定位。

何時應該使用PDF轉換而不是旋轉？

當您需要重新定位或調整內容大小，同時保持頁面尺寸不變時，應使用IronPDF的Transform方法。這在合併PDF、準備文件以適應自定義紙張尺寸，或建立標頭和頁腳空間而不改變頁面結構時尤其理想。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

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

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 20,296,129 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。