Blazor PDF 檢視器教程

介紹

Adobe 創建了可攜式文件格式(PDF)，廣泛用於發布格式化文本和圖像。 在本教程中，推薦將 IronPDF 整合到用於顯示 PDF 的 Blazor 伺服器端應用程式因為它易於使用且高效。

1. IronPDF 功能

借助功能強大的 IronPDF PDF .NET 庫，開發人員可以輕鬆創建、閱讀和修改 PDF 文件。 基於IronPDF Chrome 渲染引擎, IronPDF 包含多種實用且強大的功能，例如將 HTML5、JavaScript、CSS 和圖像轉換為 PDF 的能力，添加自訂頁眉和頁腳到 PDF 的能力，以及創建與網頁瀏覽器中呈現的效果完全一致的 PDF 的能力。

IronPDF 支援多種網頁技術，包括 HTML、ASPX、Razor View 和 MVC。 以下是 IronPDF 的主要特點：

• IronPDF 提供對 .NET C# 應用程式內 PDF 文件創建和修改的完整控制權。
• IronPDF 可以從網址生成網頁的 PDF 文件使用特定的使用者代理、代理伺服器、標頭和 Cookie 配置。
• IronPDF 可以從現有的 PDF 文件中刪除圖像
• IronPDF可以添加文字、照片、書籤，浮水印，和其他元素到 PDF 文件中
• IronPDF具有多種功能，可以合併和分割 PDF 文件輕鬆地
• IronPDF 能夠理解並呈現網絡媒體資源，例如 CSS 和 JavaScript
• IronPDF 支援多種 .NET 桌面和 MVC Web 應用程式框架，包括 ASP.NET 和 Blazor。

2. 什麼是Blazor？

Blazor 是一種實驗性的網頁應用程式框架，使得可以使用 Web Assembly 在 C# 和 HTML 中創建客戶端網頁應用程式。

Web Assembly 應用程式以二進位指令格式發送到瀏覽器，可以以接近本機速度運行。 這為在瀏覽器中執行像 C# 這樣的語言創造了新的潛力。

在 Visual Studio 中建立新專案

首先，打開 Microsoft Visual Studio 應用程式，然後從檔案選單中選擇「新專案」。 然後，選擇 “Blazor 伺服器應用程式”。

在 Visual Studio 中建立新專案

輸入專案名稱並選擇檔案路徑。 然後，點擊創建按鈕。

在 Visual Studio 中建立新專案

此外，選擇所需的 .NET Framework。 建議使用最新版本以確保穩定性。

為新的 Blazor Server 應用選擇 .NET 6.0 框架

Microsoft Visual Studio 現在將為新的 Blazor Server App 生成結構。此專案將包含一組 .razor 文件，您可以在其中輸入源代碼。

接下來的步驟將把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 套件。

導航至NuGet上的IronPDF套件.

• 從右側選單中點擊「下載包」選項。
• 在您的文件系統上打開下載的套件。 將自動安裝。
• 重新載入解決方案並在您的專案中開始使用。

3.4 直接從 IronPDF 網站下載

從最新的網頁下載套件IronPDF 網站.

下載後，請按照以下步驟將套件添加到您的專案中：

• 在解決方案窗口中右鍵點擊專案。
• 選擇「引用」選項，然後導航至您之前下載的庫的位置。
• 單擊確定以將該庫添加為引用。

4. 使用 Blazor 伺服器應用程式檢視 PDF 文件

在本教程中構建的 Blazor 應用程式將從網頁的 URL 創建 PDF 文檔，並在客戶端的網頁瀏覽器中呈現。

使用 IronPDF，查看 PDF 非常簡單。

將以下源代碼添加到對應的 .razor 文件中。

string _imgUrl = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

string _imgUrl = "";
private async Task ViewFile()
{
    var renderer = new IronPdf.ChromePdfRenderer();
    var pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata");
    _imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}";
}

Private _imgUrl As String = ""
Private Async Function ViewFile() As Task
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderUrlAsPdf("https://localhost:7018/fetchdata")
	_imgUrl = $"data:application/pdf;base64,{Convert.ToBase64String(pdf.Stream.ToArray())}"
End Function

以上代碼片段首先使用了 IronPDF 的RenderUrlAsPdf方法，從給定的 URL 下載 HTML 內容並將其轉換為 PDF 格式。 隨後，程式碼片段將生成的 PDF 內容呈現為原始 base64 資料的字串，並將其儲存在本機變數中。

為了方便，應用程式可以使用 IronPDF 的保存為方法(可用於任何ChromePdfRenderer實例)將生成的 PDF 文件保存到伺服器的檔案系統中，以便稍後快速訪問。

下一段程式碼將準備好的 base-64 PDF 資料輸出到客戶端的瀏覽器上。

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

@if (_imgUrl != string.Empty)
{
    <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
}

'INSTANT VB WARNING: The following constructor is declared outside of its associated class:
'ORIGINAL LINE: if(_imgUrl != string.Empty)
Private Sub New(Optional _imgUrl (Not ByVal) As = String.Empty)
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type="application/pdf"/>
	"width:750px;height:750px;" type="application/pdf"/>
'INSTANT VB WARNING: An assignment within expression was extracted from the following statement:
'ORIGINAL LINE: <iframe src="@_imgUrl" style="width:750px;height:750px;" type
	"@_imgUrl" style="width:750px;height:750px;" type
	<iframe src="@_imgUrl" style
End Sub

上面的函式從 Blazor 伺服器端接收 base64 資料，並將其綁定到 iframe 元素的 src 屬性。 在頁面加載時，這會觸發瀏覽器使用其內建檢視器將 base64 內容渲染為一個正式的 PDF 文件。

以下是從 base64 字串渲染的 PDF 文件截圖。

**在瀏覽器中查看 Blazor 應用程式生成的 PDF。 這個 PDF 是由 IronPDF 創建並作為 base64 字串發送到瀏覽器的。

從 HTML 字串查看 PDF 文件

以下是一個展示如何使用IronPDF從一串HTML標籤創建PDF文件的例子。

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'var pdf = New IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>")

生成的 PDF 文件可以按照上一節中詳細說明的程序從客戶端瀏覽器查看。

結論

本文介紹如何開發一個 Blazor 網頁應用程式，使用 IronPDF 庫從網頁生成 PDF 文件並在用戶的瀏覽器中顯示。

IronPDF不是開源的； 但是，a免費試用密鑰允許您在生產環境中使用它而沒有浮水印。