IRONSOFTWAREHOME
IRONSUITE所有10的价格为2
联系销售
按公司
加入我们的专家网络

Using the C# WaitFor Class to Delay PDF Rendering

Curtis Chau
Curtis Chau
Updated: 2026年9月5日

IronPDF中的C# NetworkIdle和JavaScript触发器等方法时呈现不完整。

WaitFor来提高PDF渲染@@--AH2EG--@@

IronPDF的WaitFor功能允许开发人员通过管理异步计时来提高PDF渲染效果。 通过设置诸如RenderDelay之类的选项，可以确保在转换之前加载所有资产和脚本，从而防止PDF文档不完整。 本指南展示如何在项目中实现WaitFor以实现精确而高效的渲染。

new IronPdf.ChromePdfRenderer { RenderingOptions = { WaitFor = IronPdf.WaitFor.RenderDelay(3000) } }
    .RenderUrlAsPdf("https://example.com")
    .SaveAs("output.pdf");

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

  1. 下载 C# IronPDF 库以延迟 PDF 渲染。
  2. 从HTML字符串、文件或网页URL生成PDF文档
  3. 使用 WaitFor 的 JavaScript 方法从 JavaScript 函数触发呈现
  4. 根据网络活动的数量来延迟渲染
  5. 等待特定的HTML元素以及所有字体加载

WaitFor类及其选项是什么？

要以最佳性能渲染PDF，WaitFor类改进PDF的渲染过程。 WaitFor对象提供了多个选项：

  • PageLoad：默认渲染，无需等待。
  • RenderDelay：设置任意等待时间。
  • Fonts：等待所有字体加载完成。
  • JavaScript：通过JavaScript函数触发渲染。
  • HTML elements：等待特定HTML元素，例如元素ID、名称、标签名和查询选择器以定位元素。
  • NetworkIdle：等待网络空闲（0, 2或自定义数量）。

这些功能在使用 IronPDF 将 HTML 字符串转换为 PDF、使用 IronPDF 将 HTML 文件转换为 PDF 和使用 IronPDF 将 网络 URL 转换为 PDF 时起作用。

如何立即渲染 PDF 而无需等待？

默认情况下，页面加载完成后立即进行渲染。 PageLoad方法不需要为正常渲染调用。 这种方法适用于没有复杂 JavaScript 或外部资源的简单 HTML 内容。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render as soon as the page is loaded
renderer.RenderingOptions.WaitFor.PageLoad();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

如何在 PDF 渲染前添加自定义延迟？

如果在渲染 PDF 之前需要特定的延迟时间，您可以任意设置毫秒数作为延迟时间。 这为特定的时间要求提供了灵活性，尤其是在处理 JavaScript 较多的内容时。

该选项与旧实现中使用RenderingOptions.RenderDelay属性的效果相同。 然而，旧的属性已被弃用。 使用新的API: RenderingOptions.WaitFor.RenderDelay。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render after 3000ms
renderer.RenderingOptions.WaitFor.RenderDelay(3000);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

当您的 HTML 包含动画、懒加载内容或动态内容生成需要时间时，延迟机制就会非常有用。 对于复杂的渲染场景，请探索 自定义渲染选项。

如何在渲染前等待加载所有字体？

AllFontsLoaded方法暂停PDF渲染，直到所有字体从像Google Fonts这样的外部来源加载完成。 这将确保最终的 PDF 包括所有必需的字体，保留文档的预期排版和视觉外观。 此功能可保持专业的 PDF 输出质量。

using IronPdf;

string htmlContent = @"
<!DOCTYPE html>
<html lang=""en"">
<head>
  <meta charset=""UTF-8"">
  <title>Test Registration of Extension</title>
  <!-- for google web fonts -->
  <link rel=""preconnect"" href=""https://fonts.googleapis.com"">
  <link rel=""preconnect"" href=""https://fonts.gstatic.com"" crossorigin>
  <link rel=""stylesheet"" href=""https://fonts.googleapis.com/css2?family=Roboto:wght@400;700&display=swap"" >

  <style>
  /* for remote fonts */
  @font-face {
    font-family: 'CustomFont';
    src: url('https://stage.gradfinale.co.uk/tcpdf/fonts/avgr65wttf.ttf');
  }
  p#p1 { font-family: CustomFont, sans-serif; }

  /* for local fonts */
  @font-face {
    font-family: 'LocalCustomFont';
    src: local('Arial');
  }
  p#p3 { font-family: LocalCustomFont, sans-serif; }
  </style>
