C# PDF レンダリングを遅延させるための WaitFor の使用方法

Using the C# WaitFor Class to Delay PDF Rendering

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

IronPDFのC# WaitFor クラスは、すべてのアセット、フォント、JavaScriptが読み込まれるまでPDFのレンダリングを遅延させることで、NetworkIdle、およびJavaScriptトリガーなどのメソッドを使用して、不完全なレンダリングを防ぐのに役立ちます。

クイックスタート:WaitFor を使用して PDF のレンダリングを改善する

IronPDFのWaitFor機能を使用すると、開発者は非同期処理のタイミングを管理することで、PDFのレンダリング品質を向上させることができます。 RenderDelay のようなオプションを設定することで、変換前にすべてのアセットとスクリプトが確実に読み込まれるようにし、PDF ドキュメントの不完全な生成を防ぐことができます。 このガイドでは、正確かつ効率的なレンダリングを実現するために、プロジェクトで WaitFor を実装する方法を説明します。

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

WaitFor クラスとそのオプションとは何ですか?

PDFを最適なパフォーマンスでレンダリングするために、WaitForクラスはPDFのレンダリングプロセスを改善します。 WaitFor オブジェクトは RenderOptions から提供され、いくつかのオプションがあります:

  • PageLoad: 待機時間なしのデフォルトのレンダリング。
  • RenderDelay: 任意の待機時間を設定します。
  • Fonts: すべてのフォントが読み込まれるまで待機します。
  • JavaScript: JavaScript関数を使用してレンダリングをトリガーします。
  • HTML elements: 要素ID、名前、タグ名、クエリセレクタなどの特定のHTML要素を待機し、対象となる要素を特定します。
  • NetworkIdle: ネットワークのアイドル状態(0、2、またはカスタム時間)を待機します。

これらの機能は、IronPDF を使用して HTML 文字列を PDF に変換する場合、HTML ファイルを PDF に変換する場合、および Web URL を PDF に変換する場合に利用できます。

待ち時間なしでPDFを即座に表示するにはどうすればよいですか?

デフォルトでは、ページの読み込みが完了するとすぐにレンダリングが行われます。 `` メソッドは、通常のレンダリングでは呼び出す必要はありません。 このアプローチは、複雑な JavaScript や外部リソースを含まないシンプルな HTML コンテンツには適しています。

: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>");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

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

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

PDFのレンダリング前にカスタム遅延を追加するにはどうすればよいですか?

PDFのレンダリング前に特定の遅延が必要な場合、任意のミリ秒数を遅延時間として設定できます。 これにより、特にJavaScriptを多用したコンテンツを扱う場合など、特定のタイミング要件に対して柔軟に対応できます。

このオプションは、プロパティを使用する従来の実装と同様に動作します。 ただし、旧プロパティは非推奨となっています。 新しいAPIを使用してください:

: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>")
$vbLabelText   $csharpLabel

この遅延メカニズムは、HTMLにアニメーションや遅延読み込みコンテンツが含まれている場合、あるいは動的コンテンツの生成に時間を要する場合に役立ちます。 複雑なレンダリングシナリオについては、カスタムレンダリングオプションをご検討ください。

レンダリング前にすべてのフォントが読み込まれるのを待つにはどうすればよいですか?

クラスの メソッドは、Google Fonts などの外部ソースからすべてのフォントが読み込まれるまで、PDF のレンダリングを一時停止します。 これにより、最終的なPDFには必要なフォントがすべて含まれ、ドキュメントの意図したタイポグラフィと視覚的な外観が維持されます。 この機能により、Professional品質の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);
Imports IronPdf

Dim htmlContent As String = "
<!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>"

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.WaitFor.AllFontsLoaded(10000)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
$vbLabelText   $csharpLabel

PDF 内のフォント管理(埋め込みやサブセット化のオプションなど)に関する詳細については、PDF 内のフォント管理に関するガイドをご覧ください。

カスタム JavaScript を使用して PDF レンダリングを実行するにはどうすればよいですか?

レンダリングプロセスをより細かく制御するために、PDFドキュメントのレンダリング前に実行されるカスタムJavaScript関数を指定することができます。 これにより、レンダリング処理を開始する前に必要なタスクやチェックを実行でき、レンダリングを実行するタイミングを制御できるようになります。

JavaScriptでは、関数がレンダリングタスクをトリガーします。 が呼び出されると、レンダリング処理が開始されます。 関数を呼び出すタイミングは、ユーザーが制御します。

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

このアプローチは、AJAXリクエストと組み合わせる場合や、動的に生成されたコンテンツがレンダリング前に完全に読み込まれることを保証する場合に有効です。 高度な JavaScript のシナリオについては、PDF 内でカスタム JavaScript を実行する方法に関するガイドをご覧ください。

レンダリング前に特定のHTML要素を待機させるにはどうすればよいですか?

