Iron Suite for .NET

10 bibliotek .NET. Jeden kompletny pakiet dokumentów.

Odkryj Iron Suite

IRONPDF

IRONWORD

IRONXL

IRONPPT

IRONOCR

IRONBARCODE

IRONQR

IRONPRINT

IRONZIP

IRONWEBSCRAPER

PORÓWNANIE

WebView2 vs IronPDF: Przewodnik porównania technicznego

Curtis Chau

Updated: 21 kwietnia 2026

Gdy programiści .NET muszą przekonwertować zawartość HTML do formatu PDF, kontrolkaWebView2firmy Microsoft czasami wydaje się potencjalnym rozwiązaniem ze względu na silnik renderujący oparty na Chromium. JednakWebView2jest zasadniczo kontrolką osadzającą przeglądarkę, zaprojektowaną dla aplikacji UI, a nie biblioteką do generowania plików PDF. W niniejszym porównaniu technicznym przeanalizowanoWebView2oraz IronPDF, aby pomóc architektom i programistom zrozumieć kluczowe różnice między osadzeniem kontrolki przeglądarki do generowania plików PDF a wykorzystaniem specjalnie zaprojektowanej biblioteki PDF.

Zrozumienie WebView2

WebView2 (Microsoft Edge) to wszechstronny, osadzalny kontrolka przeglądarki, która integruje silnik Edge/Chromium z natywnymi aplikacjami systemu Windows. Ten element sterujący wspiera przeglądanie w przeglądarce Microsoft Edge w ramach ograniczonego ekosystemu, zapewniając zgodność z nowoczesnymi standardami internetowymi w zakresie wyświetlania treści HTML5, CSS3 i JavaScript.

Mozliwosc generowania PDF przezWebView2istnieje poprzez metode PrintToPdfAsync i integracje z DevTools Protocol. Jednak ta funkcjonalność stanowi raczej dodatek niż podstawową funkcję:

Architektura Browser Control: Zaprojektowana do osadzania treści internetowych w aplikacjach UI, a nie do generowania plików PDF po stronie serwera
Platforma wyłącznie dla systemu Windows: brak wsparcia dla systemów Linux, macOS, Docker lub środowisk chmurowych
Wymagania dotyczące wątku interfejsu użytkownika: Musi działać na wątku STA z pompą komunikatów — nie może działać na serwerach internetowych ani w interfejsach API
Zależność środowiska uruchomieniowego Edge: Wymaga zainstalowania środowiska uruchomieniowego EdgeWebView2na komputerach docelowych
Brak trybu bezinterfejsu: zawsze tworzy elementy interfejsu użytkownika, nawet gdy są ukryte

OgraniczeniaWebView2dotyczące generowania plików PDF

Dokumentacja przewodnika migracji wskazuje na krytyczne problemy związane z użyciemWebView2do generowania plików PDF:

Problem	Wpływ	Waga
Wycieki pamięci	WWebView2odnotowano wycieki pamięci w długotrwałych procesach	KLUCZOWE
Tylko dla systemu Windows	Brak obsługi systemów Linux, macOS, Docker lub środowisk chmurowych	KLUCZOWE
Wymagany wątek dotyczący interfejsu użytkownika	Musi działać na wątku STA z pompą komunikatów	KLUCZOWE
Nieprzeznaczone do plików PDF	`PrintToPdfAsync` jest drugoplanowym rozwiazaniem	WYSOKI
Niestabilne w usługach	Awarie i zawieszanie się, typowe dla usług systemu Windows	WYSOKI
Złożony przepływ asynchroniczny	Zdarzenia nawigacyjne, wywołania zwrotne po zakończeniu, warunki wyścigu	WYSOKI
Zależność środowiska uruchomieniowego Edge	Wymaga środowiska uruchomieniowego EdgeWebView2na komputerze docelowym	SREDNI
Brak trybu bezinterfejsowego	Zawsze tworzy elementy interfejsu użytkownika, nawet gdy są ukryte	SREDNI

Zrozumienie IronPDF

IronPDF to specjalnie zaprojektowana biblioteka PDF przeznaczona do generowania plików PDF z treści HTML i internetowych. W przeciwieństwie do podejściaWebView2polegającego na osadzaniu przeglądarki, IronPDF zapewnia dedykowany silnik generowania plików PDF z obsługą wielu platform i możliwościami po stronie serwera.

