信息圖標
跳過到頁腳內容
  1. IronPDF
  2. IronPDF部落格
  3. 使用IronPDF
  4. PDF 檢視器 ASP .NET
使用IRONPDF

ASP.NET的PDF檢視器：如何在.NET 10中顯示PDF

Curtis Chau
Curtis Chau
更新:

若要在 ASP.NET Core 中實作 PDF 檢視器，可以使用 IronPDF 從 HTML、URL 或 Razor 視圖產生 PDF。 為它們提供合適的頭部信息，以便在瀏覽器中內聯顯示，無需外部插件或下載即可提供流暢的文檔查看體驗。

使用 .NET 建立 Web 應用程式通常需要直接在瀏覽器中顯示 PDF 文件。 無論是發票、報告或互動式 PDF 表單，使用者都希望獲得流暢的文件檢視體驗，而無需 Adobe Acrobat Reader 或其他第三方瀏覽器工具。

在本教學中，您將學習如何使用IronPDF為 ASP.NET 和 .NET Core 實作 PDF 檢視器。 這款可靠的 PDF 檢視器控制項可讓開發人員在 .NET 應用程式中建立、渲染和顯示 PDF 文件，為處理業務關鍵型文件提供專業的解決方案。 本文介紹的方法適用於.NET 10及所有更早的 .NET Core 版本。

ASP.NET Core 中 PDF 檢視的工作原理是什麼？

現代瀏覽器都內建了 PDF 檢視器。 當您使用正確的 MIME 類型（例如 application/pdf）提供 PDF 檔案時，瀏覽器會自動將其內嵌顯示。這意味著您無需外部外掛程式即可查看 PDF 文件或顯示 PDF 文件。 關鍵在於產生高品質的 PDF 檔案並配置正確的回應標頭。

IronPDF 是一個經常更新的 .NET PDF 庫，它擅長從 HTML、Razor 視圖或現有文件創建像素級完美的 PDF 頁面。 其基於 Chrome 的渲染引擎可確保對 CSS、JavaScript 和圖像的精確支持，為用戶提供與桌面 PDF 檢視器相媲美的檢視體驗。 您可以在IronPDF 功能頁面上查看完整的功能清單。

當請求到達您的 ASP.NET Core 控制器時，工作流程很簡單：使用 IronPDF 產生（或載入）PDF，將回應標頭設定為 Content-Disposition，將 MIME 類型指定為 application/pdf，然後傳回二進位資料。 瀏覽器會自動處理渲染－無需設定 JavaScript PDF.js，也不依賴瀏覽器擴充功能。

儘早理解這種模式可以節省開發時間。您無需整合複雜的 JavaScript 檢視器庫，而是將渲染工作委託給瀏覽器，而 IronPDF 則僅用於伺服器端的產生和處理。 ASP.NET Core 文件中關於文件回應的部分解釋了這些模式中使用的底層類型。

如何設定 ASP.NET Core 專案？

首先建立一個新的 ASP.NET Core MVC 應用程式。 打開終端機並運作：

dotnet new mvc -n PdfViewerApp
cd PdfViewerApp
dotnet new mvc -n PdfViewerApp
cd PdfViewerApp
SHELL

這會建立一個支援 MVC 的基本 .NET 應用程式。 MVC 結構提供了控制器來處理 PDF 生成請求，以及視圖來建立前端介面。 隨著應用程式的成長，專用的 PdfController 可以保持與 PDF 相關的邏輯井然有序，易於維護。

如何安裝和配置 IronPDF？

安裝 IronPDF 只需幾個步驟。 可以使用 Visual Studio 中的 NuGet 套件管理器控制台或.NET CLI ：

# Package Manager Console (Visual Studio)
Install-Package IronPdf

# .NET CLI
dotnet add package IronPdf
# Package Manager Console (Visual Studio)
Install-Package IronPdf

# .NET CLI
dotnet add package IronPdf
SHELL

然後配置庫 Program.cs:

using IronPdf;

// Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
using IronPdf;

// Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";
Imports IronPdf

' Set license key at application startup
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY"
$vbLabelText   $csharpLabel

在進行任何 PDF 操作之前，請在 Program.cs 中設定您的許可證金鑰。 我們提供免費試用許可證，供開發和評估之用。 IronPDF 文件提供了針對不同部署環境（包括 Azure 和 Docker）的更多設定範例。

