IronPDF 是一个有名的 C# 库，可以与 Blazor 应用程序一起使用。 本次评审将指导您如何使用 IronPDF 将 PDF 报告嵌入到 Blazor 应用程序中，展示其无缝集成和高效性。

1. IronPDF 功能

开发人员可以通过强大的 IronPDF for .NET PDF 库快速创建、读取和处理 PDF 文档。 IronPDF 具有 内置的 Chrome 引擎，并提供丰富实用且强大的功能。 这些功能包括将 HTML5、JavaScript、CSS 和图像转换为 PDF 的能力、为 PDF 文档添加独特的页眉和页脚的能力，以及准确生成与网页浏览器中显示相同的 PDF 的能力。 IronPDF 支持各种 Web 技术，包括 HTML、ASPX、Razor Pages 和 MVC 框架。

IronPDF 的关键属性如下：

• IronPDF 提供在 .NET C# 应用程序中创建和修改 PDF 文件的完全控制
• IronPDF 能够根据网页的 URL 生成 PDF 文件，使用特定的用户代理、代理、头信息和 Cookie 配置。
• IronPDF 能生成位于需要登录表单的网页的 PDF 文件，使用表单变量
• IronPDF 能从现有的 PDF 文件中提取或移除照片
• IronPDF 可以为 PDF 文档添加文本、照片、书签、水印等元素
• IronPDF 简化了合并和拆分单个或多个 PDF 文档页面的操作。
• IronPDF 能处理网页资产，如 JavaScript、CSS 和媒体文件，并将它们渲染成与浏览器中显示相同的 PDF 文档。
• IronPDF 支持所有 .NET Framework，包括 .NET Core、.NET Standard 等。

2. 什么是 Blazor？

Blazor 是一种 Web 应用程序框架，使得使用 C# 和 HTML 在客户端创建 Web 应用程序成为可能，使用 WebAssembly。

WebAssembly 应用程序以二进制指令格式发送到浏览器，能够以接近本地的速度运行。 这为 C# 等语言提供了在浏览器中运行的新可能性。

在 Visual Studio 中创建一个新项目

首先，打开 Microsoft Visual Studio 应用程序，并从文件菜单中选择"新建项目"。 然后，选择"Blazor 服务器应用"。

在Visual Studio中创建新项目

输入项目名称并选择文件路径。 然后，点击创建按钮。

选择新 Blazor 应用程序的名称和位置

选择所需的 .NET Framework（本教程中我们将使用 .NET 6.0），如下图所示：

使用 .NET 6.0 框架在 Visual Studio 中创建一个新项目

Microsoft Visual Studio 现在将生成这个 Blazor 应用程序的结构。

接下来，将 IronPDF 库添加到这个新项目中。

3. 安装IronPDF库

可以通过四种方式下载和安装 IronPDF 库：

• 使用 Visual Studio 的 NuGet 包管理器
• 使用 Visual Studio 的命令行
• 直接从 NuGet 网站下载
• 直接从 IronPDF 网站下载

3.1 使用 Visual Studio 的 NuGet 包管理器

Visual Studio 提供 NuGet 包管理器，以帮助直接将库安装到项目中。 下图显示如何打开NuGet包管理器。

访问 Visual Studio 的 NuGet 包管理器

在"浏览"标签下使用搜索字段搜索"IronPDF"，如下图所示：

在 NuGet 包管理器 GUI 中搜索 IronPDF 库

上图展示了相关搜索结果列表。 选择所需的选项，将包安装到项目中。

3.2 使用 Visual Studio 命令行

在 Visual Studio 中，进入工具 > NuGet 包管理器 > 包管理器控制台

在包管理器控制台选项卡中输入以下行：

Install-Package IronPdf

现在，该包将被下载并安装到当前项目中。

使用 NuGet 包管理器控制台安装 IronPDF 库

3.3 直接从 NuGet 网站下载

安装 IronPDF 库的第三种方式是直接从网站下载 NuGet 包。

导航到IronPDF 的 NuGet 网站。

• 点击右侧菜单中的"下载包"选项。
• 在文件系统上打开下载的包。 它将自动安装。
• 重新加载解决方案并开始在项目中使用。

3.4 直接从 IronPDF 网站下载

访问 IronPDF 网站，直接下载 IronPDF 包。

下载后，按以下步骤将包添加到项目中：

• 从解决方案窗口中右键点击项目。
• 选择"添加">"引用"选项，然后导航到之前下载的库所在位置。
• 点击 OK 将库添加为引用。

4. 在 Blazor 服务器应用中创建 PDF 文档

本教程中的 Blazor 应用程序将使用 IronPDF 根据网页的 URL 获取 HTML 内容并将其转换为 PDF 文档。