Kluczowe cechy obejmują:

Biblioteka PDF stworzona specjalnie do tego celu: zaprojektowana od podstaw do generowania plików PDF, a nie do osadzania w interfejsie użytkownika
Obsługa wielu platform: Windows, Linux, macOS, Docker, iOS i Android
Obsługa dowolnych wątków: brak wymagań dotyczących wątków STA lub pompy komunikatów
Gotowość do pracy na serwerze/w chmurze: Obsługa platform ASP.NET Core, Azure, AWS, GCP i Docker
Brak zależności zewnętrznych: Samodzielne rozwiązanie, nie wymaga instalacji środowiska uruchomieniowego
Kompleksowe funkcje PDF: nagłówki/stopki, znaki wodne, scałanie/dzielenie, podpisy cyfrowe, zgodność z PDF/A

Porównanie funkcji

Poniższa tabela przedstawia podstawowe różnice międzyWebView2a IronPDF:

Funkcja	WebView2	IronPDF
Cel	Sterowanie przeglądarką (UI)	Biblioteka PDF (przeznaczona dla formatu PDF)
Gotowe do produkcji	NIE	TAK
Zarządzanie pamięcią	Wycieki w długotrwałych	Stabilny, prawidłowo usunięty
Obsługa platform	Tylko dla systemu Windows	Windows, Linux, macOS, Docker
Wymagania dotyczące wątku	STA + Message Pump	Każdy wątek
Serwer/Chmura	Nieobsługiwane	Obsługiwane
Azure/AWS/GCP	Problematyczne	Działa idealnie
Docker	Niemożliwe	Dostępne są oficjalne zdjęcia
ASP.NET Core	Nie mogę pracować	Wsparcie na najwyższym poziomie
Usługi w tle	Niestabilny	Stabilny
Aplikacje konsolowe	Złożone triki	Tak
WinForms/WPF	Tak	Tak
Nagłówki/stopki	NIE	Tak (HTML)
Znaki wodne	NIE	Tak
Łączenie plików PDF	NIE	Tak
Podział plików PDF	NIE	Tak
Podpisy cyfrowe	NIE	Tak
Ochrona hasłem	NIE	Tak
Zgodność z PDF/A	NIE	Tak
Wypełnianie formularzy	NIE	Tak
Profesjonalne wsparcie	Brak dla plików PDF	Tak
Dokumentacja	Ograniczone dokumenty PDF	Obszerne

Różnice w architekturze API

Różnice architektoniczne międzyWebView2a IronPDF stają się natychmiast widoczne, gdy przyjrzymy się, w jaki sposób każde z tych rozwiązań radzi sobie z generowaniem plików PDF.

Złożony wzorzec asynchroniczny WebView2

WebView2 wymaga wieloetapowego procesu asynchronicznego obejmującego inicjalizację przeglądarki, nawigację, obsługę zdarzeń oraz wywołania protokołu DevTools:

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.Web.WebView2.WinForms;
using Microsoft.Web.WebView2.Core;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        webView.CoreWebView2.NavigateToString("<html><body><h1>Hello World</h1></body></html>");
        await Task.Delay(2000);
        
        await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{}"
        );
    }
}

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.Web.WebView2.WinForms;
using Microsoft.Web.WebView2.Core;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        webView.CoreWebView2.NavigateToString("<html><body><h1>Hello World</h1></body></html>");
        await Task.Delay(2000);
        
        await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{}"
        );
    }
}

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports Microsoft.Web.WebView2.WinForms
Imports Microsoft.Web.WebView2.Core

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()

        webView.CoreWebView2.NavigateToString("<html><body><h1>Hello World</h1></body></html>")
        Await Task.Delay(2000)

        Await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{}"
        )
    End Function
End Module

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports Microsoft.Web.WebView2.WinForms
Imports Microsoft.Web.WebView2.Core

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()

        webView.CoreWebView2.NavigateToString("<html><body><h1>Hello World</h1></body></html>")
        Await Task.Delay(2000)

        Await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{}"
        )
    End Function
End Module

