How to view PDF files in ASP.NET using C# and IronPDF

設定 IronPDF 庫

安裝該庫有兩種方法；

Install-Package IronPdf

using IronPdf;

using IronPdf;

使用 .NET C# 從 HTML 字串建立 PDF 文件

在 C# 中，從 HTML 字串建立 PDF 檔案是一種高效且有益的建立新 PDF 檔案的方法。

ChromePdfRenderer中的RenderHtmlAsPdf函數提供了一種簡單的方法，可以將任何 HTML (HTML5) 字串轉換為 PDF 文檔，這要歸功於 IronPDF DLL 中嵌入的 Google Chromium 引擎版本。

// Create a renderer to convert HTML to PDF
var renderer = new ChromePdfRenderer();

// Convert an HTML string to a PDF
using var renderedPdf = renderer.RenderHtmlAsPdf("<h1>My First HTML to Pdf</h1>");

// Define the output path for the PDF
var outputPath = "My_First_Html.pdf";

// Save the rendered PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Automatically open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

// Create a renderer to convert HTML to PDF
var renderer = new ChromePdfRenderer();

// Convert an HTML string to a PDF
using var renderedPdf = renderer.RenderHtmlAsPdf("<h1>My First HTML to Pdf</h1>");

// Define the output path for the PDF
var outputPath = "My_First_Html.pdf";

// Save the rendered PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Automatically open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

RenderHtmlAsPdf是一個功能強大的工具，它全面支援 CSS、JavaScript 和圖片。 如果這些材質儲存在硬碟上，則可能需要設定RenderHtmlAsPdf的第二個參數。

以下程式碼將產生一個PDF檔案：

// Render HTML to PDF with a base path for local assets
var renderPdf = renderer.RenderHtmlAsPdf("<img src='image_1.png'/>", @"C:\Newproject");

// Render HTML to PDF with a base path for local assets
var renderPdf = renderer.RenderHtmlAsPdf("<img src='image_1.png'/>", @"C:\Newproject");

所有引用的 CSS 樣式表、圖片和 JavaScript 檔案都將相對於BaseUrlPath ，從而可以保持更有序、更符合邏輯的結構。 當然，您也可以使用網路上提供的圖片、樣式表和資源，例如 Web Fonts、Google Fonts，甚至 jQuery。

使用現有 HTML URL 建立 PDF 文檔

可以使用 C# 有效率地將現有 URL 渲染成 PDF； 這也使得團隊能夠將 PDF 設計和後端 PDF 渲染工作分配到各個部門，這是有益的。

以下程式碼示範如何根據 URL 渲染 endeavorcreative.com 頁面：

// Create a renderer for converting URLs to PDF
var renderer = new ChromePdfRenderer();

// Convert the specified URL to a PDF
using var renderedPdf = renderer.RenderUrlAsPdf("https://endeavorcreative.com/setting-up-wordpress-website-from-scratch/");

// Specify the output path for the PDF
var outputPath = "Url_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

// Create a renderer for converting URLs to PDF
var renderer = new ChromePdfRenderer();

// Convert the specified URL to a PDF
using var renderedPdf = renderer.RenderUrlAsPdf("https://endeavorcreative.com/setting-up-wordpress-website-from-scratch/");

// Specify the output path for the PDF
var outputPath = "Url_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

因此，生成的 PDF 中保留了所有超連結（HTML 連結）甚至 HTML 表單。

從現有 HTML 文件建立 PDF 文檔

本節介紹如何渲染任何本機 HTML 檔案。文件似乎已使用 file:/ 協定打開，所有相關資源（例如 CSS、圖片和 JavaScript 等）都是如此。

// Create a renderer for existing HTML files
var renderer = new ChromePdfRenderer();

// Render an HTML file to PDF
using var renderedPdf = renderer.RenderHtmlFileAsPdf("Assets/test1.html");

// Specify the output path for the PDF
var outputPath = "test1_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

// Create a renderer for existing HTML files
var renderer = new ChromePdfRenderer();

// Render an HTML file to PDF
using var renderedPdf = renderer.RenderHtmlFileAsPdf("Assets/test1.html");

// Specify the output path for the PDF
var outputPath = "test1_pdf.pdf";

// Save the PDF to the specified path
renderedPdf.SaveAs(outputPath);

// Open the newly created PDF
System.Diagnostics.Process.Start(outputPath);

這種策略的優點在於，它允許開發人員在創建 HTML 內容的同時，在瀏覽器中測試其效果。 IronPDF的渲染引擎是基於Chrome瀏覽器建構。 因此，建議使用XML 轉換 PDF 轉換，因為可以使用 XSLT 範本將 XML 內容列印到 PDF。

