1. IronPDF
  2. Poradniki
  3. Wykorzystaj WaitFor do opóźnienia renderowania PDF
Jak używać WaitFor do opóźniania renderowania PDF w C#

Using the C# WaitFor Class to Delay PDF Rendering

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

Klasa C# WaitFor w IronPDF pomaga programistom opóźnić renderowanie plików PDF do momentu załadowania wszystkich zasobów, czcionek i kodu JavaScript, zapobiegając niekompletnemu renderowaniu za pomocą metod takich jak RenderDelay, NetworkIdle oraz wyzwalaczy JavaScript.

Szybki start: Wykorzystanie WaitFor do poprawy renderowania plików PDF

Funkcja WaitFor firmy IronPDF pozwala programistom poprawić renderowanie plików PDF poprzez zarządzanie synchronizacją asynchroniczną. Ustawiając opcje takie jak RenderDelay, można zapewnić, że wszystkie zasoby i skrypty zostaną załadowane przed konwersją, zapobiegając powstawaniu niekompletnych dokumentów PDF. Ten przewodnik pokazuje, jak wdrożyć WaitFor w swoich projektach w celu uzyskania precyzyjnego i wydajnego renderowania.

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

Minimalny przebieg pracy (5 kroków)

  1. Pobierz bibliotekę C# IronPDF, aby opóźnić renderowanie plików PDF
  2. Generowanie dokumentu PDF na podstawie ciągu znaków HTML, pliku lub adresu URL
  3. Należy użyć metody JavaScript WaitFor , aby uruchomić renderowanie z funkcji JavaScript
  4. Opóźnij renderowanie w oparciu o liczbę aktywności sieciowych
  5. Poczekaj na załadowanie określonych elementów HTML oraz wszystkich czcionek

Czym jest klasa WaitFor i jakie są jej opcje?

Aby renderować pliki PDF z optymalną wydajnością, klasa WaitFor usprawnia proces renderowania PDF. Obiekt WaitFor z RenderOptions oferuje kilka opcji:

  • PageLoad: Domyślne renderowanie bez oczekiwania.
  • RenderDelay: Ustawia dowolny czas oczekiwania.
  • Fonts: Czeka, aż wszystkie czcionki się załadują.
  • JavaScript: Uruchamia renderowanie za pomocą funkcji JavaScript.
  • HTML elements: Czeka na określone elementy HTML, takie jak identyfikatory elementów, nazwy, nazwy tagów i selektory zapytań, aby wskazać elementy docelowe.
  • NetworkIdle: Czeka na bezczynność sieci (0, 2 lub niestandardowy czas).

Funkcje te działają podczas konwersji ciągów HTML do formatu PDF za pomocą IronPDF, plików HTML do formatu PDF za pomocą IronPDF oraz adresów URL do formatu PDF za pomocą IronPDF.

Jak natychmiast renderować pliki PDF bez czekania?

Domyślnie renderowanie następuje natychmiast po zakończeniu ładowania strony. Metoda `` nie musi być wywoływana w przypadku normalnego renderowania. Takie podejście sprawdza się dobrze w przypadku prostych treści HTML bez skomplikowanego kodu JavaScript lub zasobów zewnętrznych.

: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

Jak mogę dodać niestandardowe opóźnienie przed renderowaniem pliku PDF?

Jeśli przed wyrenderowaniem pliku PDF wymagane jest określone opóźnienie, można ustawić dowolną liczbę milisekund jako opóźnienie. Zapewnia to elastyczność w przypadku konkretnych wymagań czasowych, zwłaszcza w przypadku treści zawierających dużo kodu JavaScript.

Ta opcja działa tak samo jak stara implementacja wykorzystująca właściwość . Jednak ta stara właściwość została wycofana. Użyj nowego 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

Mechanizm opóźnienia jest przydatny, gdy kod HTML zawiera animacje, treści ładowane w tle lub wymaga czasu na dynamiczne generowanie treści. W przypadku złożonych scenariuszy renderowania warto zapoznać się z opcjami renderowania niestandardowego.

Jak poczekać na załadowanie wszystkich czcionek przed renderowaniem?

Metoda w klasie wstrzymuje renderowanie pliku PDF do momentu załadowania wszystkich czcionek z zewnętrznych źródeł, takich jak Google Fonts. Dzięki temu ostateczny plik PDF zawiera wszystkie wymagane czcionki, zachowując zamierzoną typografię i wygląd dokumentu. Ta funkcja zapewnia profesjonalną jakość plików 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