Ten kod demonstruje kilka zlozonosci WebView2: jawna inicjalizacja poprzez EnsureCoreWebView2Async(), nawigacja z wykorzystaniem NavigateToString(), dowolne opoznienia w oczekiwaniu na zaladowanie tresci oraz niskopoziomowe wywolania DevTools Protocol. Task.Delay reprezentuje niesolidne przypuszczenie, kiedy zawartosc jest gotowa—warunki wyscigu czekajace na ujawnienie.

Uproszczone podejście IronPDF

IronPDF eliminuje tę złożoność dzięki prostemu podejściu opartemu na jednej metodzie:

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Hello World</h1></body></html>");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Hello World</h1></body></html>");
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Hello World</h1></body></html>")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<html><body><h1>Hello World</h1></body></html>")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Klasa ChromePdfRenderer wewnętrznie obsługuje wszystkie złożone operacje renderowania. Bez ceremonii inicjalizacji, bez zdarzeń nawigacyjnych, bez zgadywania czasu. Aby uzyskać wyczerpujące wskazówki dotyczące konwersji HTML, zapoznaj się z samouczkiem dotyczącym konwersji HTML do PDF.

Konwersja adresów URL do formatu PDF

Konwersja stron internetowych do dokumentów PDF pokazuje różnicę w złożoności międzyWebView2a IronPDF.

Wdrożenie WebView2

WebView2 wymaga obsługi zdarzeń nawigacyjnych, wywołań zwrotnych po zakończeniu oraz ręcznego wyodrębniania plików PDF:

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.Web.WebView2.WinForms;
using Microsoft.Web.WebView2.Core;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        var tcs = new TaskCompletionSource<bool>();
        webView.CoreWebView2.NavigationCompleted += (s, e) => tcs.SetResult(true);
        
        webView.CoreWebView2.Navigate("https://example.com");
        await tcs.Task;
        await Task.Delay(1000);
        
        var result = await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{\"printBackground\": true}"
        );
        
        var base64 = System.Text.Json.JsonDocument.Parse(result).RootElement.GetProperty("data").GetString();
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64));
    }
}

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.Web.WebView2.WinForms;
using Microsoft.Web.WebView2.Core;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        var tcs = new TaskCompletionSource<bool>();
        webView.CoreWebView2.NavigationCompleted += (s, e) => tcs.SetResult(true);
        
        webView.CoreWebView2.Navigate("https://example.com");
        await tcs.Task;
        await Task.Delay(1000);
        
        var result = await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{\"printBackground\": true}"
        );
        
        var base64 = System.Text.Json.JsonDocument.Parse(result).RootElement.GetProperty("data").GetString();
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64));
    }
}

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports Microsoft.Web.WebView2.WinForms
Imports Microsoft.Web.WebView2.Core

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()

        Dim tcs As New TaskCompletionSource(Of Boolean)()
        AddHandler webView.CoreWebView2.NavigationCompleted, Sub(s, e) tcs.SetResult(True)

        webView.CoreWebView2.Navigate("https://example.com")
        Await tcs.Task
        Await Task.Delay(1000)

        Dim result As String = Await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{""printBackground"": true}"
        )

        Dim base64 As String = System.Text.Json.JsonDocument.Parse(result).RootElement.GetProperty("data").GetString()
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64))
    End Function
End Module

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports Microsoft.Web.WebView2.WinForms
Imports Microsoft.Web.WebView2.Core

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()

        Dim tcs As New TaskCompletionSource(Of Boolean)()
        AddHandler webView.CoreWebView2.NavigationCompleted, Sub(s, e) tcs.SetResult(True)

        webView.CoreWebView2.Navigate("https://example.com")
        Await tcs.Task
        Await Task.Delay(1000)

        Dim result As String = Await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            "{""printBackground"": true}"
        )

        Dim base64 As String = System.Text.Json.JsonDocument.Parse(result).RootElement.GetProperty("data").GetString()
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64))
    End Function
End Module

Ta implementacja wymaga stworzenia TaskCompletionSource do sledzenia nawigacji, subskrypcji wydarzen NavigationCompleted, parsowania odpowiedzi JSON z DevTools Protocol oraz obslugi dekodowania Base64. Dodatkowe Task.Delay(1000) po zakonczeniu nawigacji probuje zapewnic, ze JavaScript zakonczyl dzialanie—kolejny niesolidny trik czasowy.