將 ASP.NET Web 表單轉換為 PDF 文件

只需一行程式碼，即可將 ASP.NET 線上表單轉換為 PDF 格式而不是 HTML 格式。 將這行程式碼放在頁面後台程式碼檔案的Page_Load方法中，使其顯示在頁面上。

ASP.NET Web Forms 應用程式既可以從頭開始創建，也可以從先前的版本開啟。

如果尚未安裝，請安裝 NuGet 套件。

應該使用using關鍵字匯入IronPdf命名空間。

找到要轉換為 PDF 的頁面的後台程式碼。 例如，使用 ASP.NET 的Default.aspx.cs檔案。

RenderThisPageAsPdf是AspxToPdf類別中的一個方法。

using IronPdf;
using System;
using System.Web.UI;

namespace WebApplication7
{
    public partial class _Default : Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            // Render the current page as a PDF in the browser
            AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
        }
    }
}

using IronPdf;
using System;
using System.Web.UI;

namespace WebApplication7
{
    public partial class _Default : Page
    {
        protected void Page_Load(object sender, EventArgs e)
        {
            // Render the current page as a PDF in the browser
            AspxToPdf.RenderThisPageAsPdf(AspxToPdf.FileBehavior.InBrowser);
        }
    }
}

這需要安裝IronPdf.Extensions.ASPX NuGet 套件。 由於 ASPX 已被 MVC 模型取代，因此它在 .NET Core 中不可用。

應用 HTML 模板

對於企業內部網路和網站開發人員來說，能夠建立範本或"批量產生"PDF文件是一項標準必備技能。

IronPDF 庫並非建立 PDF 文件模板，而是利用現有的、經過充分測試的技術來產生 HTML 模板。

如下所示，當 HTML 範本補充來自查詢字串或資料庫的資料時，就會建立一個動態產生的 PDF 檔案。

例如，考慮一下 C# String 類別及其屬性。 Format 方法適用於基本的"郵件合併"操作。

// Basic HTML String Formatting
string formattedString = String.Format("<h1>Hello {0}!</h1>", "World");

// Basic HTML String Formatting
string formattedString = String.Format("<h1>Hello {0}!</h1>", "World");

由於 HTML 檔案可能非常龐大，因此通常會使用任意佔位符，例如 [[NAME]]，然後用實際資料取代它們。

以下範例將產生三個 PDF 文檔，每個文檔都將為不同的使用者進行自訂。

// Define an HTML template with a placeholder
var htmlTemplate = "<p>[[NAME]]</p>";

// Sample data to replace placeholders
var names = new[] { "John", "James", "Jenny" };

// Create a new PDF for each name
foreach (var name in names)
{
    // Replace placeholder with actual name
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Create a renderer and render the HTML as PDF
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save the PDF with the name in the filename
    pdf.SaveAs($"{name}.pdf");
}

// Define an HTML template with a placeholder
var htmlTemplate = "<p>[[NAME]]</p>";

// Sample data to replace placeholders
var names = new[] { "John", "James", "Jenny" };

// Create a new PDF for each name
foreach (var name in names)
{
    // Replace placeholder with actual name
    var htmlInstance = htmlTemplate.Replace("[[NAME]]", name);

    // Create a renderer and render the HTML as PDF
    var renderer = new ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(htmlInstance);

    // Save the PDF with the name in the filename
    pdf.SaveAs($"{name}.pdf");
}

ASP.NET MVC 路由：下載此頁面的 PDF 版本

使用 ASP.NET MVC 框架，您可以引導使用者存取 PDF 檔案。

建立新的 ASP.NET MVC 應用程式或將現有 MVC 控制器新增至現有應用程式時，請選擇此選項。 從下拉式功能表中選擇 ASP.NET Web 應用程式 (.NET Framework) > MVC，啟動 Visual Studio 新專案精靈。 或者，您可以開啟一個現有的 MVC 專案。 取代 Controllers 資料夾中 HomeController 檔案中的 Index 方法，或在 Controllers 資料夾中建立新的控制器。

以下是程式碼編寫範例：

using IronPdf;
using System;
using System.Web.Mvc;

namespace WebApplication8.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            // Render a URL as PDF and return it in the response
            using var pdf = HtmlToPdf.StaticRenderUrlAsPdf(new Uri("https://en.wikipedia.org"));
            return File(pdf.BinaryData, "application/pdf", "Wiki.Pdf");
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";
            return View();
        }

        public ActionResult Contact()
        {
            ViewBag.Message = "Your contact page.";
            return View();
        }
    }
}

using IronPdf;
using System;
using System.Web.Mvc;

