訊息圖示
跳過到頁腳內容
  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 表單，使用者都希望獲得流暢的文件檢視體驗，而無需 Adob​​e 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 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";
$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");
$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");
$vbLabelText   $csharpLabel

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

PDF 檢視器 Web 應用程序，顯示IronPDF for .NET文檔，頂部有

如何將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");
$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");
}
$vbLabelText   $csharpLabel

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

PdfViewerApp 的螢幕截圖，顯示 PDF 檢視器，其中顯示

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

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");
$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");
$vbLabelText   $csharpLabel

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

如何進一步使用IronPDF？

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

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

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

立即開始在您的項目中使用 IronPDF 並免費試用。

第一步：
green arrow pointer

常見問題解答

在 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 天試用→完整產品。無限制。無需信用卡。 開始免費試用

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me