Wdrożenie IronPDF

IronPDF zapewnia bezpośrednie renderowanie adresów URL za pomocą jednego wywołania metody:

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderUrlAsPdf("https://example.com");
        pdf.SaveAs("output.pdf");
    }
}

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Imports IronPdf

Class Program
    Shared Sub Main()
        Dim renderer = New ChromePdfRenderer()
        Dim pdf = renderer.RenderUrlAsPdf("https://example.com")
        pdf.SaveAs("output.pdf")
    End Sub
End Class

Metoda RenderUrlAsPdf wewnętrznie obsługuje nawigację, wykonywanie kodu JavaScript oraz ładowanie treści. Żadnych subskrypcji zdarzeń, żadnych domysłów dotyczących czasu, żadnego parsowania Base64.

Niestandardowe ustawienia i opcje plików PDF

Konfiguracja wymiarów strony, marginesów i orientacji ujawnia znaczące różnice w użyteczności API.

Konfiguracja protokołuWebView2DevTools

WebView2 wymaga serializacji JSON i parametrów protokołu DevTools:

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using System.Text.Json;
using Microsoft.Web.WebView2.WinForms;
using Microsoft.Web.WebView2.Core;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        var htmlPath = Path.GetFullPath("document.html");
        var tcs = new TaskCompletionSource<bool>();
        webView.CoreWebView2.NavigationCompleted += (s, e) => tcs.SetResult(true);
        
        webView.CoreWebView2.Navigate($"file:///{htmlPath}");
        await tcs.Task;
        await Task.Delay(1000);
        
        var options = new
        {
            landscape = false,
            printBackground = true,
            paperWidth = 8.5,
            paperHeight = 11,
            marginTop = 0.4,
            marginBottom = 0.4,
            marginLeft = 0.4,
            marginRight = 0.4
        };
        
        var result = await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            JsonSerializer.Serialize(options)
        );
        
        var base64 = JsonDocument.Parse(result).RootElement.GetProperty("data").GetString();
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64));
    }
}

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using System.Text.Json;
using Microsoft.Web.WebView2.WinForms;
using Microsoft.Web.WebView2.Core;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        var htmlPath = Path.GetFullPath("document.html");
        var tcs = new TaskCompletionSource<bool>();
        webView.CoreWebView2.NavigationCompleted += (s, e) => tcs.SetResult(true);
        
        webView.CoreWebView2.Navigate($"file:///{htmlPath}");
        await tcs.Task;
        await Task.Delay(1000);
        
        var options = new
        {
            landscape = false,
            printBackground = true,
            paperWidth = 8.5,
            paperHeight = 11,
            marginTop = 0.4,
            marginBottom = 0.4,
            marginLeft = 0.4,
            marginRight = 0.4
        };
        
        var result = await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            JsonSerializer.Serialize(options)
        );
        
        var base64 = JsonDocument.Parse(result).RootElement.GetProperty("data").GetString();
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64));
    }
}

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports System.Text.Json
Imports Microsoft.Web.WebView2.WinForms
Imports Microsoft.Web.WebView2.Core

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()
        
        Dim htmlPath = Path.GetFullPath("document.html")
        Dim tcs As New TaskCompletionSource(Of Boolean)()
        AddHandler webView.CoreWebView2.NavigationCompleted, Sub(s, e) tcs.SetResult(True)
        
        webView.CoreWebView2.Navigate($"file:///{htmlPath}")
        Await tcs.Task
        Await Task.Delay(1000)
        
        Dim options = New With {
            .landscape = False,
            .printBackground = True,
            .paperWidth = 8.5,
            .paperHeight = 11,
            .marginTop = 0.4,
            .marginBottom = 0.4,
            .marginLeft = 0.4,
            .marginRight = 0.4
        }
        
        Dim result = Await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            JsonSerializer.Serialize(options)
        )
        
        Dim base64 = JsonDocument.Parse(result).RootElement.GetProperty("data").GetString()
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64))
    End Function
