如何使用 WaitFor 類別延遲 C# PDF 渲染

Translated

View the article in English

在渲染 PDF 文件時，一個常見的問題是渲染過程在所有必要的資產和 JavaScript 動畫加載完成之前就發生了。這可能導致PDF文件的渲染不完整或不正確。最初，我們通過允許用戶設置任意延遲來解決這個問題。然而，依賴於隨機的延遲並不是一個可靠或有效的方法。

為了提供更穩固的解決方案，我們實施了一個WaitFor類別，以增強PDF渲染過程。 RenderOptions 中的 WaitFor 物件提供了數個選項，包括：

PageLoad：預設渲染無需等待。
渲染延遲設定任意等待時間。
字體等待所有字體加載完成。
JavaScript使用 JavaScript 函數觸發渲染。
HTML 元素等待特定的 HTML 元素，例如元素 ID、名稱、標籤名稱和查詢選擇器來定位元素。
網路閒置: 等待網絡閒置 (0、2 或自訂数量).
這些功能可用於轉換使用 IronPDF 將 HTML 字串轉換為 PDF, 使用 IronPDF 將 HTML 檔案轉換為 PDF，和使用 IronPDF 將網頁 URL 轉換成 PDF. 讓我們探索這個新功能的關鍵方面。
如何在 C# 中使用 WaitFor 延遲 PDF 渲染
1. 下載 C# IronPDF 庫來延遲 PDF 渲染
2. 從 HTML 字串、檔案或網頁 URL 生成 PDF 文件
3. 利用 JavaScript 的 WaitFor 方法從 JavaScript 函數觸發渲染
4. 根據網路活動的數量延遲渲染
5. 等待特定的HTML元素以及加載所有字體

開始使用 IronPDF

立即在您的專案中使用IronPDF，並享受免費試用。

第一步：

預設即時渲染範例

預設情況下，渲染過程會在頁面加載完成後立即發生。如果您想要正常渲染，則不需要調用 PageLoad 方法。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-pageload.cs

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>");

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

自定義渲染延遲示例

在需要在渲染PDF之前特定延遲的情況下，您可以設置任意毫秒數作為延遲。這提供了靈活性，以滿足任何特定的時間要求。

此選項的工作方式與使用 RenderingOptions.RenderDelay 屬性的舊實現相同。然而，舊的屬性已被棄用，強烈建議使用新的 API，RenderingOptions.WaitFor.RenderDelay。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-delay-time.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();

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

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

Imports IronPdf

Private renderer As New ChromePdfRenderer()

' Render after 3000ms
renderer.RenderingOptions.WaitFor.RenderDelay(3000)

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

VB C#

加載所有字體示例

這 所有字體已載入 方法在等待 class 允許 PDF 渲染過程暫停，直到從 Google Fonts 或其他服務器加載所有字體。這確保最終的PDF包含了所有必需的字體，保留了文件預期的排版和視覺外觀。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-all-fonts.cs

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);

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

自訂 JavaScript 執行範例

為了更精確地控制渲染過程，我們的功能允許您指定一個自定義的JavaScript函數，在渲染PDF文件之前執行。這使您能夠在啟動渲染過程之前執行任何必要的任務或檢查。這讓用戶可以控制何時觸發渲染。

