使用 IRONPDF

如何在Blazor中顯示來自字節陣列的PDF

已更新 2024年3月10日
分享:

1. 簡介

IronPDF 是一個支援處理 PDF 渲染和將位元組陣列轉換為 PDF 檔案的 C# PDF 庫。它還支援審閱和列印 PDF;它還支援使用註解工具審閱 PDF。使用 IronPDF 添加頁首和頁尾,以及合併多個 PDF 也非常方便。

IronPDF 可以與 Blazor PDF viewer 一起使用來建立 PDF 檢視器,並且可以通過創建瀏覽器可以顯示的物件 URL 處理更大的檔案大小。

使用 IronPDF 與 Blazor,開發人員可以創建一個 PDF 檢視器,可以從位元組陣列或檔名顯示 PDF 檔案,並且它還支援上傳檔案和處理檔案下載。IronPDF 也提供了一種方法來處理 PDF 文件的分頁,這在 Blazor 中運作良好。

此外,IronPDF 提供了範例程式碼,以將位元組陣列轉換為 PDF 文件、下載 PDF 檔案以及從 base64 字串顯示 PDF。開發人員還可以將 PDF 檔案轉換為其他檔案格式,例如 將圖像轉換為PDF文件IronPDF 可與 Blazor 伺服器應用程式一起使用,並可整合至 Visual Studio 中,以提供無縫的開發體驗。使用 IronPDF,開發者可以創建專業級的 UI 元件,來構建現代化、功能豐富的 Web 應用程式。

本文講解了開發者如何使用 IronPDF 將 PDF 位元組數組轉換為 PDF 文件並在 Blazor PDF 檢視器中顯示。

2. 要求

要跟隨本教程,所需的工具和需求如下:

  • Visual Studio 2019 或更高版本:這是創建和運行 Blazor 應用程序所必需的。可以從官方文件下載網站下載: https://visualstudio.microsoft.com/downloads/
  • .NET 5.0 或更高版本:這是建立和執行 Blazor 應用程式所需的。可以從官方檔案下載網站下載: https://dotnet.microsoft.com/download
  • IronPDF:這是一個專業等級的UI庫,將用於將PDF位元陣列轉換成PDF文件並在Blazor PDF檢視器中顯示。可以從IronPDF檔案下載網站下載: https://ironpdf.com/
  • IronPDF.Blazor NuGet 套件:這是用於將 IronPDF 集成到 Blazor 應用程式中的 NuGet 套件。可以從 Visual Studio 的 NuGet 套件管理員中安裝。

在教程中討論的一些功能可能需要付費版本的 IronPDF。此外,教程假設您對 Blazor 和 C# 有基本的了解。

3. 建立 Blazor 應用程式

在開始構建我們的第一個 Blazor 應用程式之前,我們必須建立一個新的 Visual Studio 專案。

  • 打開 Visual Studio。
  • 點擊建立新專案。
  • 應選擇 Blazor Server 應用程式模板。

    如何在 Blazor 中從位元組陣列顯示 PDF,圖 1:在 Visual Studio 中建立新專案

    在 Visual Studio 中創建新項目

  • 選擇下一步選項。
  • 您的應用程式名稱。

    如何在 Blazor 中從位元陣列顯示 PDF,圖 2:在 Visual Studio 中創建新專案

    在 Visual Studio 中建立新專案

  • 選擇下一步選項。
  • 選擇 .NET Framework

    如何在Blazor中從位元組陣列顯示PDF,圖3:為新的Blazor伺服器應用程式選擇.NET 6.0框架

    選擇 .NET 6.0 框架來建立新的 Blazor Server 應用程式

  • 點擊 Create 按鈕。
  • 如下圖所示,將會建立一個新專案。

    如何在 Blazor 中從位元組陣列顯示 PDF,圖 4:什麼是 Blazor 以及它如何運作

    什麼是 Blazor 及其工作原理

為了給您一個可以立即使用的簡單 Blazor 軟件,已生成了幾個文件。

  • 啟動伺服器的應用程式入口點是 program.cs,這也是你設置應用程式中介軟體和服務的地方。
  • 應用程式的主要部分稱為 "App.razor"。
  • 應用程式的一些範例網頁可以在 Pages 目錄中找到。
  • 用於本地開發環境的不同配置文件設置定義在 Properties 目錄中的 "launchSettings.json" 文件中。當創建項目時,會自動分配一個端口號並保存到此文件。

啟動範本程序。

Blazor 專案類型

Blazor 支援兩種專案類型:Blazor Server 和 Blazor WebAssembly。

前者在伺服器上運行,並使用 SignalR 與瀏覽器進行通訊。這意味著應用程式的 UI 是在伺服器上呈現,瀏覽器僅接收來自伺服器的更新。Blazor Server 的優點是可以支援更大的應用程式,並且可以輕鬆處理更多使用者。

另一方面,Blazor WebAssembly 應用程式完全在瀏覽器中運行,不需要伺服器即可運行。這使得它們更輕量且載入更快,但也有一些限制,例如無法支援較大的檔案。

在本教程中,建議使用 Blazor Server 應用程式,因為它可以支援顯示和處理 PDF 檔案,這些檔案可能較大。此外,Blazor Server 還可以支援檢閱和列印 PDF,這對於 PDF 檢視器應用程式來說可能是一個有用的功能。