End Module

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports System.Text.Json
Imports Microsoft.Web.WebView2.WinForms
Imports Microsoft.Web.WebView2.Core

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()
        
        Dim htmlPath = Path.GetFullPath("document.html")
        Dim tcs As New TaskCompletionSource(Of Boolean)()
        AddHandler webView.CoreWebView2.NavigationCompleted, Sub(s, e) tcs.SetResult(True)
        
        webView.CoreWebView2.Navigate($"file:///{htmlPath}")
        Await tcs.Task
        Await Task.Delay(1000)
        
        Dim options = New With {
            .landscape = False,
            .printBackground = True,
            .paperWidth = 8.5,
            .paperHeight = 11,
            .marginTop = 0.4,
            .marginBottom = 0.4,
            .marginLeft = 0.4,
            .marginRight = 0.4
        }
        
        Dim result = Await webView.CoreWebView2.CallDevToolsProtocolMethodAsync(
            "Page.printToPDF",
            JsonSerializer.Serialize(options)
        )
        
        Dim base64 = JsonDocument.Parse(result).RootElement.GetProperty("data").GetString()
        File.WriteAllBytes("output.pdf", Convert.FromBase64String(base64))
    End Function
End Module

WebView2 używa cali jako jednostek wymiarów, wymaga obiektów anonimowych i serializacji JSON oraz obsługuje złożony przepływ asynchroniczny z obsługą zdarzeń i opóźnieniami czasowymi.

Konfiguracja opcji renderowania IronPDF

IronPDF zapewnia silnie typowaną konfigurację poprzez właściwość RenderingOptions:

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.MarginTop = 40;
        renderer.RenderingOptions.MarginBottom = 40;
        renderer.RenderingOptions.MarginLeft = 40;
        renderer.RenderingOptions.MarginRight = 40;
        renderer.RenderingOptions.PrintHtmlBackgrounds = true;
        
        var pdf = renderer.RenderHtmlFileAsPdf("document.html");
        pdf.SaveAs("output.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter;
        renderer.RenderingOptions.MarginTop = 40;
        renderer.RenderingOptions.MarginBottom = 40;
        renderer.RenderingOptions.MarginLeft = 40;
        renderer.RenderingOptions.MarginRight = 40;
        renderer.RenderingOptions.PrintHtmlBackgrounds = true;
        
        var pdf = renderer.RenderHtmlFileAsPdf("document.html");
        pdf.SaveAs("output.pdf");
    }
}

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter
        renderer.RenderingOptions.MarginTop = 40
        renderer.RenderingOptions.MarginBottom = 40
        renderer.RenderingOptions.MarginLeft = 40
        renderer.RenderingOptions.MarginRight = 40
        renderer.RenderingOptions.PrintHtmlBackgrounds = True

        Dim pdf = renderer.RenderHtmlFileAsPdf("document.html")
        pdf.SaveAs("output.pdf")
    End Sub
End Module

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()
        renderer.RenderingOptions.PaperSize = PdfPaperSize.Letter
        renderer.RenderingOptions.MarginTop = 40
        renderer.RenderingOptions.MarginBottom = 40
        renderer.RenderingOptions.MarginLeft = 40
        renderer.RenderingOptions.MarginRight = 40
        renderer.RenderingOptions.PrintHtmlBackgrounds = True

        Dim pdf = renderer.RenderHtmlFileAsPdf("document.html")
        pdf.SaveAs("output.pdf")
    End Sub
End Module

IronPDF uzywa milimetrow do precyzyjnych pomiarow, zapewnia enumy PdfPaperSize dla standardowych rozmiarow papieru oraz oferuje dedykowane metody takie jak RenderHtmlFileAsPdf() dla tresci opartej na plikach.

Plik HTML do PDF z niestandardową orientacją

Konwersja plików HTML w orientacji poziomej ilustruje podejście PrintSettings w porównaniu z RenderingOptions.

PodejścieWebView2PrintSettings