</head>
<body>
	<h1>This is Delayed Render Test!</h1>
	<p style=""font-family: Roboto, monospace;"">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla scelerisque ligula venenatis erat <strong>scelerisque</strong> auctor.</p>
	<p id=""p1"">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla scelerisque ligula venenatis erat <strong>scelerisque</strong> auctor.</p>
	<p id=""p3"">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla scelerisque ligula venenatis erat <strong>scelerisque</strong> auctor.</p>
</body>
</html>)";

ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.WaitFor.AllFontsLoaded(10000);

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

有关管理 PDF 中字体的更多信息，包括嵌入和子集选项，请查看 managing fonts in PDFs 指南。

如何使用自定义 JavaScript 触发 PDF 渲染？

为了更好地控制渲染过程，您可以指定一个自定义 JavaScript 函数，在渲染 PDF 文档前执行该函数。 这样，您就可以在启动渲染流程之前执行必要的任务或检查，从而控制何时触发渲染。

在JavaScript中，函数window.ironpdf.notifyRender()触发渲染任务。 一旦notifyRender()被调用，渲染过程便开始。 您可以控制何时调用该功能。

using IronPdf;

string html = @"<!DOCTYPE html>
<html>
<body>
<h1>Testing</h1>
<script type='text/javascript'>

// Set delay
setTimeout(function() {
    window.ironpdf.notifyRender();
}, 1000);

</script>
</body>
</html>";

ChromePdfRenderOptions renderingOptions = new ChromePdfRenderOptions();

// Set rendering to wait for the notifyRender function
renderingOptions.WaitFor.JavaScript(5000);

PdfDocument pdf = ChromePdfRenderer.StaticRenderHtmlAsPdf(html, renderingOptions);
JavaScript

在结合 AJAX 请求或确保动态生成的内容在渲染前完全加载时，这种方法非常有效。 有关 JavaScript 的高级应用场景，请参阅在 PDF 中执行自定义 JavaScript 指南。

如何在渲染前等待特定 HTML 元素？

使用该选项时，渲染过程会等待特定的 HTML 元素，如元素 ID、名称、标记名称和查询选择器等目标元素。 该功能有助于处理单页应用程序 (SPA) 或异步加载的内容。

如何通过 ID 等待元素？

在下面的代码示例中，渲染等待特定的元素 ID。

using IronPdf;