このオプションでは、レンダリング処理は、要素ID、名前、タグ名、クエリセレクタなどの特定のHTML要素を待機し、それらをターゲット要素として指定します。 この機能は、シングルページアプリケーション(SPA)や非同期で読み込まれるコンテンツを扱う際に役立ちます。

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

Dim htmlContent As String = "
<!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>"

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.WaitFor.HtmlElementById("myid", 5000)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
$vbLabelText   $csharpLabel

名前属性を使用して要素を待機するにはどうすればよいですか?

以下のコード例では、レンダリング処理が特定の要素名を待機しています。

: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);
Imports IronPdf

Dim htmlContent As String = "
<!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>"

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.WaitFor.HtmlElementById("myid", 5000)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
$vbLabelText   $csharpLabel

タグ名で要素を待機するにはどうすればよいですか?

以下のコード例では、レンダリング処理が特定の要素タグ名を待機しています。

: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);
Imports IronPdf

Dim htmlContent As String = "
<!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>"

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.WaitFor.HtmlElementByTagName("h2", 5000)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
$vbLabelText   $csharpLabel

クエリセレクタを使用して要素を待機するにはどうすればよいですか?

レンダリング処理は、以下のコード例にあるクエリセレクタで指定された要素を待機します。 メソッドは、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);
Imports IronPdf

Dim htmlContent As String = "
<!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>"

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.WaitFor.HtmlQuerySelector("img#myid.blablastyle", 5000)

Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)
$vbLabelText   $csharpLabel

ネットワークアクティビティが完了するのを待つにはどうすればよいですか?

リソース、データ、またはAPI呼び出しのためにネットワークリクエストを行うWebページをレンダリングする際は、PDFを生成する前にすべてのネットワーク処理が完了していることを確認してください。 IronPDFは、さまざまなネットワーク環境に対応するための複数の方法を提供しています。

ネットワークアクティビティがゼロになるのを待つべきタイミングはいつですか?

このタイプのネットワークアイドルは、ネットワークアクティビティがなくなるまで待機します。これは通常、コンテンツが完全に読み込まれたことを示しています。 これは、ロングポーリングによるネットワークリクエストや継続的なネットワークアクティビティを伴わない、シングルページアプリケーション(SPA)やシンプルなWebページに適しています。

レンダリング処理は、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>");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

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

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

どのような場合に2つのネットワークアクティビティを許可すべきですか?

`` メソッドは、ロングポーリングによるネットワークリクエストやハートビートピングを行うWebアプリケーションやWebページに適しています。 通常、1~2件のリクエストが含まれます。 これらのリクエストが継続中であっても、最大2つまでであれば許容範囲であるため、ネットワークアイドルイベントの発生が無効になることはありません。

レンダリング処理を開始する前に、ネットワークアクティビティが最大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>");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

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

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

ネットワークアクティビティのしきい値はどのようにカスタマイズしますか?

複数のネットワークリクエストが関与する場合、ネットワークアイドル状態の継続時間と、ネットワークアイドルイベントを無効化しない許容ネットワークリクエスト数の両方をカスタマイズできます。 このオプションは、前述の2つの方法には適合しない、特定の要件を持つWebアプリケーションやWebページに適しています。 このカスタマイズにより、様々な状況下での幅広いユースケースに対応します。

: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>")
$vbLabelText   $csharpLabel

このレベルのカスタマイズは、持続的な接続を維持する、あるいは予測可能なバックグラウンドのネットワーク活動パターンを持つ複雑なWebアプリケーションを扱う際に有用です。

最大待機時間を設定するにはどうすればよいですか?

メソッドを使用すると、待機時間が無期限にならないよう、最大待機時間を設定できます。これらのメソッドの パラメータは、この目的で使用されます。 これにより、想定された条件が決して満たされない場合でも、アプリケーションが無限にハングアップするのを防ぎます。

指定されたすべての時間値はミリ秒単位です。

これらの待機戦略を実装する際は、コンテンツの完全な読み込みを確保することと、適切なパフォーマンスを維持することのバランスをとってください。 正確なタイミング制御が必要なアプリケーションについては、非同期PDF生成の手法を検討してください。

他にもできることを見てみませんか? こちらのチュートリアルページ"追加機能"を確認するか、IronPDF を使用した PDF 作成についてさらに高度なテクニックを探索してください。

よくある質問

WaitForクラスとは何ですか?

IronPDFのWaitForクラスにより、開発者はすべてのアセット、フォント、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駆動のWebサイトに最適です。

カーティス・チャウ
テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT(Internet of Things)への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか?
Nuget ダウンロード 19,014,616 | バージョン: 2026.5 just released
Still Scrolling Icon

まだスクロールしていますか?

すぐに証拠が欲しいですか? PM > Install-Package IronPdf
サンプルを実行するHTML が PDF に変換されるのを確認します。