1. IronPDF
  2. 如何使用
  3. 適合紙張與縮放
如何在 C# 中使用虛擬視口和縮放

如何在 IronPDF 中使用 C# 虛擬視窗和縮放功能

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

在 HTML 轉 PDF 渲染過程中，視口在決定網頁佈局如何在產生的 PDF 文件中呈現方面起著至關重要的作用。 具體來說，它指的是瀏覽器應該將網頁渲染到的虛擬螢幕尺寸。

在 HTML 到 PDF 的渲染過程中，縮放控制 PDF 文件中網頁內容的縮放比例。 透過微調縮放級別，可以調整生成的 PDF 中內容的大小，確保其符合您所需的佈局和格式。

快速入門：使用 IronPDF 控制縮放和視窗

了解如何使用 IronPDF 輕鬆管理 HTML 轉 PDF 轉換中的縮放和視窗設定。 本快速指南提供了一個簡單的程式碼片段，幫助您開始縮放 HTML 內容。 只需幾行程式碼，即可確保 PDF 檔案完美渲染，保持響應式設計元素和所需佈局。 立即體驗 IronPDF 強大的渲染選項所帶來的便利。

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

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

    PM > Install-Package IronPdf

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

    new IronPdf.ChromePdfRenderer { RenderingOptions = { ViewPortWidth = 1280, Zoom = 1.8 } }
    .RenderUrlAsPdf("https://example.com")
    .SaveAs("zoomedViewport.pdf");

  3. 部署到您的生產環境進行測試

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

最小工作流程（5 個步驟）

  1. 下載 IronPDF C# 庫，用於 PDF 渲染和視口控制。
  2. 使用不同的預設模式將HTML渲染為PDF
  3. 使用Chrome默認和響應式CSS模式來實現PDF中的自動佈局
  4. 利用縮放縮小內容
  5. 配置"適合頁面"和"連續打印"以滿足特定使用需求


紙面擬合模式

存取 RenderingOptions 中的PaperFit字段，以呼叫可用於特定渲染類型和模式的預設方法。 讓我們透過渲染著名的維基百科頁面進行比較，更詳細地檢查每種 PaperFit 模式。

Chrome 預設渲染

以與 Google Chrome 列印預覽中相同的方式佈局 PDF 頁面。 此方法配置渲染選項，以模擬從 Google Chrome 的列印預覽列印網頁時的外觀。 針對指定紙張尺寸，響應式 CSS 視窗會根據該紙張尺寸的寬度進行解析。可以使用UseChromeDefaultRendering方法進行配置。

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-default-chrome.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

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

Private renderer As New ChromePdfRenderer()

' Chrome default rendering
renderer.RenderingOptions.PaperFit.UseChromeDefaultRendering()

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

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

響應式 CSS 渲染

在響應式 CSS 模式下，您可以透過向UseResponsiveCssRendering方法傳遞值來指定視窗寬度。 預設視口寬度為 1280 像素。 您可能已經注意到，視窗單位是基於像素的，代表響應式 CSS 設計的虛擬瀏覽器視窗。

響應式 CSS 用於根據ViewPortWidth參數定義 HTML 的渲染，將內容縮放以適應指定紙張尺寸的寬度。

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-responsive-css.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

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

Private renderer As New ChromePdfRenderer()

' Responsive CSS rendering
renderer.RenderingOptions.PaperFit.UseResponsiveCssRendering(1280)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

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

縮放渲染

UseScaledRendering方法採用的佈局模擬了指定紙張尺寸下"Chrome 列印預覽"的行為。它還提供了一個額外的縮放級別，開發者可以手動調整。此方法允許根據輸入的縮放百分比縮放內容。

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-scaled.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

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

Private renderer As New ChromePdfRenderer()

' Scaled rendering
renderer.RenderingOptions.PaperFit.UseScaledRendering(180)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

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

適應頁面渲染

相反，"適應頁面"渲染會將內容縮放以適應指定的紙張尺寸。它會在渲染後測量 HTML 內容的最小寬度，並盡可能將其縮放以適應一張紙的寬度。 可配置的最小像素寬度用作文件的基於像素的最小寬度，以確保正確顯示並回應 CSS3 佈局規則。

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-fit-to-page.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering();

