如何在ASP.NET中使用C#将HTML转换为PDF

如何在ASP.NET中使用IronPDF将HTML转换为PDF

1. 使用Visual Studio或您选择的IDE创建一个ASP.NET项目。
2. 安装IronPDF并设置您的许可证密钥。
3. 创建一个新的控制器或页面，您希望在此处理PDF转换。
4. 在控制器中编写您的转换逻辑。
5. 配置路由以允许访问您的PDF生成操作。

IronPDF概述

IronPDF是一个强大的PDF库，允许开发者读取、创建和操作PDF文档。 凭借丰富的功能集和快速、简单的安装过程，您可以快速将您的PDF项目提升到新水平，感谢IronPDF。 其直观的API易于学习，如果您希望直接从Web应用程序生成动态PDF文档，执行PDF安全任务、PDF注释等，则使其成为理想选择。

前提条件

在开始前，请确保您准备了：

• Visual Studio或设置了其他C#开发环境。
• 安装了IronPDF库。 您可以从NuGet或直接从IronPDF网站获取它。

创建新的ASP.NET项目

启动Visual Studio并选择最适合您需求的ASP.NET项目类型。 对于今天的例子，我将创建一个ASP.NET Core Web应用程序（模型视图控制器）。

然后，为您的项目输入名称并选择位置来存放项目。

最后，为项目选择您的.NET Framework，并更改任何项目的附加设置，例如身份验证类型或启用容器支持和docker。

添加HTML到PDF转换代码

现在我们已经创建了我们的ASP.NET项目，我们可以开始编写代码以将HTML文件内容转换为PDF。 我们将从一个简单的HTML字符串到PDF的示例开始，然后再看看带有自定义的HTML内容转换。

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    public class PdfController : Controller
    {
        // Action method to generate a PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the HTML string to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Convert HTML string to PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Return the generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

ASP.NET MVC使用控制器来处理用户请求。 当用户导航到一个特定URL时，ASP.NET将调用与该路由关联的控制器中的方法。

• PdfController是一个从Controller继承的类，这意味着它可以处理Web请求并发送响应。
• 该控制器内的GeneratePdf方法将处理一个请求以将HTML转换为PDF并返回结果。

当用户访问链接到GeneratePdf操作的URL时，该方法将执行。

• IActionResult：这是返回类型，表示web应用程序将发送回给用户的响应。 可能是一个视图（HTML页面）、文件下载等。在这种情况下，是一个PDF文件。

  • GeneratePdf() 方法：

  • 在方法内部，我们定义了一个包含您要转换为PDF的HTML的字符串htmlContent。 For example, "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>".

• 我们创建了一个新的ChromePdfRenderer实例，它处理HTML到PDF的转换。

• 方法RenderHtmlAsPdf()接收HTML字符串并返回一个PDF对象。

自定义PDF输出

现在我们已经掌握了基础知识，让我们来看看如何从HTML内容创建PDF文件，并为输出PDF设置一些自定义设置。 IronPDF提供了强大的PDF自定义工具集，例如边距、页眉/页脚、自定义PDF大小等。

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace IronPdfTest.Controllers
{
    // Controller for our PDF converter
    public class PdfController : Controller
    {
        // Action method to generate a customized PDF from HTML content
        public IActionResult GeneratePdf()
        {
            // String of HTML code to be converted to PDF
            string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF generated from HTML.</p>";

            // Creating a renderer to convert the URL to PDF
            ChromePdfRenderer renderer = new ChromePdfRenderer();

            // Creating the cover page
            PdfDocument cover = renderer.RenderHtmlAsPdf("<h1>Cover Page</h1>");

            // Adding custom options for our final PDF
            renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Landscape;
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A3;
            renderer.RenderingOptions.TextHeader.CenterText = "IronPDF";
            renderer.RenderingOptions.TextHeader.FontSize = 12;
            renderer.RenderingOptions.MarginTop = 20;
            renderer.RenderingOptions.FirstPageNumber = 2;

            // Creating our main PDF
            PdfDocument pdf = renderer.RenderHtmlAsPdf(htmlContent);

            // Appending the cover to the main PDF
            pdf.InsertPdf(cover, 0);

            // Return the customized generated PDF file
            return File(pdf.BinaryData, "application/pdf", "generatedDocument.pdf");
        }
    }
}

结论

今天我们更仔细地看了一下如何利用ASP.NET进行HTML到PDF转换，并探索了在ASP.NET项目中从HTML创建PDF文件的过程。 通过遵循上面列出的步骤，您可以轻松地将PDF生成集成到您的Web应用程序中，允许您从HTML内容中创建高质量的可打印文档。

IronPDF具有丰富的功能集，可用于生成高质量的PDF文档。 有关更高级的功能和详细的自定义，请参阅IronPDF文档。 通过快速安装，您可以在不久的时间内将IronPDF设置在您的项目中。