使用IRONPDF

如何在ASP .NET中创建报告

坎那帕·乌东攀

2024年四月3日

报告对于以结构化和视觉吸引力的格式呈现数据至关重要。无论是销售数据、分析还是财务摘要，生成报告都是网页应用中的常见需求。微软提供的 RDLC 报表服务可以使用 Web Forms 报表查看器控件集成到 Web 应用程序中。然而，这个过程往往既复杂又耗时。

这就是 IronPDF 的用武之地。 IronPDF 是一个多功能库，可以简化在 ASP.NET 和其他 Web 框架中生成 PDF 报告的过程，提供强大的功能和易于使用的特性。在本文中，我们将探讨如何使用IronPDF在ASP.NET中创建报告。

如何在 ASP.NET 中创建报告

使用 Visual Studio 创建一个 ASP.NET Web 应用程序
安装 IronPDF 和 IronPDF.Extensions.MVC.Core
实例化 ChromePdfRenderer 对象发送者
调用 RenderRazorViewToPdf 方法将视图转换为 PDF
使用 Response.Headers.Append 添加“Content-Disposition”
使用File方法与PDF.BinaryData创建报告。

IronPDF 简介

IronPDF是一个多功能的库，可以简化在ASP.NET和其他Web框架中生成PDF文档的过程。其丰富的功能集和直观的API使其成为开发人员的理想选择，可以直接从其Web应用程序生成动态报告、发票、收据等。使用IronPDF，开发人员可以轻松地将HTML、CSS甚至Razor视图转换为高质量的PDF文档，从而实现报告功能在ASP.NET项目中的无缝集成。

IronPDF 的功能

HTML 转 PDF 转换：轻松将 HTML 内容（包括 CSS 样式）转换为高质量的 PDF 文档。
PDF编辑：通过添加或删除文本、图像和注释来修改现有PDF文档。
PDF表单填写：使用来自您的Web应用程序的数据动态填写PDF表单。
条形码生成：在PDF文档中生成用于产品标签或库存跟踪的条形码和二维码。
水印：在PDF页面上添加水印以保护敏感信息或品牌文档。
加密和安全：使用加密、密码和权限设置保护PDF文档。

先决条件

在开始之前，请确保您具备以下先决条件：

ASP.NET开发的基本知识。
Visual Studio在您的计算机上安装了
IronPDF 和 IronPDF.Extensions.Mvc.Core

在 Visual Studio 中创建 ASP.NET 项目的步骤

打开 Visual Studio 并创建一个新的 ASP.NET Core 项目。
选择所需的项目模板(例如，MVC 或 Razor 页面).
配置项目设置，例如项目名称、位置和框架版本。
单击“创建”以生成项目结构。

安装 IronPDF 和 IronPDF.Extensions.Mvc.Core

接下来，让我们使用 NuGet 包管理器安装 IronPDF 及其 MVC 扩展包：

通过右键单击解决方案资源管理器，打开NuGet包管理器。
搜索“IronPDF”和“IronPDF.Extensions.Mvc.Core”。
将这两个包安装到您的解决方案中。

在 ASP.NET Web 应用程序中创建报告查看器的步骤

现在，让我们深入了解在我们的ASP.NET项目中使用IronPDF创建PDF报告的步骤。在将视图转换为报告之前，我们需要一个模型、视图和控制器来创建数据源，以便创建并下载一个新的PDF格式报告。

步骤 1：定义一个模型类

首先，创建一个模型类(SalesModel.cs)表示销售数据。此示例 SalesModel 类将包含 Date、ProductName、Quantity、UnitPrice 和 TotalAmount 等属性。这在从数据源（如 Microsoft SQL Server 或 MySQL Server）检索信息时很有用。

namespace ReportGenerator.Models
{
    public class SalesModel
    {
        public DateTime Date { get; set; }
        public string ProductName { get; set; }
        public int Quantity { get; set; }
        public decimal UnitPrice { get; set; }
        public decimal TotalAmount => Quantity * UnitPrice;
    }
}

namespace ReportGenerator.Models
{
    public class SalesModel
    {
        public DateTime Date { get; set; }
        public string ProductName { get; set; }
        public int Quantity { get; set; }
        public decimal UnitPrice { get; set; }
        public decimal TotalAmount => Quantity * UnitPrice;
    }
}