Aby uzyskać więcej informacji na temat zarządzania czcionkami w plikach PDF, w tym opcji osadzania i tworzenia podzbiorów, zapoznaj się z przewodnikiem dotyczącym zarządzania czcionkami w plikach PDF.

Jak uruchomić renderowanie pliku PDF za pomocą niestandardowego kodu JavaScript?

Aby uzyskać większą kontrolę nad procesem renderowania, można określić niestandardową funkcję JavaScript, która zostanie wykonana przed renderowaniem dokumentu PDF. Umożliwia to wykonanie niezbędnych zadań lub kontroli przed rozpoczęciem procesu renderowania, dając Ci kontrolę nad tym, kiedy uruchomić renderowanie.

W JavaScript funkcja uruchamia zadanie renderowania. Po wywołaniu rozpoczyna się proces renderowania. To Ty decydujesz, kiedy wywołać tę funkcję.

: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

Takie podejście jest skuteczne w połączeniu z żądaniami AJAX lub gdy zapewnia się, że dynamicznie generowana treść w pełni się załaduje przed renderowaniem. W przypadku zaawansowanych scenariuszy JavaScript zapoznaj się z przewodnikiem dotyczącym wykonywania niestandardowego kodu JavaScript w plikach PDF.

Jak mogę poczekać na określone elementy HTML przed renderowaniem?

W tej opcji proces renderowania oczekuje na określone elementy HTML, takie jak identyfikatory elementów, nazwy, nazwy tagów i selektory zapytań, aby wskazać elementy docelowe. Ta funkcja jest pomocna podczas pracy z aplikacjami jednostronicowymi (SPA) lub treściami ładowanymi asynchronicznie.

Jak czekać na element według identyfikatora?

W poniższym przykładzie kodu renderowanie oczekuje na konkretny identyfikator elementu.

: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

Jak czekać na element według atrybutu nazwy?

W poniższym przykładzie kodu proces renderowania oczekuje na nazwę konkretnego elementu.

: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

Jak czekać na elementy według nazwy tagu?

W poniższym przykładzie kodu proces renderowania oczekuje na nazwę konkretnego elementu.

: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

Jak używać selektorów zapytań do oczekiwania na elementy?

Proces renderowania oczekuje na element wybrany przez selektor zapytania w poniższym przykładzie kodu. Metoda oczekuje na tag o id "myid" i klasie "blablastyle".

: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

Jak poczekać na zakończenie aktywności sieciowej?

Podczas renderowania stron internetowych, które wysyłają żądania sieciowe dotyczące zasobów, danych lub wywołań API, upewnij się, że cała aktywność sieciowa została zakończona przed wygenerowaniem pliku PDF. IronPDF oferuje kilka metod obsługi różnych scenariuszy sieciowych.

Kiedy należy czekać na zerową aktywność sieciową?

Ten rodzaj bezczynności sieciowej polega na oczekiwaniu, aż nie będzie żadnej aktywności sieciowej, co zazwyczaj oznacza, że treść została w pełni załadowana. Rozwiązanie to nadaje się do aplikacji jednostronicowych (SPA) lub prostych stron internetowych bez żądań sieciowych typu long-polling lub ciągłej aktywności sieciowej.

Proces renderowania rozpoczyna się, gdy przez co najmniej 500 ms nie odnotowano żadnej aktywności sieciowej.

: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

Kiedy należy zezwolić na dwie operacje sieciowe?

Metoda `` nadaje się do aplikacji internetowych lub stron internetowych z żądaniami sieciowymi typu long-polling lub pingami typu heartbeat. Zazwyczaj dotyczy to 1–2 zleceń. Nawet jeśli te żądania są w toku, nie unieważniają one wyzwolenia zdarzenia bezczynności sieci, ponieważ dopuszczalne jest maksymalnie dwa.

Przed rozpoczęciem procesu renderowania powinno pozostać co najwyżej dwa zdarzenia sieciowe trwające co najmniej 500 ms. Ta opcja zapewnia szybką konfigurację do obsługi stałej liczby operacji sieciowych.

: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

Jak dostosować progi aktywności sieciowej?

W przypadku wielu żądań sieciowych można dostosować zarówno czas bezczynności sieci, jak i liczbę dozwolonych żądań sieciowych, które nie powodują unieważnienia zdarzenia bezczynności sieci. Ta opcja jest odpowiednia dla aplikacji internetowych lub stron internetowych o specyficznych wymaganiach, które nie pasują do dwóch poprzednich metod. To dostosowanie obejmuje szeroki zakres zastosowań w różnych okolicznościach.

