1. IronPDF
  2. 操作指南
  3. 适合纸张和缩放
如何使用虚拟视图窗口和缩放在 C#

How to use Virtual Viewport and Zoom

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 IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

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

  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

最小化工作流程（5个步骤）

  1. 下载 IronPDF C# 库以进行 PDF 渲染和视口控制
  2. 使用不同预配置模式将 HTML 渲染为 PDF
  3. 使用 Chrome 默认和响应式 CSS 模式在 PDF 中实现自动布局
  4. 利用缩放功能缩放内容
  5. 针对特定用例配置“适合页面”和“连续馈送”功能


纸张适合模式

访问 RenderingOptions 中的 PaperFit 字段，以调用可用于特定渲染类型和模式的预设方法。 让我们通过渲染众所周知的 Wikipedia 页面来更详细地审查每种 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 框架的支持，将 HTML 与响应式 CSS 样式一同渲染，从而确保网页内容在 PDF 中被准确捕获。

视口在 HTML 转 PDF 中的重要性是什么?

视口在 HTML 转 PDF 中至关重要，因为它定义了浏览器用于渲染页面的虚拟屏幕尺寸，直接影响到布局和设计在 PDF 中的捕获方式。

如何在将 HTML 转换为 PDF 时调整缩放级别？

使用 IronPDF，您可以通过指定缩放因子来调整缩放级别，从而控制 PDF 中内容的大小，以匹配您想要的布局和演示。

IronPDF 中的 Chrome 默认渲染功能是什么？

IronPDF 中的 Chrome 默认渲染模拟 Googe Chrome 打印预览中的网页外观，使用响应式 CSS 将内容适合到指定的纸张尺寸。

生成 PDF 时，响应式 CSS 渲染如何工作？

IronPDF 中的响应式 CSS 渲染让您可以指定视口宽度，将 HTML 内容缩放以适应纸张尺寸。默认情况下，视口宽度设定为 1280 像素，确保内容能很好地适应 PDF 尺寸。

我可以使用缩放渲染进行自定义缩放调整吗？

是的，IronPDF 中的缩放渲染允许开发人员通过指定百分比来调整缩放级别，从而精确控制 PDF 中网页内容的缩放。

PDF 生成中“适合页面”渲染的好处是什么？

IronPDF 中的“适合页面”渲染将内容缩放以适应所选纸张尺寸，确保维持最小像素宽度，这对于实现适当的显示和布局一致性至关重要。

连续送纸渲染与其他渲染模式有何不同？

IronPDF 中的连续送纸渲染创建一个单页 PDF，容纳整个内容的宽度和高度，使其适用于像消费者账单或收据这样需要全页内容的文件。

IronPDF 是否完全兼容 .NET 10，特别是视口和缩放控件方面？

是的——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 对物联网 (IoT) 有浓厚的兴趣，探索将硬件和软件集成的新方法。在空闲时间，他喜欢玩游戏和构建 Discord 机器人，将他对技术的热爱与创造力相结合。

准备开始了吗？
Nuget 下载 16,154,058 | 版本: 2025.11 刚刚发布