Namespace ReportGenerator.Models
	Public Class SalesModel
		Public Property [Date]() As DateTime
		Public Property ProductName() As String
		Public Property Quantity() As Integer
		Public Property UnitPrice() As Decimal
		Public ReadOnly Property TotalAmount() As Decimal
			Get
				Return Quantity * UnitPrice
			End Get
		End Property
	End Class
End Namespace

步骤 2：创建一个新的 Web 窗体视图

接下来，创建一个Razor视图(Sales.cshtml)以表格形式显示销售数据，并提供生成 PDF 报告的按钮。

<!-- Index.cshtml -->
@model List<SalesModel>
<!DOCTYPE html>
<html>
<head>
    <title>Sales Report</title>
    <style>
        table {
            border-collapse: collapse;
            width: 100%;
        }
        th, td {
            border: 1px solid #dddddd;
            text-align: left;
            padding: 8px;
        }
        th {
            background-color: #f2f2f2;
        }
    </style>
</head>
<body>
    <h2>Sales Report</h2>
    <table>
        <tr>
            <th>Date</th>
            <th>Product Name</th>
            <th>Quantity</th>
            <th>Unit Price</th>
            <th>Total Amount</th>
        </tr>
        @foreach (var item in Model)
        {
            <tr>
                <td>@item.Date.ToShortDateString()</td>
                <td>@item.ProductName</td>
                <td>@item.Quantity</td>
                <td>@item.UnitPrice.ToString("C")</td>
                <td>@item.TotalAmount.ToString("C")</td>
            </tr>
        }
    </table>
    <br />
    @using (Html.BeginForm("GeneratePdf", "Sales", FormMethod.Post))
    {
        <button type="submit">Generate PDF Report</button>
    }
</body>
</html>

<!-- Index.cshtml -->
@model List<SalesModel>
<!DOCTYPE html>
<html>
<head>
    <title>Sales Report</title>
    <style>
        table {
            border-collapse: collapse;
            width: 100%;
        }
        th, td {
            border: 1px solid #dddddd;
            text-align: left;
            padding: 8px;
        }
        th {
            background-color: #f2f2f2;
        }
    </style>
</head>
<body>
    <h2>Sales Report</h2>
    <table>
        <tr>
            <th>Date</th>
            <th>Product Name</th>
            <th>Quantity</th>
            <th>Unit Price</th>
            <th>Total Amount</th>
        </tr>
        @foreach (var item in Model)
        {
            <tr>
                <td>@item.Date.ToShortDateString()</td>
                <td>@item.ProductName</td>
                <td>@item.Quantity</td>
                <td>@item.UnitPrice.ToString("C")</td>
                <td>@item.TotalAmount.ToString("C")</td>
            </tr>
        }
    </table>
    <br />
    @using (Html.BeginForm("GeneratePdf", "Sales", FormMethod.Post))
    {
        <button type="submit">Generate PDF Report</button>
    }
</body>
</html>

HTML

现在，在 "视图"->"共享 "文件夹下的_Layout.cshtml文件中将 "销售 "添加为菜单项，以创建报告向导视图：

<li class="nav-item">
    <a class="nav-link text-dark" asp-area="" asp-controller="Sales" asp-action="Sales">Sales</a>
</li>

<li class="nav-item">
    <a class="nav-link text-dark" asp-area="" asp-controller="Sales" asp-action="Sales">Sales</a>
</li>

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'<li class="nav-item"> <a class="nav-link text-dark" asp-area="" asp-controller="Sales" asp-action="Sales"> Sales</a> </li>

如何在 ASP .NET 中创建报告：图 4

步骤 3：注册视图渲染服务

在 Program.cs 文件中注册视图渲染服务对于依赖注入的正常运行至关重要。将以下代码添加到 Program.cs 文件中以注册 IRazorViewRenderer 服务：

// Register the IRazorViewRenderer service
builder.Services.AddSingleton<IRazorViewRenderer, RazorViewRenderer>();

// Register the IRazorViewRenderer service
builder.Services.AddSingleton<IRazorViewRenderer, RazorViewRenderer>();

' Register the IRazorViewRenderer service
builder.Services.AddSingleton(Of IRazorViewRenderer, RazorViewRenderer)()