// Render web URL to PDF
PdfDocument pdf = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page");

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

Private renderer As New ChromePdfRenderer()

' Fit to page rendering
renderer.RenderingOptions.PaperFit.UseFitToPageRendering()

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://en.wikipedia.org/wiki/Main_Page")

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

連續進料渲染

連續進紙渲染會產生單頁 PDF 文件，強制所有內容的寬度和高度都適應一頁紙，因此適用於帳單或收據等文件。 PDF 頁面的預設寬度為 80.0 毫米，預設頁邊距為 5 毫米。 Let's render the 'receipt.html' file to PDF.

透過使用"寬度"和"邊距"參數自訂頁面寬度和邊距，可以靈活地建立簡潔的單頁文檔，使其成為一個方便的選擇。

:path=/static-assets/pdf/content-code-examples/how-to/viewport-zoom-continuous-feed.cs
using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

int width = 90;
int margin = 0;

// Continuous feed rendering
renderer.RenderingOptions.PaperFit.UseContinuousFeedRendering(width, margin);

// Render web URL to PDF
PdfDocument pdf = renderer.RenderHtmlFileAsPdf("receipt.html");

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

Private renderer As New ChromePdfRenderer()

Private width As Integer = 90
Private margin As Integer = 0

' Continuous feed rendering
renderer.RenderingOptions.PaperFit.UseContinuousFeedRendering(width, margin)

' Render web URL to PDF
Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf("receipt.html")

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

準備好看看您還能做些什麼嗎？ 請造訪我們的教學頁面：轉換 PDF 文件

常見問題解答

如何以響應式 CSS 造型將 HTML 呈現為 PDF？

您可以利用 IronPdf 支援 bootstrap 和其他 CSS 框架的能力，以響應式 CSS 造型來呈現 HTML，確保您的網頁內容能準確地擷取到 PDF 中。

在 HTML 到 PDF 的轉換中，視口有什麼重要性？

視口在 HTML 至 PDF 的轉換中至關重要，因為它定義了瀏覽器用來呈現網頁的虛擬螢幕尺寸，直接影響 PDF 中的版面設計。

將 HTML 轉換為 PDF 時，如何調整縮放程度？

使用 IronPdf，您可以透過指定縮放係數來調整縮放程度，這可讓您控制 PDF 中內容的大小，以符合您所需的排版與呈現方式。

IronPDF 中的 Chrome 預設渲染功能是什麼？

IronPDF 中的 Chrome 預設渲染可模擬在 Google Chrome 列印預覽中看到的網頁外觀，使用回應式 CSS 將內容適合指定的紙張大小。

在生成 PDF 時，回應式 CSS 渲染是如何工作的？

IronPDF 中的回應式 CSS 渲染功能可讓您指定視埠寬度，縮放 HTML 內容以符合紙張大小。預設情況下，視埠寬度設定為 1280 像素，以確保內容能符合 PDF 的尺寸。

我可以使用 Scaled Rendering 自訂縮放調整嗎？

是的，IronPDF 中的縮放渲染功能允許開發人員通過指定百分比來調整縮放級別，從而精確控制 PDF 中網頁內容的縮放。

在 PDF 生成中使用「適合頁面」渲染有什麼好處？

IronPDF 中的「適合頁面」渲染功能可根據所選的紙張大小對內容進行調整，確保維持最小像素寬度，這是實現正確顯示和版面一致性的關鍵。

Continuous Feed Rendering 與其他渲染模式有何不同？

IronPDF 中的 Continuous Feed Rendering（連續饋入渲染）可創建容納整頁內容寬度和高度的單頁 PDF，非常適合需要整頁內容的消費帳單或收據等文件。

IronPDF 是否與 .NET 10 完全相容，尤其是視埠和縮放控制？

Yes-IronPDF 與 .NET 10 完全相容。它可直接在 .NET 10 環境中支援所有的視埠與縮放渲染選項（例如設定 ViewPortWidth、使用縮放比例、反應式 CSS），而無需額外的設定。([IronPdf.com](https://ironpdf.com/blog/net-help/net-10-features/?utm_source=openai))

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

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

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

準備好開始了嗎？
Nuget 下載 16,493,056 | Version: 2025.11 剛發表