在 JavaScript 中，函數 window.ironpdf.notifyRender()用於觸發渲染任務。一旦notifyRender`()是呼叫時，渲染過程將開始。你可以完全控制何時調用該函數。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-javascript.cs

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);

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

HTML 元素範例

使用此選項，渲染過程可以設定為等待特定的HTML元素，例如元素ID、名稱、標籤名稱，甚至使用查詢選擇器來定位元素。

等待元素ID

在下面的程式碼示例中，渲染將等待特定的元素 ID。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-html-element-id.cs

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);

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

等待元素名稱

在下面的代碼示例中，渲染過程將等待特定的元素名稱。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-html-element-name.cs

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(""name"", ""myName"");

        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.HtmlElementByName("myName", 5000);

PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

等待元素標籤名稱

在以下的程式碼範例中，渲染過程將等待特定的元素標籤名稱。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-html-element-tag-name.cs

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);

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

使用查詢選擇器

在下面的代碼示例中，渲染過程將等待由查詢選擇器選定的元素。 HtmlQuerySelector 方法將等待一個帶有 id 為 'myid' 和 class 為 'blablastyle' 的 img 標籤。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-html-element-query-selector.cs

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);

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

網路閒置範例

無網路活動

此類型的網路閒置讓您可以等到沒有網路活動時，這通常表示內容已經完全載入。这适用于单页应用程序。(SPA)或是一個沒有長時間輪詢網絡請求或持續網絡活動的簡單網頁。

渲染過程將僅在至少500毫秒內沒有持續的網絡活動後開始。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-network-idle-0.cs

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>");

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

允許兩個網絡活動

NetworkIdle2方法適用於具有長輪詢網絡請求或心跳ping的網絡應用程序或網頁。通常涉及 1-2 個請求。在這種情況下，即使這些請求正在進行中，也不會被認為是使觸發網絡閒置事件無效，因為最多允許有兩個這樣的請求。

在開始渲染過程之前，至少應有最多兩個網絡活動持續至少500毫秒。此選項提供了快速配置以處理固定數量的網絡活動。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-network-idle-2.cs

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>");

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

自定義網絡活動配額

在涉及多個網絡請求的情況下，您可以自定義網絡閒置時間和允許的網絡請求數量，這些請求不會使網絡閒置事件失效。此選項適用於具有特定需求且不符合前兩種方法的網路應用程式或網頁。透過提供此自定義，我們確保在不同情況下解決了廣泛的使用案例。

:path=/static-assets/pdf/content-code-examples/how-to/waitfor-customize-network.cs

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>");

Imports IronPdf

Private renderer As New ChromePdfRenderer()

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

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

VB C#

設定最大等待時間

此外，JavaScript、NetworkIdle、NetworkIdle0 和 NetworkIdle2 方法也允許您設定最大等待時間，以確保等待不會無限期。這些方法的 maxWaitTime 參數可用於此目的。

請注意

所有指定的時間值均以毫秒為單位考量。

查克尼思·賓

軟體工程師

Chaknith 是開發者界的夏洛克福爾摩斯。他第一次意識到自己可能有個軟體工程的未來，是在他為了娛樂而參加程式挑戰的時候。他的重點是 IronXL 和 IronBarcode，但他也引以為豪的是，他幫助客戶解決所有產品的問題。Chaknith 利用他與客戶直接對話中獲得的知識，以進一步改進產品。他的實際反饋超越了 Jira 工單，並支持產品開發、文件撰寫和行銷，以提升客戶的整體體驗。不在公司時，他通常在學習機器學習、寫程式和徒步旅行。

準備開始了嗎？版本: 2025.2 剛剛發布

查看許可證 >

如何使用 WaitFor 類別延遲 C# PDF 渲染

如何在 C# 中使用 WaitFor 延遲 PDF 渲染

開始使用 IronPDF

預設即時渲染範例

自定義渲染延遲示例

加載所有字體示例

自訂 JavaScript 執行範例

HTML 元素範例

等待元素ID

等待元素名稱

等待元素標籤名稱

使用查詢選擇器

網路閒置範例

無網路活動

允許兩個網絡活動

自定義網絡活動配額

設定最大等待時間

請注意

查克尼思·賓

軟體工程師

準備開始了嗎？版本: 2025.2 剛剛發布

在實際環境中測試

全功能產品

24/5技術支援

獲取你的免費 30天試用序號立即。

試用表格已提交
成功地.

受到全球數百萬工程師的信任

在實際環境中測試

全功能產品

24/5技術支援

獲取你的免費 30天試用序號立即。

受到全球數百萬工程師的信任

IronPDF 是 IRON 的一部分套件

如何使用 WaitFor 類別延遲 C# PDF 渲染

如何在 C# 中使用 WaitFor 延遲 PDF 渲染

開始使用 IronPDF

預設即時渲染範例

自定義渲染延遲示例

加載所有字體示例

自訂 JavaScript 執行範例

HTML 元素範例

等待元素ID

等待元素名稱

等待元素標籤名稱

使用查詢選擇器

網路閒置範例

無網路活動

允許兩個網絡活動

自定義網絡活動配額

設定最大等待時間

請注意

查克尼思·賓

軟體工程師

準備開始了嗎？ 版本: 2025.2 剛剛發布

現在您已使用 NuGet 安裝

您的瀏覽器正在下載 IronPDF

下一步：開始免費 30 天試用

試用表格已提交成功地.

現在您已使用 NuGet 安裝

您的瀏覽器正在下載 IronPDF

下一步：開始免費 30 天試用

在實際環境中測試

全功能產品

24/5技術支援

獲取你的免費 30天試用序號 立即。

試用表格已提交成功地.

受到全球數百萬工程師的信任

在實際環境中測試

全功能產品

24/5技術支援

獲取你的免費 30天試用序號 立即。

受到全球數百萬工程師的信任

IronPDF 是 IRON 的一部分套件

準備開始了嗎？版本: 2025.2 剛剛發布

試用表格已提交
成功地.

獲取你的免費 30天試用序號立即。

試用表格已提交
成功地.

獲取你的免費 30天試用序號立即。