WebView2 oferuje alternatywna metode PrintToPdfAsync z CoreWebView2PrintSettings:

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.Web.WebView2.Core;
using Microsoft.Web.WebView2.WinForms;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        string htmlFile = Path.Combine(Directory.GetCurrentDirectory(), "input.html");
        webView.CoreWebView2.Navigate(htmlFile);
        
        await Task.Delay(3000);
        
        var printSettings = webView.CoreWebView2.Environment.CreatePrintSettings();
        printSettings.Orientation = CoreWebView2PrintOrientation.Landscape;
        printSettings.MarginTop = 0.5;
        printSettings.MarginBottom = 0.5;
        
        using (var stream = await webView.CoreWebView2.PrintToPdfAsync("custom.pdf", printSettings))
        {
            Console.WriteLine("Custom PDF created");
        }
    }
}

// NuGet: Install-Package Microsoft.Web.WebView2.WinForms
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.Web.WebView2.Core;
using Microsoft.Web.WebView2.WinForms;

class Program
{
    static async Task Main()
    {
        var webView = new WebView2();
        await webView.EnsureCoreWebView2Async();
        
        string htmlFile = Path.Combine(Directory.GetCurrentDirectory(), "input.html");
        webView.CoreWebView2.Navigate(htmlFile);
        
        await Task.Delay(3000);
        
        var printSettings = webView.CoreWebView2.Environment.CreatePrintSettings();
        printSettings.Orientation = CoreWebView2PrintOrientation.Landscape;
        printSettings.MarginTop = 0.5;
        printSettings.MarginBottom = 0.5;
        
        using (var stream = await webView.CoreWebView2.PrintToPdfAsync("custom.pdf", printSettings))
        {
            Console.WriteLine("Custom PDF created");
        }
    }
}

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports Microsoft.Web.WebView2.Core
Imports Microsoft.Web.WebView2.WinForms

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()

        Dim htmlFile As String = Path.Combine(Directory.GetCurrentDirectory(), "input.html")
        webView.CoreWebView2.Navigate(htmlFile)

        Await Task.Delay(3000)

        Dim printSettings = webView.CoreWebView2.Environment.CreatePrintSettings()
        printSettings.Orientation = CoreWebView2PrintOrientation.Landscape
        printSettings.MarginTop = 0.5
        printSettings.MarginBottom = 0.5

        Using stream = Await webView.CoreWebView2.PrintToPdfAsync("custom.pdf", printSettings)
            Console.WriteLine("Custom PDF created")
        End Using
    End Function
End Module

' NuGet: Install-Package Microsoft.Web.WebView2.WinForms
Imports System
Imports System.IO
Imports System.Threading.Tasks
Imports Microsoft.Web.WebView2.Core
Imports Microsoft.Web.WebView2.WinForms

Module Program
    Async Function Main() As Task
        Dim webView As New WebView2()
        Await webView.EnsureCoreWebView2Async()

        Dim htmlFile As String = Path.Combine(Directory.GetCurrentDirectory(), "input.html")
        webView.CoreWebView2.Navigate(htmlFile)

        Await Task.Delay(3000)

        Dim printSettings = webView.CoreWebView2.Environment.CreatePrintSettings()
        printSettings.Orientation = CoreWebView2PrintOrientation.Landscape
        printSettings.MarginTop = 0.5
        printSettings.MarginBottom = 0.5

        Using stream = Await webView.CoreWebView2.PrintToPdfAsync("custom.pdf", printSettings)
            Console.WriteLine("Custom PDF created")
        End Using
    End Function
End Module

Zauwaz 3-sekundowe Task.Delay—jeszcze dluzsze dowolne oczekiwanie w probie zapewnienia zaladowania tresci przed drukowaniem.

Uproszczona konfiguracja IronPDF

IronPDF radzi sobie z tym samym zadaniem przy użyciu jasnych ustawień i bez zgadywania co do czasu:

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 50;
        renderer.RenderingOptions.MarginBottom = 50;
        
        string htmlFile = Path.Combine(Directory.GetCurrentDirectory(), "input.html");
        var pdf = renderer.RenderHtmlFileAsPdf(htmlFile);
        pdf.SaveAs("custom.pdf");
        
        Console.WriteLine("Custom PDF created");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Rendering;
