IRONSOFTWAREHOME
使用IRONPDF

ASP PDF 查看器(开发者教程)

Curtis Chau
Curtis Chau
Updated: 2026年4月23日

PDF文件被广泛用于文档共享和数据展示。 在Web应用程序中,经常需要直接在浏览器中向用户展示PDF文件。 ASP.NET Core应用程序提供了多种选项来实现这种功能,其中一个流行的用于处理PDF文件的库是IronPDF。

IronPDF是一个强大的.NET库,使开发人员能够轻松创建、编辑和操作PDF。 本文将探讨如何在ASP.NET Core的PDF查看器应用程序中使用IronPDF显示PDF文件。 它将介绍设置必要组件的步骤,并提供示例逻辑以演示ASP.NET Core PDF查看器的集成。

环境设置

要开始,请确保您具备以下先决条件:

  1. Visual Studio:安装最新版本的Visual Studio或您选择的任何其他兼容的集成开发环境 (IDE)。

  2. IronPDF库:从IronPDF官方网站或通过NuGet包管理器获取IronPDF库。

    如何在ASP.NET Core中显示PDF文件,图1:NuGet包管理器 NuGet包管理器

  3. .NET Core应用程序:确保您对ASP.NET Core设置说明有基本的了解,并已在您的开发机器上安装。

一旦您设置了环境,让我们深入了解使用IronPDF在ASP.NET Core应用程序中显示PDF文件的步骤。

创建一个新项目

  1. 打开Visual Studio并创建一个新的 ASP.NET Core Web App 项目。

    如何在ASP.NET Core中显示PDF文件,图2:Web应用程序 Web应用程序

  2. 选择"ASP.NET Core Web App"模板。

    如何在ASP.NET Core中显示PDF文件,图3:.NET Framework .NET框架

  3. 选择所需的项目设置并点击"创建"以生成新项目。

添加IronPDF库

要在您的项目中使用IronPDF,您需要添加IronPDF库引用。

  1. 在解决方案资源管理器中右键点击项目,选择"为解决方案管理NuGet包..."

    如何在ASP.NET Core中显示PDF文件,图4:NuGet包管理器 NuGet包管理器

  2. 在NuGet包管理器中搜索"IronPDF"并安装最新版本的包。

    如何在ASP.NET Core中显示PDF文件,图5:NuGet包管理器 - 解决方案资源管理器 NuGet包管理器 - 解决方案资源管理器

使用ASP.NET Core网页创建PDF

要从服务器端的ASP.NET Core网页创建一个PDF,请按以下步骤操作:

如何在ASP.NET Core中显示PDF文件,图6:NuGet包管理器 - 解决方案资源管理器 解决方案资源管理器

步骤1 添加IronPDF命名空间