安裝 IronPDF

在本節中,我們將討論如何使用不同的方法安裝 IronPDF

使用命令行

導航到 Visual Studio 中的 工具 > NuGet 套件管理員 > 套件管理員主控台

在套件管理員的終端選項卡中輸入以下行:

Install-Package IronPdf

現在已經下載了套件,當前專案將會安裝它。

如何在 Blazor 中顯示來自位元陣列的 PDF,圖 5:套件管理員主控台界面

套件管理器控制台介面

使用管理 NuGet 套件解決方案

Visual Studio 提供 NuGet 套件管理器 UI,可以直接將套件安裝到專案中。以下截圖顯示了如何打開它。

如何在Blazor中從位元組陣列顯示PDF,圖6:導航到NuGet套件管理員

導航至NuGet套件管理器

套件管理器UI提供了一個瀏覽功能,顯示在NuGet網站上提供的套件庫列表。輸入關鍵字"IronPDF",如下面的截圖所示,以查找IronPDF套件。

如何在Blazor中從字節數組顯示PDF,圖7:在NuGet包管理器UI中搜索並安裝IronPDF包

在 NuGet 套件管理器 UI 中搜索並安裝 IronPDF 套件

在 NuGet 套件管理器的 瀏覽 部分中搜索 IronPDF 庫。

選擇 IronPDF 套件並單擊「安裝」按鈕將其添加到專案中。

4. 從字節數組創建和顯示 PDF

要在 Blazor 應用程序中使用 IronPDF 生成 PDF 字節數組,首先需要將 IronPDF 依賴項添加到您的項目中。

將 IronPDF 依賴項添加到您的 Blazor 應用程序後,可以使用以下代碼創建 PDF 文檔:

string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}
string _url = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}
Private _url As String = ""
Private Async Function ViewFile() As Task
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")
	_url = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}"
End Function
VB   C#

上述代碼片段首先使用了 IronPDF 的 RenderUrlAsPdf 方法,該方法從指定的 URL 下載 HTML 文本並將其轉換為 PDF 格式。生成的 PDF 材料隨後由代碼片段呈現為未處理的 base64 數據字符串並保存在本地變量中。

應用程式可以使用 IronPDF 將創建的 PDF 文件保存到伺服器的文件系統中,以便日後訪問 保存為 函數 (可在每個 ChromePdfRenderer 實例)在下一段程式碼中,base64 格式的 PDF 資料已準備輸出到客戶端的瀏覽器。

@if (_url != string.Empty)
{

}
@if (_url != string.Empty)
{

}
'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: if(_url != string.Empty)
Private Sub New(Optional _url (Not ByVal) As = String.Empty)

End Sub
VB   C#

上述功能在從 Blazor 伺服端接收到 base64 資料後,將其綁定到 iframe 元素的 src 屬性。這會使瀏覽器使用其內建的網頁檢視器在頁面載入後立即渲染 base64 內容為適當的 PDF 文件。

這是一個從 base64 字串生成的 PDF 文件圖像。

如何在Blazor中從字節數組顯示PDF,圖8:在瀏覽器中查看在Blazor應用程式中生成的PDF

在瀏覽器中檢視在 Blazor 應用程式中生成的 PDF

建立簡單的 PDF 文件

這裡是一個使用 IronPDF 在 C# 中建立簡單 PDF 文件的範例代碼片段:

var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
var renderer = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'var renderer = New IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("Hello world!!")
VB   C#

使用前一節所述的方法,客戶端的瀏覽器可以用來查看創建的 PDF 文件。

6. 結論

本教程顯示了如何使用 IronPDF 在 Blazor Server 應用程式中建立和顯示 PDF 文件。首先介紹 IronPDF 及其功能,包括 將 HTML 轉換為 PDF,添加 頁首和頁尾,和 合併多個PDF檔案. 然後,它提供了有關安裝 IronPDF 的逐步指導,在 Blazor Server 應用中創建 PDF 文件,然後將其轉換為 PDF 位元組數組,並通過使用 iframe 在 Blazor PDF viewer 中顯示。

總體而言,該教程提供了如何使用 IronPDF 和 Blazor 創建和顯示 PDF 文件的全面概述。它鼓勵讀者進一步嘗試 IronPDF,並嘗試不同的功能,以創建功能豐富的應用程序。

如果您有興趣在 Blazor 專案中嘗試 IronPDF,您可以利用 免費試用 许可证。這給了你足夠的時間來試驗該庫的功能和特性,看看它是否滿足你的需求。

要開始使用,你可以參考IronPDF的Blazor文檔,該文檔提供了在專案中使用該庫的詳細資訊。你也可以瀏覽 IronPDF 部落格 關於涵蓋與PDF處理和渲染相關的一系列主題的教程和文章。

我們鼓勵您花些時間進一步嘗試IronPDF和Blazor,看看它們如何增強您的PDF相關開發工作。 有關Blazor PDF查看器的更多信息,請參考以下內容 Blazor PDF 查看器教學.

< 上一頁
如何在C#中保存PDF檔案(初學者教程)
下一個 >
如何解除 PDF 安全性(初學者教程)

準備開始了嗎? 版本: 2024.10 剛剛發布

免費 NuGet 下載 總下載次數: 10,993,239 查看許可證 >