如何產生可供檢視的PDF檔案？

IronPDF 可讓您從原始 HTML 字串、即時網頁或 Razor 視圖建立 PDF 檔案。 然後，只需幾行 C# 程式碼即可將產生的 PDF 文件以內聯方式顯示。

這種方法避免了強制下載，使用戶能夠直接在瀏覽器中查看、列印、搜尋和保存 PDF 文件，而無需在客戶端安裝任何額外的檢視器元件。

如何從 HTML 字串建立 PDF？

最簡單的方法是將 HTML 字串直接轉換為 PDF。 使用此模式可以產生動態內容，例如報表或發票：

using IronPdf;

var renderer = new ChromePdfRenderer();

string html = @"
    <html>
    <head>
        <style>
            body { font-family: Arial; padding: 20px; }
            h1 { color: #333; }
        </style>
    </head>
    <body>
        <h1>Sample PDF Document</h1>
        <p>This PDF was generated using IronPDF in ASP.NET Core.</p>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(html);

// Return PDF to browser for inline viewing
return File(pdf.BinaryData, "application/pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();

string html = @"
    <html>
    <head>
        <style>
            body { font-family: Arial; padding: 20px; }
            h1 { color: #333; }
        </style>
    </head>
    <body>
        <h1>Sample PDF Document</h1>
        <p>This PDF was generated using IronPDF in ASP.NET Core.</p>
    </body>
    </html>";

var pdf = renderer.RenderHtmlAsPdf(html);

// Return PDF to browser for inline viewing
return File(pdf.BinaryData, "application/pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()

Dim html As String = "
    <html>
    <head>
        <style>
            body { font-family: Arial; padding: 20px; }
            h1 { color: #333; }
        </style>
    </head>
    <body>
        <h1>Sample PDF Document</h1>
        <p>This PDF was generated using IronPDF in ASP.NET Core.</p>
    </body>
    </html>"

Dim pdf = renderer.RenderHtmlAsPdf(html)

' Return PDF to browser for inline viewing
Return File(pdf.BinaryData, "application/pdf")
$vbLabelText   $csharpLabel

創建了 ChromePdfRenderer，它使用 Chromium 引擎進行精確渲染。 將 HTML（帶有內嵌 CSS）傳遞給 RenderHtmlAsPdf，產生 PdfDocument。 傳回 MIME 類型為 application/pdf 的檔案可確保瀏覽器以內嵌方式顯示。有關此轉換方法的詳細信息，請參閱HTML 字串轉 PDF 指南。

如何根據URL產生PDF？

將現有網頁轉換為 PDF 也同樣簡單。 這對於存檔即時內容或產生以網頁形式發布的報告快照非常有用：

using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.JavaScript(3000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

var pdf = renderer.RenderUrlAsPdf("https://example.com/report");
Response.Headers.Add("Content-Disposition", "inline; filename=webpage.pdf");

return File(pdf.BinaryData, "application/pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.EnableJavaScript = true;
renderer.RenderingOptions.WaitFor.JavaScript(3000);
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print;

var pdf = renderer.RenderUrlAsPdf("https://example.com/report");
Response.Headers.Add("Content-Disposition", "inline; filename=webpage.pdf");

return File(pdf.BinaryData, "application/pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.EnableJavaScript = True
renderer.RenderingOptions.WaitFor.JavaScript(3000)
renderer.RenderingOptions.CssMediaType = IronPdf.Rendering.PdfCssMediaType.Print

Dim pdf = renderer.RenderUrlAsPdf("https://example.com/report")
Response.Headers.Add("Content-Disposition", "inline; filename=webpage.pdf")

Return File(pdf.BinaryData, "application/pdf")
$vbLabelText   $csharpLabel

RenderUrlAsPdf 方法取得頁面，套用樣式和腳本，並輸出精美的 PDF。 將 Content-Disposition 標頭設定為 inline 即可在瀏覽器的 PDF 檢視器中開啟檔案。 JavaScript 渲染選項可確保動態內容在擷取之前正確載入。

! PDF 檢視器 Web 應用程序，顯示 IronPDF for .NET 文檔，頂部有"從 HTML 產生"、"從 URL 產生"和"列印"按鈕。

如何將 Razor 視圖轉換為 PDF？

Razor 視圖是發票等結構化文件的理想模板，因為同一個模板可以同時用於網頁和 PDF 輸出。 將視圖渲染成 HTML 字串，然後將其傳遞給 IronPDF：

using IronPdf;

// Render the Razor view to an HTML string first
var htmlContent = await RenderViewToString("Invoice", invoiceModel);

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

return File(pdf.BinaryData, "application/pdf");
using IronPdf;

// Render the Razor view to an HTML string first
var htmlContent = await RenderViewToString("Invoice", invoiceModel);

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(htmlContent);

return File(pdf.BinaryData, "application/pdf");
Imports IronPdf

' Render the Razor view to an HTML string first
Dim htmlContent As String = Await RenderViewToString("Invoice", invoiceModel)

Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf(htmlContent)

Return File(pdf.BinaryData, "application/pdf")
$vbLabelText   $csharpLabel

首先使用輔助方法將視圖渲染成 HTML 字串，然後使用 RenderHtmlAsPdf 進行轉換。 這種方法可讓您重複使用 Razor 範本進行網頁顯示和 PDF 生成，從而確保輸出在不同格式之間保持一致。 HTML 轉 PDF 操作指南涵蓋了其他 Razor 整合模式。

如何在瀏覽器中直接顯示PDF檔案？

內嵌顯示 PDF 檔案（而不是觸發下載）的關鍵在於設定正確的回應標頭。 現代瀏覽器在正確配置內容類型和佈局後支援內聯 PDF 檢視。

設定 Content-Disposition: inline 會告訴瀏覽器直接渲染 PDF，而設定 Content-Disposition: attachment 則會跳出下載對話方塊。 雖然只是一個標頭值的變化，但這會對使用者體驗產生重大影響。

您也可以透過新增頁首和頁尾來增強顯示的文檔，以便進行頁碼標註和品牌宣傳，或新增自訂浮水印來將文件標記為草稿或機密。

如何啟用動態PDF載入？

對於需要在多個文件之間切換而無需刷新整個頁面的應用程序，請使用 iframe 並結合控制器端點：

using IronPdf;
using Microsoft.AspNetCore.Mvc;

// Controller action to list available PDFs
[HttpGet]
public IActionResult GetPdfList()
{
    var pdfs = new List<object>
    {
        new { id = 1, name = "Report 1" },
        new { id = 2, name = "Report 2" }
    };
    return Json(pdfs);
}

// Controller action to generate and return a specific PDF
[HttpGet]
public IActionResult GetPdf(int id)
{
    var renderer = new ChromePdfRenderer();
    string html = $"<h1>Report {id}</h1><p>Content for report {id}.</p>";
    var pdf = renderer.RenderHtmlAsPdf(html);
    Response.Headers.Add("Content-Disposition", $"inline; filename=report-{id}.pdf");
    return File(pdf.BinaryData, "application/pdf");
}
using IronPdf;
using Microsoft.AspNetCore.Mvc;

// Controller action to list available PDFs
[HttpGet]
public IActionResult GetPdfList()
{
    var pdfs = new List<object>
    {
        new { id = 1, name = "Report 1" },
        new { id = 2, name = "Report 2" }
    };
    return Json(pdfs);
}

// Controller action to generate and return a specific PDF
[HttpGet]
public IActionResult GetPdf(int id)
{
    var renderer = new ChromePdfRenderer();
    string html = $"<h1>Report {id}</h1><p>Content for report {id}.</p>";
    var pdf = renderer.RenderHtmlAsPdf(html);
    Response.Headers.Add("Content-Disposition", $"inline; filename=report-{id}.pdf");
    return File(pdf.BinaryData, "application/pdf");
}
Imports IronPdf
Imports Microsoft.AspNetCore.Mvc

' Controller action to list available PDFs
<HttpGet>
Public Function GetPdfList() As IActionResult
    Dim pdfs = New List(Of Object) From {
        New With {.id = 1, .name = "Report 1"},
        New With {.id = 2, .name = "Report 2"}
    }
    Return Json(pdfs)
End Function

' Controller action to generate and return a specific PDF
<HttpGet>
Public Function GetPdf(id As Integer) As IActionResult
    Dim renderer = New ChromePdfRenderer()
    Dim html As String = $"<h1>Report {id}</h1><p>Content for report {id}.</p>"
    Dim pdf = renderer.RenderHtmlAsPdf(html)
    Response.Headers.Add("Content-Disposition", $"inline; filename=report-{id}.pdf")
    Return File(pdf.BinaryData, "application/pdf")
End Function
$vbLabelText   $csharpLabel

在用戶端，在 Razor 視圖中使用一小段 JavaScript 程式碼更新 iframe 來源，以便在不重新載入頁面的情況下載入不同的 PDF 檔案。 控制器按需生成 PDF 文件，從而保持響應大小可預測。 對於大型文檔，可將此模式與IronPDF 的合併和分割功能結合使用，以分段方式提供文件。

! PdfViewerApp 的螢幕截圖，顯示一個 PDF 檢視器，其中顯示"Hello World"文本，並帶有導航控制項和"從 HTML 產生"、"從 URL 產生"和"列印"等操作按鈕。

如何處理部署和效能問題？

IronPDF 可套用於 ASP.NET、ASP.NET Core 和 Blazor Server 專案。 您可以將其託管在 Windows Server 上，部署到 Azure，或使用 Docker 進行容器化。 由於它完全支援.NET 10以及更早的版本，因此可以整合到現代應用程式和傳統應用程式中。

如何部署到 Azure？

部署到 Azure 應用程式服務時，IronPDF 只需極少的額外配置即可運作。 為獲得最佳效能，請確保您的應用程式服務計劃至少為 B1 等級。 IronPDF 會自動處理 Chrome 渲染引擎的部署。

對於 Linux 上的容器化部署，請將所需的系統相依性新增至 Dockerfile ：

RUN apt-get update && apt-get install -y libgdiplus
RUN apt-get update && apt-get install -y libgdiplus
SHELL

IronPDF 文件詳細介紹了特定於 Linux 平台的要求。 如果不需要完整的 Chrome 渲染引擎，可以考慮使用 IronPDF Slim 來縮小容器影像的大小。

關鍵績效考量有哪些？

PDF 服務應用程式的效能取決於 PDF 的產生頻率和檔案大小。 以下做法適用於大多數生產環境部署：

  • 當底層內容不經常變更時，使用記憶體流或分散式快取快取產生的 PDF 檔案。
  • 使用非同步控制器操作，避免在 PDF 產生過程中阻塞執行緒。
  • 為包含大量 JavaScript 程式碼的複雜 HTML 頁面設定適當的渲染逾時時間
  • 添加浮水印和壓縮以減小檔案大小，然後再提供服務
  • 啟用PDF轉圖像功能，以便在文件清單中產生預覽縮圖，而不是載入完整的PDF檔案。
  • 使用文字擷取技術建立伺服器端搜尋索引，而不是依賴瀏覽器內建的 PDF 搜尋功能。

如何排除常見的PDF顯示問題？

為什麼PDF檔案在下載而不是顯示？

如果 PDF 檔案下載而不是直接顯示，請檢查回應頭是否設定正確。 請檢查 MIME 類型是否為 application/pdf，並且 Content-Disposition 是否設定為 inline，而非 attachment：

Response.Headers.Add("Content-Disposition", "inline; filename=document.pdf");
return File(pdf.BinaryData, "application/pdf");
Response.Headers.Add("Content-Disposition", "inline; filename=document.pdf");
return File(pdf.BinaryData, "application/pdf");
Response.Headers.Add("Content-Disposition", "inline; filename=document.pdf")
Return File(pdf.BinaryData, "application/pdf")
$vbLabelText   $csharpLabel

有些代理程式和負載平衡器會剝離或修改回應標頭－使用開發者工具確認標頭是否到達瀏覽器。 對於跨域場景，請在 Program.cs 中新增 CORS 標頭，而不是在單一回應中添加，以保持配置集中化。 如果 PDF 檔案包含敏感數據，請套用PDF 簽名和密碼保護，而不是僅依賴 CORS 限制。

如何處理大型PDF文件？

對於大型文檔，串流媒體可以減輕伺服器的記憶體壓力。 使用 FileStreamResult 而不是傳回原始位元組數組：

using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(largeHtmlContent);

var stream = new MemoryStream(pdf.BinaryData);
return new FileStreamResult(stream, "application/pdf");
using IronPdf;

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(largeHtmlContent);

var stream = new MemoryStream(pdf.BinaryData);
return new FileStreamResult(stream, "application/pdf");
Imports IronPdf

Dim renderer As New ChromePdfRenderer()
Dim pdf = renderer.RenderHtmlAsPdf(largeHtmlContent)

Dim stream As New MemoryStream(pdf.BinaryData)
Return New FileStreamResult(stream, "application/pdf")
$vbLabelText   $csharpLabel

對於非常大的文檔，可以考慮使用IronPDF 的合併和拆分功能將其拆分成多個部分，並在使用者介面中實現分頁。 這樣可以保持單一 PDF 回應檔案體積小、載入速度快。 微軟的ASP.NET Core 大型檔案指南也涵蓋了與 PDF 交付相關的緩衝策略。

如何進一步使用 IronPDF？

在 ASP.NET Core 中建立 PDF 檢視器不需要複雜的第三方檢視器庫。 IronPDF 的伺服器端渲染引擎與瀏覽器原生 PDF 支援結合，為您提供了專業、可擴展且用戶端配置極少的文件檢視解決方案。 IronPDF主頁提供了完整的庫概覽和入門資源。

在此基礎上，您可以從多個方向擴展實作：

有關完整的 API 參考，請造訪IronPDF 文件。 立即開始構建，免費試用 IronPDF——無需信用卡。

!{--01001100010010010100001001010010010000010101001001011001010111110100011101000101010101 01000101111101010011010101000100000101010010010101000100010101000100010111110101011101001000110 1010101000100100001011111010100000101001001001111010001000101010101010000110101010100101010101011 10101010001010010010010010010000010100110001011111010000100100110001001111101000011010010111111010000110100101110--

常見問題解答

在 ASP.NET 應用程式中顯示 PDF 文檔的最佳方法是什麼？

使用 IronPDF 允許開發人員在 ASP.NET 應用程式中直接在瀏覽器中輕鬆呈現 PDF 文檔，提供無縫的使用者體驗，無需使用如 Adobe Acrobat Reader 之類的第三方工具。

IronPDF 可以用來增強 Web 應用程式中的 PDF 檢視嗎？

是的，IronPDF 設計用於增強 PDF 檢視，允許平滑集成到 Web 應用程式中，確保使用者可以輕鬆高效地查看 PDF 文檔。

在 ASP.NET 中使用 IronPDF 時是否需要額外的工具來查看 PDF？

不，IronPDF 消除了對如 Adobe Acrobat Reader 這樣的額外工具的需求，提供了一個內建解決方案來直接在 ASP.NET 應用程式中查看 PDF。

如何在我的 .NET Web 應用程式中實施 PDF 檢視器？

通過將 IronPDF 集成到您的 .NET Web 應用程式中，您可以實施一個支援各種 PDF 功能的強大 PDF 檢視器，並提供用戶友好的介面。

為什麼我應該在 ASP.NET 中使用 IronPDF 來查看 PDF？

IronPDF 為 ASP.NET 應用程式提供一個可靠且高效的 PDF 檢視解決方案，使開發人員能夠為用戶提供無縫的體驗，而無需依賴外部插件。

IronPDF 是否可以顯示互動式的 PDF 表單？

是的，IronPDF 支援顯示互動式 PDF 表單，允許用戶在瀏覽器中直接填寫和交互 PDF 文檔。

此文章提供全面教程，講解如何在 Azure 上部署 IronPDF 將 HTML 轉換為 PDF，強調可靠性和效率。

IronPDF 可以處理多種類型的 PDF 文檔，包括發票、報告和互動表單，使其成為任何 ASP.NET 應用程式的多功能工具。

IronPDF是否支援.NET 10的PDF生成和檢視？

是的。IronPDF完全支援.NET 10，以及較早的版本如.NET 9、8、7、6和.NET Core及Framework。這意味著您可以在現代.NET 10的ASP.NET或Blazor應用程式中使用IronPDF生成、提供和嵌入顯示PDF。 (ironpdf.com)

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau 擁有卡爾頓大學計算機科學學士學位，專注於前端開發，擅長於 Node.js、TypeScript、JavaScript 和 React。Curtis 熱衷於創建直觀且美觀的用戶界面，喜歡使用現代框架並打造結構良好、視覺吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 有著濃厚的興趣，探索將硬體和軟體結合的創新方式。在閒暇時間，他喜愛遊戲並構建 Discord 機器人，結合科技與創意的樂趣。

相關文章

30天試用→完整產品。無限制。無需信用卡。 開始免費試用

鋼鐵支援團隊

我們每週 5 天，每天 24 小時在線上。
聊天
電子郵件
打電話給我