namespace WebApplication8.Controllers
{
    public class HomeController : Controller
    {
        public ActionResult Index()
        {
            // Render a URL as PDF and return it in the response
            using var pdf = HtmlToPdf.StaticRenderUrlAsPdf(new Uri("https://en.wikipedia.org"));
            return File(pdf.BinaryData, "application/pdf", "Wiki.Pdf");
        }

        public ActionResult About()
        {
            ViewBag.Message = "Your application description page.";
            return View();
        }

        public ActionResult Contact()
        {
            ViewBag.Message = "Your contact page.";
            return View();
        }
    }
}

為 PDF 文件新增封面頁

如何在 ASP.NET 中使用 C# 和 IronPDF 查看 PDF 文件，圖 1：為 PDF 文件新增封面頁

IronPDF簡化了PDF文件合併流程。 該技術最常見的應用是在已渲染的 PDF 文件中添加封面或封底。

為此，請準備封面頁，然後使用PdfDocument功能。

若要合併這兩個文檔，請使用Merge PDF Documents Method 。

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf/");

// Merge the cover page with the rendered PDF
using var merged = PdfDocument.Merge(new PdfDocument("CoverPage.pdf"), pdf);

// Save the merged document
merged.SaveAs("Combined.Pdf");

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf/");

// Merge the cover page with the rendered PDF
using var merged = PdfDocument.Merge(new PdfDocument("CoverPage.pdf"), pdf);

// Save the merged document
merged.SaveAs("Combined.Pdf");

為文件添加浮水印

最後，使用 C# 程式碼可以實現為 PDF 文件添加浮水印； 這可以用來在文件的每一頁上添加免責聲明，聲明它是"機密的"或"樣本"。

// Prepare a stamper with HTML content for the watermark
HtmlStamper stamper = new HtmlStamper("<h2 style='color:red'>SAMPLE</h2>")
{
    HorizontalOffset = new Length(-3, MeasurementUnit.Inch),
    VerticalAlignment = VerticalAlignment.Bottom
};

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf");

// Apply the watermark to the PDF
pdf.ApplyStamp(stamper);

// Save the watermarked PDF
pdf.SaveAs(@"C:\PathToWatermarked.pdf");

// Prepare a stamper with HTML content for the watermark
HtmlStamper stamper = new HtmlStamper("<h2 style='color:red'>SAMPLE</h2>")
{
    HorizontalOffset = new Length(-3, MeasurementUnit.Inch),
    VerticalAlignment = VerticalAlignment.Bottom
};

// Create a renderer and render a PDF from a URL
var renderer = new ChromePdfRenderer();
using var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf");

// Apply the watermark to the PDF
pdf.ApplyStamp(stamper);

// Save the watermarked PDF
pdf.SaveAs(@"C:\PathToWatermarked.pdf");

您可以使用密碼保護您的PDF檔案

當您設定 PDF 文件的密碼屬性時，該文件將被加密，使用者需要提供正確的密碼才能閱讀該文件。 此範例可用於 .NET Core 控制台應用程式。

using IronPdf;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a renderer and render a PDF from HTML
            var renderer = new ChromePdfRenderer();
            using var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

            // Set password to protect the PDF
            pdfDocument.Password = "strong!@#pass&^%word";

            // Save the secured PDF
            pdfDocument.SaveAs("secured.pdf");
        }
    }
}

using IronPdf;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a renderer and render a PDF from HTML
            var renderer = new ChromePdfRenderer();
            using var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World</h1>");

            // Set password to protect the PDF
            pdfDocument.Password = "strong!@#pass&^%word";

            // Save the secured PDF
            pdfDocument.SaveAs("secured.pdf");
        }
    }
}

即使不具備上述優勢，使用 IronPDF 您還可以：

從PDF文件中提取圖像和文本 編輯PDF檔案的HTML內容

• 增強前景和背景圖像 為PDF檔案新增數位簽名 快速輕鬆地自動填寫您的PDF表單

建立 PDF 文件是一項極具挑戰性的工作； 有些人可能從未接觸過製作出最優秀文件應該採用的基本概念。 因此，IronPDF 非常有用，因為它簡化了 PDF 的創建，從而改善了從 PDF 和 HTML 創建的文件的原始呈現效果。

根據文件和競爭對手分析中提供的資訊：IronPDF 是創建 PDF 時最有效的工具，它使任何人，包括在辦公室或學校工作的人員，都能輕鬆有效地完成任務。

圖 2：如何在 ASP.NET 中使用 C# 和 IronPDF 檢視 PDF 文件

IronPDF 是一個必備的 .NET 函式庫。 立即取得並使用 IronPDF NuGet 套件進行試用。