在项目中包含的 .razor 文件中输入以下源代码。

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();
            
            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
            
            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@using IronPdf

@code {
    /// <summary>
    /// This method exports data by converting a URL to a PDF file and initiating its download.
    /// </summary>
    public async Task ExportData()
    {
        try
        {
            string fileName = "Demo.pdf";
            var renderer = new ChromePdfRenderer();
            
            // Render the contents of the URL as a PDF document
            var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
            
            // Save the PDF using a JavaScript function
            await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()));
        }
        catch (Exception ex)
        {
            // Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}");
        }
    }
}

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")

            ' Save the PDF using a JavaScript function
            Await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()))
        Catch ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

@Code
    ' <summary>
    ' This method exports data by converting a URL to a PDF file and initiating its download.
    ' </summary>
    Public Async Function ExportData() As Task
        Try
            Dim fileName As String = "Demo.pdf"
            Dim renderer As New ChromePdfRenderer()

            ' Render the contents of the URL as a PDF document
            Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")

            ' Save the PDF using a JavaScript function
            Await JSRuntime.InvokeVoidAsync("saveAsFile", fileName, Convert.ToBase64String(pdf.Stream.ToArray()))
        Catch ex As Exception
            ' Handle any exceptions that may occur
            Console.Error.WriteLine($"Error in ExportData: {ex.Message}")
        End Try
    End Function

上面的代码片段使用两种方法生成 HTML 到 PDF 的文档。 第一个是IronPDF的RenderUrlAsPdf方法，用于从给定的URL下载HTML内容并将其转换为PDF格式。

第二个方法是静态JSRuntime.InvokeVoidAsync方法，它触发浏览器的JavaScript引擎在网页范围内调用JavaScript函数，将PDF内容保存到客户端的文件系统中。

下面包含此 JavaScript 函数：

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

<script type="text/javascript">
    /**
     * Saves the PDF data as a file on the client's system.
     * @param {string} filename - The name of the file to be created.
     * @param {string} bytesBase64 - The Base64 encoded string of the PDF data.
     */
    function saveAsFile(filename, bytesBase64) {
        if (navigator.msSaveBlob) {
            // Download the document in Microsoft Edge browser
            var data = window.atob(bytesBase64);
            var bytes = new Uint8Array(data.length);
            for (var i = 0; i < data.length; i++) {
                bytes[i] = data.charCodeAt(i);
            }
            var blob = new Blob([bytes.buffer], { type: "application/octet-stream" });
            navigator.msSaveBlob(blob, filename);
            window.navigator.msSaveOrOpenBlob(blob);
        }
        else {
            var link = document.createElement('a');
            link.download = filename;
            link.href = "data:application/octet-stream;base64," + bytesBase64;
            document.body.appendChild(link); // Needed for Firefox
            link.click();
            document.body.removeChild(link);
        }
    }
</script>

上面的 JavaScript 函数接收来自 Blazor 的 Base64 数据，并将其转换为 blob，然后将其保存到客户端位置。

或者，可以使用ChromePdfRenderer类的SaveAs方法将PDF文档保存到浏览器的本地存储中。

5. 从 HTML 字符串创建 PDF 文档

以下代码段展示如何将 HTML 字符串转换成文档。

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@using IronPdf

@code {
    /// <summary>
    /// Demonstrates turning an HTML string into a PDF document.
    /// </summary>
    public void GeneratePdfFromHtmlString()
    {
        var renderer = new ChromePdfRenderer();
        var pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>");
        
        // You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf");
    }
}

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

@Using IronPdf

@Code
    ''' <summary>
    ''' Demonstrates turning an HTML string into a PDF document.
    ''' </summary>
    Public Sub GeneratePdfFromHtmlString()
        Dim renderer As New ChromePdfRenderer()
        Dim pdf = renderer.RenderHtmlAsPdf("<h1>Hello world!!</h1>")
        
        ' You can save the generated PDF locally
        pdf.SaveAs("HelloWorld.pdf")
    End Sub

前面的示例使用RenderHtmlAsPdf实例方法将任何HTML字符串转换为PDF内容。 此外，可以在前面描述的过程中使用SaveAs方法将此内容保存到客户端的计算机上。

在本教程中创建的 Blazor PDF 生成应用程序

上面的截图展示了本教程中开发的 Web 应用程序。 点击下载按钮将触发 C# 代码生成 PDF 内容，以及在客户端下载 PDF 内容的 JavaScript 函数。

结论

本文演示了如何开发一个使用 IronPDF PDF 库从网页生成 PDF 文件的 Blazor Web 应用程序。

IronPDF 不是开源的，然而，一个免费试用密钥允许您在生产中使用而不会有水印。