Verzögern des PDF-Renderings mithilfe der C# WaitFor

Schnellstart: PDF-Rendering mit WaitFor verbessern

WaitFor Funktion von IronPDF ermöglicht es Entwicklern, die PDF-Darstellung durch die Verwaltung asynchroner Zeitabläufe zu verbessern. Durch das Setzen von Optionen wie RenderDelay können Sie sicherstellen, dass alle Assets und Skripte vor der Umwandlung geladen sind, um unvollständige PDF-Dokumente zu vermeiden. Dieser Leitfaden zeigt, wie Sie WaitFor in Ihren Projekten implementieren, um eine präzise und effiziente Darstellung zu erreichen.

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

Was ist die WaitFor Klasse und ihre Optionen?

Für eine optimale Performance beim Rendern von PDFs verbessert die WaitFor Klasse den PDF-Rendering-Prozess. Das WaitFor Objekt von RenderOptions bietet mehrere Optionen:

• PageLoad: Standard-Wiedergabe ohne Warten.
• RenderDelay: Setzt eine beliebige Wartezeit.
• Schriftarten: Wartet, bis alle Schriftarten geladen sind.
• JavaScript: Löst das Rendering mit einer JavaScript-Funktion aus.
• HTML elements: Wartet auf bestimmte HTML-Elemente, wie Element-IDs, Namen, Tag-Namen und Selektoren, um Elemente anzuvisieren.
• NetworkIdle: Wartet auf den Leerlauf des Netzwerks (0, 2 oder ein benutzerdefinierter Wert).

Diese Funktionen funktionieren bei der Konvertierung von HTML-Strings in PDF mit IronPDF, HTML-Dateien in PDF mit IronPDF und Web URLs in PDF mit IronPDF.

Wie kann ich PDFs sofort und ohne Wartezeit rendern?

Standardmäßig erfolgt das Rendering unmittelbar nach Abschluss des Ladevorgangs der Seite. Die Methode PageLoad muss für das normale Rendering nicht aufgerufen werden. Dieser Ansatz eignet sich gut für einfache HTML-Inhalte ohne komplexes JavaScript oder externe Ressourcen.

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

Wie kann ich eine benutzerdefinierte Verzögerung vor dem PDF-Rendering hinzufügen?

Wenn eine bestimmte Verzögerung vor dem Rendern der PDF-Datei erforderlich ist, können Sie eine beliebige Anzahl von Millisekunden als Verzögerung festlegen. Dies bietet Flexibilität für bestimmte zeitliche Anforderungen, insbesondere bei JavaScript-lastigen Inhalten.

Diese Option funktioniert genauso wie die alte Implementierung mit der Eigenschaft RenderingOptions.RenderDelay. Die alte Eigenschaft ist jedoch veraltet. Verwenden Sie die neue 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>");

Der Verzögerungsmechanismus ist nützlich, wenn Ihr HTML Animationen enthält, Inhalte nur langsam geladen werden oder Zeit für die Generierung dynamischer Inhalte benötigt wird. Für komplexe Rendering-Szenarien sollten Sie die Benutzerdefinierte Rendering-Optionen erkunden.

Wie warte ich vor dem Rendern, bis alle Schriftarten geladen sind?

Die Methode AllFontsLoaded in der Klasse WaitFor pausiert die PDF-Wiedergabe, bis alle Schriften aus externen Quellen wie Google Fonts geladen sind. Dadurch wird sichergestellt, dass die endgültige PDF-Datei alle erforderlichen Schriftarten enthält und die beabsichtigte Typografie und das visuelle Erscheinungsbild des Dokuments beibehalten werden. Diese Funktion sorgt für eine professionelle PDF-Ausgabequalität.

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

Weitere Informationen zur Verwaltung von Schriftarten in PDFs, einschließlich Einbettungs- und Untergruppenoptionen, finden Sie im Leitfaden zur Verwaltung von Schriftarten in PDFs.

Wie kann ich das PDF-Rendering mit benutzerdefiniertem JavaScript auslösen?

Um eine bessere Kontrolle über den Rendering-Prozess zu erhalten, können Sie eine benutzerdefinierte JavaScript-Funktion angeben, die vor dem Rendering des PDF-Dokuments ausgeführt wird. Dies ermöglicht es Ihnen, notwendige Aufgaben oder Prüfungen durchzuführen, bevor der Rendering-Prozess gestartet wird, und gibt Ihnen die Kontrolle darüber, wann der Rendering-Prozess ausgelöst wird.

In JavaScript löst die Funktion window.ironPdf.notifyRender() die Rendering-Aufgabe aus. Sobald notifyRender() aufgerufen wird, beginnt der Rendering-Prozess. Sie bestimmen, wann die Funktion aufgerufen werden soll.

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

Dieser Ansatz ist effektiv, wenn er mit AJAX-Anfragen kombiniert wird oder sichergestellt wird, dass dynamisch generierte Inhalte vollständig geladen werden, bevor sie gerendert werden. Für fortgeschrittene JavaScript-Szenarien siehe den Leitfaden zum Ausführen von benutzerdefiniertem JavaScript in PDFs.

Wie kann ich auf bestimmte HTML-Elemente warten, bevor sie gerendert werden?

Bei dieser Option wartet der Rendering-Prozess auf bestimmte HTML-Elemente, wie z. B. Element-IDs, Namen, Tag-Namen und Abfrage-Selektoren für Ziel-Elemente. Diese Funktion ist hilfreich bei der Arbeit mit Single Page Applications (SPAs) oder Inhalten, die asynchron geladen werden.

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

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

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

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

Wie warte ich, bis die Netzwerkaktivität abgeschlossen ist?

Wenn Sie Webseiten rendern, die Netzwerkanfragen für Ressourcen, Daten oder API-Aufrufe stellen, stellen Sie sicher, dass alle Netzwerkaktivitäten abgeschlossen sind, bevor Sie die PDF-Datei generieren. IronPDF bietet mehrere Methoden zur Handhabung verschiedener Netzwerkszenarien.

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

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

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

Wie kann ich eine maximale Wartezeit festlegen?

Die Methoden JavaScript, NetworkIdle, NetworkIdle0 und NetworkIdle2 erlauben es, eine maximale Wartezeit festzulegen, um sicherzustellen, dass die Wartezeit nicht unbegrenzt ist. Der Parameter maxWaitTime dieser Methoden dient diesem Zweck. Dadurch wird verhindert, dass Ihre Anwendung auf unbestimmte Zeit hängen bleibt, wenn die erwarteten Bedingungen nie eintreten.

Alle angegebenen Zeitwerte sind in Millisekunden.

Bei der Umsetzung dieser Wartestrategien muss ein Gleichgewicht zwischen dem vollständigen Laden des Inhalts und der Aufrechterhaltung einer angemessenen Leistung gefunden werden. Für Anwendungen, die eine präzise Zeitsteuerung erfordern, sollten Sie sich über async PDF generation techniques informieren.

Bereit zu sehen, was Sie sonst noch tun können? Sehen Sie sich die Tutorial-Seite hier an: Zusätzliche Funktionen oder erkunden Sie Erstellung von PDFs mit IronPDF für fortgeschrittene Techniken.