打开要转换为PDF的ASP.NET Core网页的源文件路径。 在代码隐藏文件(IronPdf命名空间:

using IronPdf;

步骤2 将Razor页面转换为PDF

在OnGet函数内部,添加以下代码:

public FileContentResult OnGet()
{
    // Create a new instance of ChromePdfRenderer
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    
    // Render the current Razor page to a PDF document
    PdfDocument pdf = renderer.RenderRazorToPdf(this);

    // Add HTTP header to display PDF in the browser
    Response.Headers.Add("Content-Disposition", "inline");
    
    // Return the PDF file to the client
    return File(pdf.BinaryData, "application/pdf");
}

只需一行代码,Razor页面将使用RenderRazorToPdf方法转换为PDF文档。

要实现这一功能,需要安装IronPdf.Extensions.Razor NuGet包。

步骤3 显示或下载PDF

默认情况下,代码将在浏览器中显示PDF文档。 如果您希望下载PDF,请修改代码如下:

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

此代码将把ASP.NET网页的PDF文件下载到您的本地"下载"文件夹中。

如何在ASP.NET Core中显示PDF文件,图7:ASPX页面转为PDF Razor页面转PDF

在ASP.NET Core中加载和显示PDF文件

接下来,本节将探讨使用IronPDF在ASP.NET Core应用程序中生成和显示PDF文件的不同方法。

从URL生成PDF

IronPDF通过生成HTML文件并将其转换为PDF,简化了创建PDF文档的过程。 以下代码演示了如何从URL生成PDF文件:

// Render a PDF from a URL
using var pdf = new IronPdf.ChromePdfRenderer().RenderUrlAsPdf("https://www.google.co.in/");

// Read the File as Byte Array
byte[] bytes = pdf.BinaryData;

// Convert File to Base64 string and send to Client
string base64 = Convert.ToBase64String(bytes, 0, bytes.Length);
return Content(base64);

在上述代码中,IronPDF的ChromePdfRenderer类用于从指定的URL渲染HTML内容并将其转换为PDF文档。 然后将PDF文档转换为字节数组,并作为base64字符串发送给客户端。

从HTML字符串生成PDF

IronPDF提供了一种有效的方法将HTML字符串转换为PDF文档。 下面的代码片段展示了如何从字符串生成PDF文件:

// Render a PDF from an HTML string
using var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlAsPdf("<h1>Hello world!!</h1>");

在上述示例中,使用RenderHtmlAsPdf方法来渲染HTML字符串并将其转换为PDF文档。 生成的PDF可以根据应用程序的要求进一步处理或保存。

如何在ASP.NET Core中显示PDF文件,图8:Web应用程序输出 Web应用程序输出

从HTML文件生成PDF

IronPDF还支持将HTML文件或CSS文件转换为PDF文档示例。 以下代码展示了如何从HTML文件生成PDF文件:

// Render a PDF from an HTML file
using var pdf = new IronPdf.ChromePdfRenderer().RenderHtmlFileAsPdf("demo.html");

// Read the file as Byte Array
byte[] bytes = pdf.BinaryData;

// Convert File to Base64 string and send to Client
string base64 = Convert.ToBase64String(bytes, 0, bytes.Length);
return Content(base64);

在上面的代码片段中,使用RenderHtmlFileAsPdf方法从指定文件名渲染HTML内容并将其转换为PDF文档。 生成的PDF被转换为字节数组,并作为base64字符串发送给客户端。

如何在ASP.NET Core中显示PDF文件:图9 - 添加新网页

使用IronPDF通过ASP.NET Web API将ASP.NET Web表单转换为PDF文件

您可以通过一行代码将ASP.NET Web Forms轻松转换为PDF格式,而不是HTML。 将此代码放在页面代码隐藏文件的Page_Load方法中以将其显示在页面上。

导入IronPdf命名空间

在代码隐藏文件中使用IronPdf命名空间。

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

将ASP.NET Web表单转换为PDF

在您想要转为PDF的页面的代码隐藏文件中(例如,Default.aspx.cs),添加以下代码:

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

AspxToPdf类中从Web API将Web表单转换为PDF文档。

应用HTML模板

对于公司内联网和网站开发人员来说,使用模板生成PDF通常是一个常见的要求。 IronPDF使这一过程变得简单,通过允许您生成HTML模板并用数据填充。

以下是如何使用HTML模板和IronPDF生成多个定制PDF的示例:

// Define an HTML template with placeholders
string HtmlTemplate = "<p>[[NAME]]</p>";
string[] Names = { "John", "James", "Jenny" };
foreach (var name in Names)
{
    // Replace placeholder in template with actual data
    string HtmlInstance = HtmlTemplate.Replace("[[NAME]]", name);
    
    // Render HTML to PDF
    using (var Pdf = Renderer.RenderHtmlAsPdf(HtmlInstance))
    {
        // Save the PDF with the name as filename
        Pdf.SaveAs(name + ".pdf");
    }
}

ASP MVC 路由 下载本页的PDF版本

如果您使用ASP.NET MVC,您可以轻松将用户引导至PDF文件。以下是源代码应该怎样写的示例:

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

namespace WebApplication8.Controllers
{
    public class HomeController : Controller
    {
        public IActionResult Index()
        {
            // Create a new instance of ChromePdfRenderer
            ChromePdfRenderer renderer = new ChromePdfRenderer();
            
            // Render the URL as a PDF
            using (var PDF = renderer.RenderUrlAsPdf(new Uri("https://en.wikipedia.org")))
            {
                // Return the PDF file with a specified filename
                return File(PDF.BinaryData, "application/pdf", "Wiki.Pdf");
            }
        }
        // Other action methods...
    }
}

向PDF文档添加封面

要为现有的PDF文档添加封面页或封底页,您可以使用IronPDF的合并功能。 下面是一个例子:

using (var PDF = Renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf/"))
{
    // Merge the cover page with the main PDF
    using (var Merged = PdfDocument.Merge(new PdfDocument("CoverPage.pdf"), PDF))
    {
        // Save the combined PDF
        Merged.SaveAs("Combined.Pdf");
    }
}

向您的文档添加水印

您还可以使用C#代码为PDF文档添加水印。 下面是一个例子:

using IronPdf;

// Create a new instance of ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render the URL as a PDF
using (var pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf"))
{
    // Add watermark text to all pages
    pdf.WatermarkAllPages("<h2 style='color:red'>SAMPLE</h2>", PdfDocument.WaterMarkLocation.MiddleCenter, 50, -45);
    
    // Save the watermarked PDF
    pdf.SaveAs(@"C:\PathToWatermarked.pdf");
}

使用密码保护您的PDF

您可以使用 IronPDF 对 PDF 文档进行密码加密和保护。 下面是一个例子:

using IronPdf;

// Create a new instance of ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

// Render HTML to PDF
using (var pdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello World<h1>"))
{
    // Set a password to protect the PDF
    pdfDocument.Password = "strong!@#pass&^%word";
    
    // Save the secured PDF
    pdfDocument.SaveAs("secured.pdf");
}

除了上述功能外,IronPDF还提供其他功能,例如从PDF中提取图像和文本与OCR,将图表渲染为PDF,向PDF添加条形码,使用密码提高文档安全性,以及PDF的水印技术,甚至处理和自定义PDF表单,等等。 使用IronPDF,您可以简化创建PDF的过程,并改进文档整体呈现。

结论

IronPDF是一款专为.NET开发人员设计的出色工具,提供广泛的功能以轻松处理.NET项目中的PDF操作。 使用IronPDF,开发人员可以提升其工作流程并简化其工作过程。 这个强大的工具提供了无数功能,使得PDF文件格式化、页面删除、页面添加等无缝连接。 它使开发人员能够根据他们的具体要求有效管理和自定义PDF文档。

IronPDF不仅在功能上表现出色,还具有在开发过程中免费使用的附加优势。 这意味着开发人员可以在项目开发阶段利用它的能力而无需承担任何费用。 通过使用IronPDF,开发人员可以提高他们的生产力,并在与PDF相关的任务中取得显著效果,最终在他们的.NET项目中提供高质量和高效的解决方案。

还有许多其他有用的库,如IronPDF用于处理PDF文档,IronXL用于处理Excel文档,而IronOCR用于处理OCR。 目前,您只需购买完整的Iron Suite,即可以两库的价格获得所有五个库。访问我们的Iron Software许可信息以获取更多详细信息。

Curtis Chau
技术作家

Curtis Chau 拥有卡尔顿大学的计算机科学学士学位,专注于前端开发,精通 Node.js、TypeScript、JavaScript 和 React。他热衷于打造直观且美观的用户界面,喜欢使用现代框架并创建结构良好、视觉吸引力强的手册。

...
阅读更多

相关文章

Key in blue circle

立即获取免费的 30 天试用版密钥。

Your trial license will be sent to your email address

无任何限制。100% 解锁。无需信用卡。

OR
bullet_checked无需信用卡或创建账户无任何限制。100% 解锁。无需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
预约您的免费现场演示
Booking Badge

深受全球数百万工程师信赖

Iron Software 的客户徽标
获取您的无义务咨询
填写下面的表格或通过sales@ironsoftware.com
您的资料将始终保密。
深受全球数百万工程师信赖
Iron Software 的客户徽标
立即获取您的免费30 天试用密钥。
无需信用卡或创建账户
C# 用于 PDF 的 NuGet 库
通过 NuGet 安装

版本: 2026.9

PM > Install-Package IronPdf
nuget.org/packages/IronPdf/
  1. 在解决方案资源管理器中,右键点击引用,管理 NuGet 包
  2. 选择浏览并搜索 “IronPDF”
  3. 选择包并安装
C# PDF DLL
下载 DLL

版本: 2026.9

或在此处下载 Windows 安装程序。

  1. 下载并解压 IronPDF 到您的解决方案目录中的 ~/Libs 之类的位置
  2. 在 Visual Studio 解决方案资源管理器中,右键点击引用。选择浏览,“IronPDF.dll”

$999 起