using System;
using System.IO;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();
        
        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.MarginTop = 50;
        renderer.RenderingOptions.MarginBottom = 50;
        
        string htmlFile = Path.Combine(Directory.GetCurrentDirectory(), "input.html");
        var pdf = renderer.RenderHtmlFileAsPdf(htmlFile);
        pdf.SaveAs("custom.pdf");
        
        Console.WriteLine("Custom PDF created");
    }
}

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering
Imports System
Imports System.IO

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
        renderer.RenderingOptions.MarginTop = 50
        renderer.RenderingOptions.MarginBottom = 50

        Dim htmlFile As String = Path.Combine(Directory.GetCurrentDirectory(), "input.html")
        Dim pdf = renderer.RenderHtmlFileAsPdf(htmlFile)
        pdf.SaveAs("custom.pdf")

        Console.WriteLine("Custom PDF created")
    End Sub
End Module

' NuGet: Install-Package IronPdf
Imports IronPdf
Imports IronPdf.Rendering
Imports System
Imports System.IO

Module Program
    Sub Main()
        Dim renderer As New ChromePdfRenderer()

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape
        renderer.RenderingOptions.MarginTop = 50
        renderer.RenderingOptions.MarginBottom = 50

        Dim htmlFile As String = Path.Combine(Directory.GetCurrentDirectory(), "input.html")
        Dim pdf = renderer.RenderHtmlFileAsPdf(htmlFile)
        pdf.SaveAs("custom.pdf")

        Console.WriteLine("Custom PDF created")
    End Sub
End Module

Przewodnik po mapowaniu API

Zespoły rozważające przejście zWebView2na IronPDF uznają to mapowanie za pomocne w zrozumieniu równoważności koncepcji:

Interfejs APIWebView2	Odpowiednik IronPDF
`new WebView2()`	`new ChromePdfRenderer()`
`EnsureCoreWebView2Async()`	Nie dotyczy
`NavigateToString(html)` + `PrintToPdfAsync()`	`RenderHtmlAsPdf(html)`
`Navigate(url)` + `PrintToPdfAsync()`	`RenderUrlAsPdf(url)`
`Navigate(file)` + `PrintToPdfAsync()`	`RenderHtmlFileAsPdf(file)`
`PrintSettings.PageWidth`	`RenderingOptions.PaperSize`
`PrintSettings.PageHeight`	`RenderingOptions.PaperSize`
`PrintSettings.MarginTop`	`RenderingOptions.MarginTop`
`PrintSettings.Orientation`	`RenderingOptions.PaperOrientation`
Zdarzenia nawigacyjne	`WaitFor.JavaScript()`
`printBackground: true`	`PrintHtmlBackgrounds = true`

Kiedy zespoły rozważają przejście zWebView2na IronPDF

Istnieje kilka scenariuszy, w których zespoły programistów często rozważająIronPDF jako alternatywę dla WebView2:

Wymagania dotyczące wielopłatformowości

OgraniczenieWebView2do systemu Windows sprawia, że nie nadaje się on do aplikacji przeznaczonych dla serwerów Linux, kontenerów Docker lub środowisk chmurowych. Zespoły wdrażające rozwiązania w Azure, AWS, GCP lub infrastrukturze kontenerowej nie mogą używaćWebView2do generowania plików PDF.

Generowanie plików PDF po stronie serwera

WymaganiaWebView2dotyczące wątku interfejsu użytkownika w połączeniu z STA i pompą komunikatów sprawiają, że jest on zasadniczo niekompatybilny z .NET Core, usługami działającymi w tle lub punktami końcowymi API. Aplikacje wymagające generowania plików PDF w odpowiedzi na żądania internetowe nie mogą korzystać z WebView2.

Obawy dotyczące stabilności pamięci

Udokumentowane wycieki pamięciWebView2w długotrwałych procesach powodują awarie serwerów w środowiskach produkcyjnych. Aplikacje generujące pliki PDF w sposób ciągły przez cały dzień gromadzą pamięć, aż do wystąpienia sytuacji braku pamięci.

Wymagania dotyczące funkcji pliku PDF

WebView2's PrintToPdfAsync zapewnia tylko podstawowa konwersje HTML na PDF. Zespoły wymagające nagłówków/stopek, znaków wodnych, łączenia/dzielenia plików PDF, podpisów cyfrowych, ochrony hasłem lub zgodności z formatem PDF/A muszą poszukać innego rozwiązania.

Uproszczone tworzenie oprogramowania

