Iron Suite for .NET

10個 .NET 程式庫。一個完整的文件套件。

探索 Iron Suite

IRONPDF

IRONWORD

IRONXL

IRONPPT

IRONOCR

IRONBARCODE

IRONQR

IRONPRINT

IRONZIP

IRONWEBSCRAPER

比較

RawPrint .NET與IronPDF：技術比較指南

Curtis Chau

Updated: 2026年4月21日

當.NET開發人員需要將HTML內容轉換為PDF時，由於WebView2控制項的Chromium渲染引擎，有時它會被視為潛在的解決方案。然而，WebView2基本上是一個為UI應用程式設計的瀏覽器嵌入控制，而不是一個PDF生成庫。本技術比較檢視了WebView2與IronPDF，幫助架構師和開發人員了解嵌入瀏覽器控制項生成PDF與使用專用PDF庫的關鍵差異。

瞭解WebView2

WebView2（Microsoft Edge）是一個通用的嵌入式瀏覽器控制，將Edge/Chromium引擎整合到本地Windows應用程式中。此控制項支援Microsoft Edge瀏覽器的瀏覽體驗，提供現代網頁標準合規性以顯示HTML5、CSS3和JavaScript內容。

WebView2的PDF生成功能是透過其PrintToPdfAsync方法和DevTools協議整合實現的。然而，此功能更多是後加的，而不是核心功能：

**瀏覽器控制架構：**設計用於嵌入UI應用程式中的網頁內容，而不是用於伺服器端的PDF生成
**僅限Windows平台：**不支持Linux，macOS，Docker或雲端環境
**UI執行緒要求：**必須在STA執行緒運行並帶有消息泵—不能在網頁伺服器或API中運行
**Edge運行時相依性：**需要在目標機器上安裝Edge WebView2 Runtime
**無無頭模式：**即使在隱藏時也總會建立UI元素

WebView2在PDF生成方面的限制

遷移指南文件中指出了使用WebView2生成PDF的重大問題：

問題	影響	嚴重程度
記憶體洩漏	WebView2在長期運行中出現已記錄的記憶體洩漏	CRITICAL（嚴重）
僅限Windows	不支持Linux，macOS，Docker或雲端環境	CRITICAL（嚴重）
UI執行緒要求	必須在STA執行緒運行並帶有消息泵	CRITICAL（嚴重）
非為PDF設計	`PrintToPdfAsync`是一個事後考慮	HIGH（高）
在服務中不穩定	在Windows服務中掛機或崩潰情況常見	HIGH（高）
複雜的非同步流程	導航事件、完成回調、競跑狀況	HIGH（高）
Edge運行時相依性	需要在目標機器上安裝Edge WebView2 Runtime	MEDIUM（中等）
無無頭模式	即使在隱藏時也會建立UI元素	MEDIUM（中等）

了解IronPDF

IronPDF是一個專門為從HTML和網頁內容生成PDF而設計的PDF庫。與WebView2的瀏覽器嵌入方法不同，IronPDF 提供了一個專用的PDF生成引擎，具有跨平台支持和伺服器端功能。

關鍵特性包括：

**專用PDF庫：**從一開始就設計為PDF生成，而不是UI嵌入
跨平台支持： Windows，Linux，macOS，Docker，iOS和Android
**任何執行緒操作：**無需STA執行緒或消息泵要求
伺服器/雲就緒： 支持ASP.NET Core，Azure，AWS，GCP和Docker
無外部相依性： 自足，無需運行時安裝
全面的PDF功能： 頁眉/頁腳、水印、合併/拆分、數位簽名、PDF/A合規性

功能比較

下表強調了WebView2和IronPDF之間的基本差異：

功能	WebView2	IronPDF
目的	瀏覽器控制（UI）	PDF庫（為PDF設計）
生產就緒	不可以	可以
内存管理	長期運行時洩漏	穩定，妥善處理
平台支持	僅限Windows	Windows、Linux、macOS、Docker
執行緒要求	STA + 消息泵	任意執行緒
伺服器/雲端	不支持	支持
Azure/AWS/GCP	有問題	完美運作
Docker	不可能	可用官方映像
ASP.NET Core	無法工作	一流的支持
背景服務	不穩定	穩定
控制台應用	複雜的解決方案	是
WinForms/WPF	是	是
頁眉/頁腳	不可以	是（HTML）
水印	不可以	是
合併 PDF s	不可以	是
分割 PDF s	不可以	是
數位簽名	不可以	是
密碼保護	不可以	是
PDF/A合規性	不可以	是
表格填寫	不可以	是
專業支持	不提供PDF使用	是
文件	有限的PDF文件	廣泛的

API 架構差異

檢查兩者在PDF生成上的處理方式時，WebView2和IronPDF的架構差異立即顯而易見。

WebView2複雜的非同步模式

WebView2需要涉及到瀏覽器初始化、導航、事件處理和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

