如何在 .NET Core 中将 ASP HTML 转换为 PDF

通过NuGet包管理器安装

将IronPDF添加到ASP.NET项目中以进行HTML到PDF的转换的最快方法是通过Visual Studio中的NuGet包管理器。 在解决方案资源管理器中右键点击您的项目，选择"管理NuGet包"，然后搜索IronPDF。 点击安装最新版本以将其添加到您的项目中。 有关详细的安装说明，请参阅IronPDF安装指南。

Install-Package IronPdf

添加所需的命名空间

安装完成后，在任何您将使用PDF生成的C#文件中添加IronPDF命名空间：

using IronPdf;

using IronPdf;

Imports IronPdf

这个简单的导入语句让您可以访问IronPDF的所有功能，包括用于HTML转换的ChromePdfRenderer类和各种用于自定义PDF输出的配置选项。

基本配置

对于大多数ASP.NET Core应用程序，IronPDF在安装后立即工作，无需额外配置。 然而，您可以在Program.cs或Startup.cs文件中设置全局选项：

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

// Optional: Configure IronPDF settings
Installation.TempFolderPath = @"C:\Temp\IronPdf\";
Installation.LinuxAndDockerDependenciesAutoConfig = true;

IRON VB CONVERTER ERROR developers@ironsoftware.com

这些配置选项有助于优化IronPDF以适应您的特定托管环境，无论您是在Windows上运行、Linux上，还是在Docker容器中。 确保脚本和应用程序文件不在同一目录中以防止冲突。

使用CSS和图像

IronPDF完全支持CSS样式，并且在将HTML转换为PDF时可以嵌入来自各种来源的图像。 PDF转换器以完整的忠实度处理HTML元素，包括各种HTML标签和图片URL：

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

var html = @"
    <style>
        body { font-family: Arial, sans-serif; margin: 40px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; }
        .highlight { background-color: #f1c40f; padding: 5px; }
    </style>
    <h1>Monthly Report</h1>
    <p>This HTML document includes <span class='highlight'>highlighted text</span> and styling.</p>
    <img src='data:image/png;base64,iVBORw0KGgoAAAANS...' alt='Logo' />";
var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);

IRON VB CONVERTER ERROR developers@ironsoftware.com

渲染器处理内联样式，CSS文件，甚至base64编码的图像。 这确保您的PDF页面保持HTML内容的精确外观，包括现代CSS3功能如弹性盒子和网格布局。 HTML到PDF的转换保留了所有HTML标签及其样式，而不生成空白页面。

转换控制器视图

在您的ASP.NET Core控制器中，您可以将视图渲染为HTML，然后使用IronPDF强大的PDF库渲染能力将其转换为PDF文档：

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

[HttpGet]
public async Task<IActionResult> DownloadPdf()
{
    var invoiceModel = new InvoiceModel
    {
        InvoiceNumber = 12345,
        Date = DateTime.Now,
        CustomerName = "Acme Corporation",
        Items = new List<InvoiceItem>
        {
            new InvoiceItem { Description = "Service", Quantity = 1, Price = 100.0 }
        },
        Total = 100.0
    };
    // Render the view to HTML string
    var htmlContent = await RenderViewToString("Invoice", invoiceModel);
    // Convert HTML to PDF
    var renderer = new ChromePdfRenderer();
    var pdf = renderer.RenderHtmlAsPdf(htmlContent);
    // Return PDF to browser
    var contentType = "application/pdf";
    var fileName = $"invoice_{DateTime.Now:yyyyMMdd}.pdf";
    return File(pdf.BinaryData, contentType, fileName);
}
private async Task<string> RenderViewToString(string viewName, object model)
{
    ViewData.Model = model;
    using (var writer = new StringWriter())
    {
        var viewResult = viewEngine.FindView(ControllerContext, viewName, false);
        var viewContext = new ViewContext(
            ControllerContext,
            viewResult.View,
            ViewData,
            TempData,
            writer,
            new HtmlHelperOptions()
        );
        await viewResult.View.RenderAsync(viewContext);
        return writer.GetStringBuilder().ToString();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

这种方式首先将您的Razor视图渲染为HTML字符串，然后转换为PDF。 PDF以合适的文件名作为文件下载返回给用户的浏览器。 无论您是在转换ASPX文件还是现代Razor视图，这种方式都能无缝工作。

将 URL 转换为 PDF

对于现有网页，您可以使用IronPDF作为强大的HTML到PDF转换工具，将任何指定的URL直接转换为PDF文件。 只需提供HTTP或HTTPS地址作为URL参数：

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

[HttpGet]
public IActionResult GeneratePdfFromUrl()
{
    var renderer = new ChromePdfRenderer();
    // Convert a specified URL to PDF document
    var pdf = renderer.RenderUrlAsPdf("https://ironpdf.com/");
    // Stream the PDF file to the browser
    return File(pdf.BinaryData, "application/pdf", "invoice.pdf");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此方法特别有用，当您已经有格式良好的网页并希望将其作为下载的PDF版本提供时。 .NET库处理所有外部资源，包括样式表、脚本和图像，确保完整的HTML渲染。 如果遇到无效的URL，转换器将返回适当的HTTP状态码。

处理身份验证

在使用.NET表单身份验证或其他安全机制转换身份认证页面时，您可以传递Cookie或头信息以保持相同用户账户会话。 这可以防止在PDF转换过程中重定向到登录界面：

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

var renderer = new ChromePdfRenderer();
// Set cookies for authenticated requests with user database credentials
renderer.RenderingOptions.CustomCookies.Add("auth_token", Request.Cookies["auth_token"]);
// Convert protected web pages to PDF
var pdf = renderer.RenderUrlAsPdf("https://localhost:5001/secure/report");

IRON VB CONVERTER ERROR developers@ironsoftware.com

这确保了受保护的HTML内容可以在保持安全性的同时转换为PDF文件。 PDF转换过程尊重您的应用程序的基本身份验证和表单身份验证，防止未经授权的用户账户访问敏感的现有文档。 在需要时，您还可以在基本身份验证场景中传递用户名和密码参数。

页面设置和边距

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

var renderer = new ChromePdfRenderer();
// Set default page size for PDF pages
renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Portrait;
// Control page width and margins for the resultant PDF document
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.MarginBottom = 25;
renderer.RenderingOptions.MarginLeft = 20;
renderer.RenderingOptions.MarginRight = 20;

IRON VB CONVERTER ERROR developers@ironsoftware.com

这些设置控制PDF页面的物理布局，包括奇数页和偶数页。 您可以选择标准纸张尺寸或定义自定义尺寸，设置纵向或横向方向，并根据您的设计要求调整多个页面的边距。 图形模板系统确保后续的奇数页和偶数页的一致样式。

页眉和页脚

在将HTML文档转换为PDF时，添加一致的页眉和页脚增强了PDF文档的专业外观：

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

renderer.RenderingOptions.HtmlHeader = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Company Report</div>",
    MaxHeight = 20
};
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<div style='text-align: center'>Page {page} of {total-pages}</div>",
    MaxHeight = 20
};

IRON VB CONVERTER ERROR developers@ironsoftware.com

页眉和页脚支持HTML元素和格式，并在所有PDF页面上提供页码、日期和其他动态内容的特殊占位符。 下面的代码展示了如何为您动态生成的文档或现有PDF文档添加专业的页眉。