.NET 6后端将带模型的View转为PDF的免费实用框架求助

针对你在后端将带模型的.NET View转换为PDF的需求，这里有几个无需高额年费的实用方案：

1. PuppeteerSharp（无头浏览器渲染） #

这是Chrome无头浏览器的.NET封装，完全开源免费，能精准渲染包含动态数据的HTML（即View渲染后的内容），生成的PDF格式还原度高。

步骤： #

• 安装NuGet包：Install-Package PuppeteerSharp
• 先将View渲染为HTML字符串（ASP.NET Core示例）：

private async Task<string> RenderViewToStringAsync(string viewName, object model)
{
    var httpContext = new DefaultHttpContext { RequestServices = HttpContext.RequestServices };
    var actionContext = new ActionContext(httpContext, new RouteData(), new ActionDescriptor());

    using var sw = new StringWriter();
    var viewResult = ViewEngines.Engines.FindView(actionContext, viewName, false);
    var viewContext = new ViewContext(actionContext, viewResult.View, new ViewDataDictionary(model), new TempDataDictionary(httpContext, TempDataProvider), sw, new HtmlHelperOptions());

    await viewResult.View.RenderAsync(viewContext);
    return sw.ToString();
}

• 用PuppeteerSharp生成PDF：

using var browserFetcher = new BrowserFetcher();
await browserFetcher.DownloadAsync();
using var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
using var page = await browser.NewPageAsync();
await page.SetContentAsync(await RenderViewToStringAsync("YourViewName", yourModel));
var pdfBytes = await page.PdfAsync(new PdfOptions
{
    Format = PaperFormat.A4,
    PrintBackground = true // 确保CSS背景样式被渲染
});
// 后续可将pdfBytes保存为文件或返回给前端

2. wkhtmltopdf + DinkToPdf #

wkhtmltopdf是一款开源的命令行工具，通过WebKit引擎将HTML转PDF；DinkToPdf是它的.NET封装库，使用简单。

步骤： #

• 从wkhtmltopdf官方渠道下载对应系统版本，添加到项目目录或配置环境变量
• 安装NuGet包：Install-Package DinkToPdf
• 注册服务（ASP.NET Core Program.cs）：

services.AddSingleton(typeof(IConverter), new SynchronizedConverter(new PdfTools()));

• 渲染View并生成PDF：

private readonly IConverter _converter;

public YourController(IConverter converter)
{
    _converter = converter;
}

public async Task<IActionResult> GeneratePdf()
{
    var htmlContent = await RenderViewToStringAsync("YourViewName", yourModel);
    var doc = new HtmlToPdfDocument()
    {
        GlobalSettings = {
            ColorMode = ColorMode.Color,
            Orientation = Orientation.Portrait,
            PaperSize = PaperKind.A4,
        },
        Objects = {
            new ObjectSettings() { HtmlContent = htmlContent }
        }
    };
    var pdfBytes = _converter.Convert(doc);
    return File(pdfBytes, "application/pdf", "output.pdf");
}

注意：确保wkhtmltopdf的路径配置正确，否则会出现运行错误。

3. QuestPDF（备选：代码构建PDF） #

如果可以接受不直接复用现有View，而是通过代码构建PDF，QuestPDF是完全开源免费的.NET库，语法简洁，无需依赖外部工具，适合需要高度自定义PDF布局的场景。

示例代码：

var document = Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Content().Column(column =>
        {
            column.Item().Text("订单详情").FontSize(20).Bold();
            column.Item().Text($"客户名称：{yourModel.CustomerName}");
            // 更多内容布局...
        });
    });
});

document.GeneratePdf("output.pdf");

内容的提问来源于stack exchange，提问作者PRIVATE ACCOUNT