此程式碼演示了幾個WebView2的複雜性：通過NavigateToString()導航，為等待內容載入而進行任意延遲，及低級的DevTools協議呼叫。 Task.Delay代表了一個對於何時內容準備好的不可靠猜測——一個競跑條件等待發生。

IronPDF簡化方法

IronPDF消除了這種複雜性，使用簡單的一個方法方式：

// 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

ChromePdfRenderer 類在內部處理所有渲染複雜性。無初始化儀式，無導航事件，無時間推測。有關全面的HTML轉換指導，請參見HTML轉PDF教程。

URL 轉 PDF

將網頁轉換為PDF文件展示了WebView2和IronPDF之間的複雜性差距。

WebView2實施

WebView2需要導航事件處理、完成回調和手動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

此實施需要建立一個NavigationCompleted事件、解析來自DevTools協議的JSON響應和處理Base64解碼。導航完成後的附加Task.Delay(1000)嘗試確保JavaScript已完成執行——另一個不可靠的時間修正。

IronPDF實施

IronPDF在單次方法調用中提供直接的URL渲染：

// 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

RenderUrlAsPdf方法在內部處理導航、JavaScript執行和內容載入。無事件訂閱，無時間猜測，無Base64解析。

自訂PDF設置和選項

配置頁面尺寸、邊距和方向顯示出API可用性的顯著區別。

WebView2 DevTools協議配置

WebView2需要JSON序列化和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使用英吋為尺寸單位，需要匿名物件和JSON序列化，並使用事件處理程式和時間延遲維持複雜的非同步流程。

IronPDF渲染選項配置

IronPDF通過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使用毫米作為精確測量，提供RenderHtmlFileAsPdf()用於基於文件的內容。

帶自訂方向的HTML文件轉為PDF

將HTML文件轉換為橫向顯示了PrintSettings方法與RenderingOptions的不同。

WebView2 PrintSettings方法

WebView2提供一個替代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

注意3秒的Task.Delay—這是一個更長的任意等待，試圖確保內容在列印前載入。

IronPDF簡化配置

IronPDF處理相同任務，具有明確的設置而無時間推測：

// 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

API映射參考

評估從WebView2遷移到IronPDF的團隊會發現這映射能幫助理解概念上的對等：

WebView2 API	IronPDF等效
`new WebView2()`	`new ChromePdfRenderer()`
`EnsureCoreWebView2Async()`	不適用
`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`
導航事件	`WaitFor.JavaScript()`
`printBackground: true`	`PrintHtmlBackgrounds = true`

當團隊考慮從WebView2遷移到IronPDF時

以下幾種情景通常促使開發團隊評估IronPDF作為WebView2的替代方案：

跨平台需求

WebView2僅限Windows的限制使其不適合於針對Linux伺服器、Docker容器或雲端環境的應用程式。部署在Azure, AWS, GCP或容器化基礎設施的團隊不能使用WebView2進行PDF生成。

伺服器端PDF生成

WebView2的UI執行緒要求及STA和消息泵使其與ASP.NET Core、背景服務或API端點根本不相容。需要在網頁請求響應中生成PDF的應用程式不能使用WebView2。

記憶體穩定性問題

在長期運行中出現的WebView2已記錄的記憶體洩漏導致生產環境中的伺服器崩潰。需要不斷地在全天生成PDF的應用程式會累積記憶體，直到出現記憶體不足的情況。

PDF特性需求

WebView2的PrintToPdfAsync僅提供基本的HTML到PDF轉換。需要頁眉/頁腳、水印、PDF合併/拆分、數位簽名、密碼保護或PDF/A合規性的團隊必須尋找其他地方。

簡化開發

WebView2需要的複雜非同步流程——初始化、導航事件、完成回調、時間延遲、JSON序列化、Base64解碼——帶來了與IronPDF的單方法途徑相比的重大開發和維護負擔。

IronPDF的額外功能

超越基本的PDF生成，IronPDF提供了WebView2無法提供的文件操作功能：

**合併PDF：**將多個文件合併為單個文件
**拆分文件：**將頁面範圍提取到單獨的PDF中
**數位簽名：**應用加密簽名以驗證文件的真實性
浮水印： 新增文字或圖片浮水印
**PDF/A合規性：**生成符合檔案存檔標準的文件
**表單填寫：**以編程方式填寫PDF表單字段
頁眉和頁腳： 自動頁碼和品牌
**密碼保護：**使用使用者和擁有者密碼加密PDFs。
Docker部署： 用於Linux部署的官方容器映像

.NET相容性和未來準備

WebView2的僅限Windows架構限制了它在日益增長的跨平台.NET生態系統中的未來。 IronPDF保持積極的開發並定期更新，確保與.NET 8、.NET 9及包括預計在2026年發佈的.NET 10在內的未來版本的相容性。該程式庫在其API中全面支援async/await，符合現代C#開發實踐，包括預計在C# 14中推出的功能。