string htmlContent = @"
<!DOCTYPE html>
<html lang=""en"">
<head>
  <meta charset=""UTF-8"">
  <title>Delayed render tests</title>
  <script type=""text/javascript"">
	setTimeout(function() {
		var h1Tag = document.createElement(""h1"");
		h1Tag.innerHTML = ""bla bla bla"";
		h1Tag.setAttribute(""id"", ""myid"");

        var block = document.querySelector(""div#x"");
		block.appendChild(h1Tag);
	}, 1000);
  </script>
</head>
<body>
	<h1>This is Delayed Render Test!</h1>
    <div id=""x""></div>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.WaitFor.HtmlElementById("myid", 5000);

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

如何通过名称属性等待元素？

在下面的代码示例中，渲染过程等待特定的元素名称。

using IronPdf;

string htmlContent = @"
<!DOCTYPE html>
<html lang=""en"">
<head>
  <meta charset=""UTF-8"">
  <title>Delayed render tests</title>
  <script type=""text/javascript"">
	setTimeout(function() {
		var h1Tag = document.createElement(""h1"");
		h1Tag.innerHTML = ""bla bla bla"";
		h1Tag.setAttribute(""id"", ""myid"");

        var block = document.querySelector(""div#x"");
		block.appendChild(h1Tag);
	}, 1000);
  </script>
</head>
<body>
	<h1>This is Delayed Render Test!</h1>
    <div id=""x""></div>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.WaitFor.HtmlElementById("myid", 5000);

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

如何通过标签名称查找元素？

在下面的代码示例中，渲染过程等待特定的元素标签名称。

using IronPdf;

string htmlContent = @"
<!DOCTYPE html>
<html lang=""en"">
<head>
  <meta charset=""UTF-8"">
  <title>Delayed render tests</title>
  <script type=""text/javascript"">
	setTimeout(function() {
		var newElem = document.createElement(""h2"");
		newElem.innerHTML = ""bla bla bla"";

        var block = document.querySelector(""div#x"");
		block.appendChild(newElem);
	}, 1000);
  </script>
</head>
<body>
	<h1>This is Delayed Render Test!</h1>
    <div id=""x""></div>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.WaitFor.HtmlElementByTagName("h2", 5000);

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

如何使用查询选择器等待元素？

在下面的代码示例中，渲染过程等待查询选择器选择的元素。 class of 'blablastyle'。

using IronPdf;

string htmlContent = @"
<!DOCTYPE html>
<html lang=""en"">
<head>
  <meta charset=""UTF-8"">
  <title>Test Registration of Extension</title>
  <script type=""text/javascript"">
	setTimeout(function() {
		var img = document.createElement(""img"");
		img.onload = function() {
			img.setAttribute(""id"", ""myid"");
			img.setAttribute(""class"", ""blablastyle"");
			var block = document.getElementById(""x"");
			block.appendChild(img);
		};
		img.src = ""https://www.w3schools.com/images/picture.jpg"";	// .src after .onload to ignore cached, if any
	}, 1000);
  </script>
</head>
<body>
	<h1>This is Delayed Render Test!</h1>
    <div id=""x""></div>
</body>
</html>";

ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("img#myid.blablastyle", 5000);

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

我最喜欢的这种库是 IronPDF。它允许快速高效地操作 PDF 文件。它还具有许多有价值的功能，比如导出为 PDF/A 格式和数字签名 PDF 文档。

Milan Jovanovic

微软MVP

查看案例研究

IronOCR 意味着我们每年可以节省 $40,000 的人工处理成本，同时提高生产力，并释放资源用于高影响任务。我强烈推荐它。

Brent Matzelle

首席技术官，OPYN

查看案例研究

Iron Suite 在我们的运营中起着至关重要的作用。这些工具提高了业务各方面的效率，包括创建平面图和改善库存管理。

David Jones

首席软件工程师，Agorus Build

查看案例研究

如何等待网络活动完成？

在呈现对资源、数据或 API 调用进行网络请求的网页时，应确保在生成 PDF 之前完成所有网络活动。 IronPDF 提供了多种方法来处理不同的网络场景。

何时才能实现零网络活动？

这种类型的网络空闲会一直等到没有网络活动，通常表示内容已完全加载。 这适合单页面应用程序 (SPA) 或没有长时间网络请求或持续网络活动的简单网页。

一旦至少 500 毫秒内没有持续的网络活动，渲染过程就会开始。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render unless there has been no network activity for at least 500ms
renderer.RenderingOptions.WaitFor.NetworkIdle0();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

何时允许两个网络活动？

NetworkIdle2方法适用于网络请求长轮询或者带有心跳ping的Web应用程序或网页。 通常情况下，需要提交 1-2 份请求。 即使这些请求是持续性的，也不会导致网络空闲事件的触发无效，因为最多有两个请求是可以接受的。

在启动渲染过程之前，应当最多只有两个网络活动在至少 500 毫秒内。 该选项可为处理固定数量的网络活动提供快速配置。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render unless there are at most 2 network activities for at least 500ms
renderer.RenderingOptions.WaitFor.NetworkIdle2();

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

如何自定义网络活动阈值？

当涉及多个网络请求时，您可以自定义网络空闲持续时间和不导致网络空闲事件失效的允许网络请求数。 此方案适用于不符合前两种方法的有特殊要求的网络应用程序或网页。 这种定制可以解决不同情况下的各种用例。

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render unless there are at most 5 network activities for at least 1000ms
renderer.RenderingOptions.WaitFor.NetworkIdle(1000, 5);

PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

在处理复杂的网络应用程序（需要保持持久连接或具有可预测的后台网络活动模式）时，这种定制水平非常有价值。

如何设置最长等待时间？

maxWaitTime参数为此目的而设。 这可以防止您的应用程序在预期条件从未出现的情况下无限期挂起。

所有指定的时间值均以毫秒为单位。

在实施这些等待策略时，应在确保完整加载内容和保持合理性能之间取得平衡。 对于需要精确时序控制的应用，请探索 async PDF 生成技术。

准备好看看您还能做些什么吗？ 点击此处查看教程页面：Additional Features 或探索 creating PDFs with IronPDF 了解更多高级技术。

常见问题解答

什么是 WaitFor 类，为什么要使用它？

IronPDF 中的 WaitFor 类允许开发人员延迟 PDF 渲染，直到所有资产、字体和 JavaScript 加载完毕。这可以防止不完整的渲染，并确保复杂的网页在转换为 PDF 之前已完全加载，从而生成更准确、更完整的 PDF 文档。

有哪些不同的 WaitFor 选项？

IronPDF 的 WaitFor 类提供了多个选项：PageLoad（默认立即渲染）、RenderDelay（以毫秒为单位的自定义延迟）、Fonts（等待所有字体加载）、JavaScript（通过 JavaScript 函数触发渲染）、HTML 元素（通过 ID、名称、标签或查询选择器等待特定元素）和 NetworkIdle（等待网络活动停止）。

如何在 PDF 渲染前添加自定义延迟？

您可以使用 IronPDF 中的 RenderDelay 方法添加自定义延迟。只需以毫秒为单位指定延迟时间即可：`new ChromePdfRenderer { RenderingOptions = { WaitFor = WaitFor.RenderDelay(3000) }。}`.这对于需要额外时间来执行的 JavaScript 内容尤其有用。

我能否等待特定 HTML 元素加载后再进行渲染？

是的，IronPDF 允许您使用元素 ID、名称、标签名称或查询选择器来等待特定的 HTML 元素。这可确保在 PDF 转换开始之前页面上存在关键内容，从而避免在最终 PDF 文档中丢失元素。

NetworkIdle 是什么，何时使用？

IronPDF 中的 NetworkIdle 会等待网络活动停止后再渲染 PDF。您可以将其设置为等待 0、2 或自定义数量的网络连接。这非常适合通过 AJAX 调用或其他异步网络请求动态加载内容的页面。

如何从 JavaScript 触发 PDF 渲染？

IronPDF 的 WaitFor JavaScript 选项允许您从 JavaScript 函数触发渲染过程。这让您可以完全控制 PDF 生成的时间，非常适合需要精确控制时间的单页应用程序或复杂的 JavaScript 驱动型网站。

How can I set a maximum waiting time for rendering a PDF in IronPDF?

You can set a maximum waiting time when using methods like `JavaScript`, `NetworkIdle`, `NetworkIdle0`, and `NetworkIdle2` in IronPDF. This prevents indefinite waiting by specifying a maximum duration to wait for conditions to be met.

Is it possible to customize network activity thresholds in IronPDF?

Yes, IronPDF allows you to customize the number of allowable network activities and the duration before considering the network idle. This flexibility is particularly useful for handling complex web applications with persistent network connections.

What happens when using the default `PageLoad` method in IronPDF?

The `PageLoad` method in IronPDF initiates rendering immediately after the HTML page finishes loading, without any delays. This approach is best for simple HTML content without additional asynchronous resources.

How does IronPDF handle PDF rendering for JavaScript-heavy content?

For JavaScript-heavy content, IronPDF allows setting explicit delays and waiting for specific JavaScript events to ensure all scripts and dynamic elements are fully processed and available before rendering the PDF.

Curtis Chau
Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位，专注于前端开发，精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面，喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...
阅读更多

准备开始了吗？

Nuget Downloads 21,105,021版本:2026.9刚刚发布

免费 NuGet 下载
总下载量：21,105,021

免费获取

30天试用密钥 即刻获取。

bullet_checked无需信用卡或创建账户
bullet_test在生产环境中测试
且无水印
bullet_calendar30天完全
功能性产品
bullet_support试用期间提供
24/5技术支持
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中，右键点击引用，管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中，右键点击引用。选择浏览，“IronPDF.dll”

$999 起

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

OR
bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中，右键点击引用，管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中，右键点击引用。选择浏览，“IronPDF.dll”

$999 起