步骤 3：实现 Web API 控制器类

实现控制器(SalesController.cs)执行操作以渲染销售视图并生成 PDF 报告。将 IronPDF 提供的 IRazorViewRenderer 服务注入控制器构造函数中。

using ReportGenerator.Models;
namespace ReportGenerator.Controllers
{
    public class SalesController : Controller
    {
        private readonly IRazorViewRenderer _viewRenderService;
        private readonly List<SalesModel> salesData;
        public SalesController(IRazorViewRenderer viewRenderService)
        {
            _viewRenderService = viewRenderService;
            // Example data with sales information
            salesData = new List<SalesModel>
            {
                new SalesModel { Date = DateTime.Parse("2024-03-01"), ProductName = "Product A", Quantity = 10, UnitPrice = 50.00m },
                new SalesModel { Date = DateTime.Parse("2024-03-02"), ProductName = "Product B", Quantity = 15, UnitPrice = 40.00m },
                new SalesModel { Date = DateTime.Parse("2024-03-03"), ProductName = "Product C", Quantity = 20, UnitPrice = 30.00m }
                // Add more data as needed
            };
        }
        public IActionResult Sales()
        {
        // Renders the data in Sales view
            return View(salesData);
        }
    }
}

using ReportGenerator.Models;
namespace ReportGenerator.Controllers
{
    public class SalesController : Controller
    {
        private readonly IRazorViewRenderer _viewRenderService;
        private readonly List<SalesModel> salesData;
        public SalesController(IRazorViewRenderer viewRenderService)
        {
            _viewRenderService = viewRenderService;
            // Example data with sales information
            salesData = new List<SalesModel>
            {
                new SalesModel { Date = DateTime.Parse("2024-03-01"), ProductName = "Product A", Quantity = 10, UnitPrice = 50.00m },
                new SalesModel { Date = DateTime.Parse("2024-03-02"), ProductName = "Product B", Quantity = 15, UnitPrice = 40.00m },
                new SalesModel { Date = DateTime.Parse("2024-03-03"), ProductName = "Product C", Quantity = 20, UnitPrice = 30.00m }
                // Add more data as needed
            };
        }
        public IActionResult Sales()
        {
        // Renders the data in Sales view
            return View(salesData);
        }
    }
}

Imports ReportGenerator.Models
Namespace ReportGenerator.Controllers
	Public Class SalesController
		Inherits Controller

		Private ReadOnly _viewRenderService As IRazorViewRenderer
		Private ReadOnly salesData As List(Of SalesModel)
		Public Sub New(ByVal viewRenderService As IRazorViewRenderer)
			_viewRenderService = viewRenderService
			' Example data with sales information
			salesData = New List(Of SalesModel) From {
				New SalesModel With {
					.Date = DateTime.Parse("2024-03-01"),
					.ProductName = "Product A",
					.Quantity = 10,
					.UnitPrice = 50.00D
				},
				New SalesModel With {
					.Date = DateTime.Parse("2024-03-02"),
					.ProductName = "Product B",
					.Quantity = 15,
					.UnitPrice = 40.00D
				},
				New SalesModel With {
					.Date = DateTime.Parse("2024-03-03"),
					.ProductName = "Product C",
					.Quantity = 20,
					.UnitPrice = 30.00D
				}
			}
		End Sub
		Public Function Sales() As IActionResult
		' Renders the data in Sales view
			Return View(salesData)
		End Function
	End Class
End Namespace

在上述代码中，在构造函数内部，IRazorViewRenderer 服务被分配给私有字段 _viewRenderService。此外，控制器初始化了一个名为salesData的列表，其中包含SalesModel类的实例，代表用于演示目的的销售信息。

销售()操作方法返回一个名为“Sales”的视图，传递salesData**列表作为模型。此操作负责在相关视图中呈现销售数据，允许用户以表格格式或任何其他所需布局来可视化销售信息。

如何在 ASP .NET 中创建报告：图 5

步骤 4：生成 PDF 报告

在控制器的GeneratePdf操作中，使用IronPDF的ChromePdfRenderer进行渲染。将Razor视图转换为PDF**报告文件。设置适当的响应头并将PDF文件返回给客户端。