Złożony przepływ asynchroniczny wymagany przezWebView2— inicjalizacja, zdarzenia nawigacyjne, wywołania zwrotne zakończenia, opóźnienia czasowe, serializacja JSON, dekodowanie Base64 — powoduje znaczne obciążenie związane z programowaniem i utrzymaniem w porównaniu z podejściem opartym na jednej metodzie stosowanym w IronPDF.

Dodatkowe możliwości IronPDF

Oprócz podstawowego generowania plików PDF,IronPDF oferuje funkcje edycji dokumentów, którychWebView2nie jest w stanie zapewnić:

Łączenie plików PDF: Łączenie wielu dokumentów w pojedyncze pliki
Dzielenie dokumentów: Wyodrębnianie zakresów stron do oddzielnych plików PDF
Podpisy cyfrowe: stosowanie podpisów kryptograficznych w celu potwierdzenia autentyczności dokumentów
Znak wodny: Dodaj tekstowe lub graficzne znaki wodne
Zgodność z PDF/A: Generowanie dokumentów zgodnych ze standardami archiwizacji
Wypełnianie formularzy: programowe wypełnianie pól formularzy PDF
Nagłówki i stopki: automatyczna numeracja stron i branding
Ochrona hasłem: Szyfruj pliki PDF za pomocą haseł użytkownika i właściciela
Wdrażanie w Dockerze: Oficjalne obrazy kontenerów do wdrażania w systemie Linux

Zgodność z platformą .NET i gotowość na przyszłość

ArchitekturaWebView2przeznaczona wyłącznie dla systemu Windows ogranicza jego przyszłość w coraz bardziej wielopłatformowym ekosystemie .NET.IronPDF jest aktywnie rozwijany i regularnie aktualizowany, co zapewnia kompatybilność z .NET 8, .NET 9 oraz przyszłymi wersjami, w tym .NET 10, którego premiera przewidziana jest na 2026 rok. Obsługa async/await w całym API biblioteki jest zgodna z nowoczesnymi praktykami programistycznymi w języku C#, w tym z funkcjami przewidzianymi w C# 14.

Wnioski

WebView2 i IronPDF reprezentują zasadniczo różne podejścia do generowania plików PDF w środowisku .NET.WebView2to kontrolka do osadzania przeglądarki, która obsługuje drukowanie plików PDF — jest to funkcja dodatkowa o znacznych ograniczeniach w zastosowaniach produkcyjnych. Ograniczenie platformy wyłącznie do systemu Windows, wymóg wątku interfejsu użytkownika, problemy z wyciekami pamięci oraz brak funkcji specyficznych dla formatu PDF sprawiają, że nie nadaje się on do poważnych zadań związanych z generowaniem plików PDF.

IronPDF to specjalnie zaprojektowana biblioteka PDF przeznaczona do konwersji HTML na PDF, oferująca obsługę wielu platform, funkcje po stronie serwera oraz kompleksowe możliwości edycji plików PDF. Jego uproszczony interfejs API eliminuje złożone wzorce asynchroniczne, obsługę zdarzeń i triki związane z synchronizacją, których wymaga WebView2.

Dla zespołów korzystających obecnie zWebView2do generowania plików PDF udokumentowane problemy ze stabilnością, ograniczenia platformy i braki w funkcjonalności sprawiają, że ocena specjalnie zaprojektowanych alternatyw jest niezbędna. Mapowanie API międzyWebView2a IronPDF jest proste, a IronPDF konsekwentnie wymaga mniejszego nakładu kodu i eliminuje ograniczenia architektoniczne narzucane przez WebView2.

Aby uzyskać dodatkowe wskazówki dotyczące wdrażania, zapoznaj się z dokumentacją IronPDF oraz samouczkami obejmującymi konkretne przypadki użycia i zaawansowane funkcje.

Zwróć uwagę: WebView2 jest zarejestrowanym znakiem towarowym jego właściciela. Ta strona nie jest powiązana z firmą Microsoft, nie jest przez nią promowana ani sponsorowana. Wszystkie nazwy produktów, logo i marki są własnością ich odpowiednich właścicieli. Porównania mają charakter wyłącznie informacyjny i odzwierciedlają informacje dostępne publicznie w momencie pisania.