: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

Ten poziom dostosowania jest cenny podczas pracy ze złożonymi aplikacjami internetowymi, które utrzymują stałe połączenia lub charakteryzują się przewidywalnymi wzorcami aktywności sieciowej w tle.

Jak ustawić maksymalny czas oczekiwania?

,, oraz pozwalają ustawić maksymalny czas oczekiwania, aby zapewnić, że oczekiwanie nie będzie trwało w nieskończoność. Służy do tego parametr `` tych metod. Zapobiega to zawieszaniu się aplikacji na czas nieokreślony, jeśli oczekiwane warunki nigdy nie wystąpią.

Wszystkie podane wartości czasu są podane w milisekundach.

Wdrażając te strategie oczekiwania, należy zachować równowagę między zapewnieniem pełnego załadowania treści a utrzymaniem rozsądnej wydajności. W przypadku aplikacji wymagających precyzyjnej kontroli czasu warto zapoznać się z technikami asynchronicznego generowania plików PDF.

Chcesz zobaczyć, co jeszcze możesz zrobić? Zapoznaj się z samouczkiem tutaj: Dodatkowe funkcje lub dowiedz się więcej o tworzeniu plików PDF za pomocą IronPDF, aby poznać bardziej zaawansowane techniki.

Często Zadawane Pytania

Czym jest klasa WaitFor i dlaczego warto ją użyć?

Klasa WaitFor w IronPDF pozwala programistom opóźniać renderowanie PDF do momentu zakończenia ładowania wszystkich zasobów, czcionek i JavaScript. Zapobiega to niekompletnym renderom i zapewnia, że złożone strony webowe są w pełni załadowane przed konwersją na PDF, co skutkuje bardziej dokładnymi i kompletnymi dokumentami PDF.

Jakie są dostępne opcje WaitFor?

Klasa WaitFor IronPDF oferuje kilka opcji: PageLoad (domyślne natychmiastowe renderowanie), RenderDelay (niestandardowe opóźnienie w milisekundach), Fonts (czeka na załadowanie wszystkich czcionek), JavaScript (wyzwala renderowanie za pomocą funkcji JavaScript), elementy HTML (czeka na specyficzne elementy według ID, nazwy, tagu lub selektóra zapytania) i NetworkIdle (czeka aż aktywność sieciowa ustanie).

Jak dodać niestandardowe opóźnienie przed renderowaniem PDF?

Możesz dodać niestandardowe opóźnienie, używając metody RenderDelay w IronPDF. Wystarczy określić opóźnienie w milisekundach: `new ChromePdfRenderer { RenderingOptions = { WaitFor = WaitFor.RenderDelay(3000) } }`. Jest to szczególnie przydatne dla treści z dużą ilością JavaScript, które wymagają dodatkowego czasu na wykonanie.

Czy mogę poczekać na załadowanie specyficznych elementów HTML przed renderowaniem?

Tak, IronPDF pozwala na czekanie na specyficzne elementy HTML przy użyciu ID elementów, nazw, nazw tagów lub selektorów zapytania. Zapewnia to, że istotna treść jest obecna na stronie przed rozpoczęciem konwersji do PDF, zapobiegając brakującym elementom w końcowym dokumencie PDF.

Czym jest NetworkIdle i kiedy go użyć?

NetworkIdle w IronPDF czeka na ustanie aktywności sieciowej przed renderowaniem PDF. Można go ustawić, aby czekał na 0, 2 lub dowolną liczbę połączeń sieciowych. Jest idealny dla stron, które ładują zawartość dynamicznie za pośrednictwem wywołań AJAX lub innych asynchronicznych żądań sieciowych.

Jak mogę wyzwolić renderowanie PDF z JavaScript?

Opcja WaitFor JavaScript w IronPDF pozwala na wyzwolenie procesu renderowania z funkcji JavaScript. Daje to pełną kontrolę nad momentem generacji PDF, co jest idealne dla aplikacji jednostronicowych lub złożonych stron z napędem JavaScript, gdzie potrzebna jest precyzyjna kontrola czasowa.

Curtis Chau
Curtis Chau
  Czat z zespołem inżynierów teraz
Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podrę...

Czytaj więcej
Gotowy, aby rozpocząć?
Nuget Pliki do pobrania 18,926,724 | Wersja: 2026.5 just released
Still Scrolling Icon

Wciąż przewijasz?

Czy chcesz szybko dowodu? PM > Install-Package IronPdf
Uruchom przykład i zobacz, jak Twój kod HTML zamienia się w plik PDF.