public FileContentResult GeneratePdf()
{
    License.LicenseKey = "YOUR-LICENSE-KEY-HERE";
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    // Render View to PDF document
    PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Sales/Sales.cshtml", salesData);
    Response.Headers.Append("Content-Disposition", "inline");
    // Output PDF document
    return File(pdf.BinaryData, "application/pdf", "SalesReport.pdf");
}

public FileContentResult GeneratePdf()
{
    License.LicenseKey = "YOUR-LICENSE-KEY-HERE";
    ChromePdfRenderer renderer = new ChromePdfRenderer();
    // Render View to PDF document
    PdfDocument pdf = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Sales/Sales.cshtml", salesData);
    Response.Headers.Append("Content-Disposition", "inline");
    // Output PDF document
    return File(pdf.BinaryData, "application/pdf", "SalesReport.pdf");
}

Public Function GeneratePdf() As FileContentResult
	License.LicenseKey = "YOUR-LICENSE-KEY-HERE"
	Dim renderer As New ChromePdfRenderer()
	' Render View to PDF document
	Dim pdf As PdfDocument = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Sales/Sales.cshtml", salesData)
	Response.Headers.Append("Content-Disposition", "inline")
	' Output PDF document
	Return File(pdf.BinaryData, "application/pdf", "SalesReport.pdf")
End Function

让我们详细了解上述代码的工作原理：

许可证密钥设置：
- License.LicenseKey = "YOUR-LICENSE-KEY-HERE";
- 此行设置IronPDF所需的许可证密钥。在应用程序中使用IronPDF功能是至关重要的。
渲染器初始化：

ChromePdfRenderer renderer = new ChromePdfRenderer();
- 创建了一个 ChromePdfRenderer 实例。此渲染器负责使用Chromium浏览器引擎将Razor视图转换为PDF格式。

将视图渲染为PDF：

PdfDocument PDF = renderer.RenderRazorViewToPdf(_viewRenderService, "Views/Sales/Sales.cshtml", salesData);
- RenderRazorViewToPdf() 调用ChromePdfRenderer的方法来渲染指定的Razor视图(Views/Sales/Sales.cshtml)转换为PDF文档。 salesData 变量作为视图的模型。

Content-Disposition 标头：
- Response.Headers.Append("内容处置"，"内联");**
- HTTP响应头Content-Disposition设置为"inline"。这指示浏览器直接显示PDF内容，以便在打开时在浏览器窗口或选项卡内查看报告。
返回PDF文件：
- 返回文件(pdf.BinaryData、"application/pdf"、"SalesReport.pdf");
- PDF 文档内容以 FileContentResult 返回。它包括 PDF 的二进制数据。(pdf.BinaryData)，指定 MIME 类型为 "application/pdf"，并建议文件名为 "SalesReport.pdf"。
总体而言，这种方法有效地协调了从 Razor 视图生成 PDF 报告的过程，使其适合在 ASP.NET 应用程序中进行集成，以增强报告功能。
有关 IronPDF 如何简化 PDF 报告生成和其他 PDF 相关任务的详细信息，请访问文件page.

结论

在本文中，我们探讨了IronPDF如何简化在ASP.NET应用程序中生成PDF报告的过程。按照上面提供的分步指南，您可以快速将IronPDF集成到您的ASP.NET项目中，并轻松生成动态PDF报告。

凭借其丰富的功能集和无缝集成，IronPDF使开发人员能够创建满足用户和企业需求的专业级报告。

IronPDF 提供一个免费试用. 从以下网址下载资料库*这里***并试一试。

坎那帕·乌东攀

立即与工程团队聊天

软件工程师

在成为软件工程师之前，Kannapat 从日本北海道大学完成了环境资源博士学位。在攻读学位期间，Kannapat 还成为了生物生产工程系车辆机器人实验室的成员。2022年，他利用自己的 C# 技能加入了 Iron Software 的工程团队，专注于 IronPDF。Kannapat 珍视他的工作，因为他能直接向编写 IronPDF 大部分代码的开发者学习。除了同伴学习，Kannapat 还享受在 Iron Software 工作的社交方面。不写代码或文档时，Kannapat 通常在 PS5 上玩游戏或重看《最后生还者》。

< 前一页
如何在C#中创建报表应用程序

下一步 >
如何从PDF文档解析数据