各人用 ASP.NET Core 举办项目开拓时,常会有生成 PDF 的需求,那如何生成呢?这篇文章我们就来接头如何通过 DinkToPdf 来生成 PDF 文档,DinkToPdf 封装了 C++ 的 wkhtmltopdf 东西包,前者通过 P/Invoke 的方法来挪用后者,而底层的 wkhtmltopdf 操作 Qt WebKit 渲染引擎将 html 转成 pdf。
安装 DinkToPdf要想安装 DinkToPdf,可以通过 Nuget 可视化界面可能通过 NuGet Package Manager Console 呼吁行东西输入以下呼吁:
Install-Package DinkToPdf
安装完毕之后可以验证下 DinkToPdf.dll 是否已乐成引用到项目中。
既然是封装了 C++ 的 wkhtmltopdf,必定要拿到原生的 wkhtmltopdf 东西包, 官方下载地点:https://wkhtmltopdf.org/downloads.html ,也可以在 DinkToPdf 的官方Github:https://github.com/rdvojmoc/DinkToPdf/tree/master/v0.12.4 上下载,然后按照你的需要选择 32bit 照旧 64bit 。
注册 DinkToPdf要想在 ASP.NET Core 中利用,需要在 ConfigureServices() 要领下将 DinkToPdf 注入到 IOC 容器中,下面的代码展示了如何去实现。
public void ConfigureServices(IServiceCollection services) { services.AddSingleton(typeof(IConverter),new SynchronizedConverter(new PdfTools())); services.AddControllers(); }
建设 ReportService基本设置做好之后,接下来我们来写生成 PDF 的业务逻辑,建设一个 IReportService 和 ReportService 实现类,代码如下:
public interface IReportService { public byte[] GeneratePdfReport(); } public class ReportService : IReportService { private readonly IConverter _converter; public ReportService(IConverter converter) { _converter = converter; } public byte[] GeneratePdfReport() { throw new NotImplementedException(); } }
从上面的代码可以看出,IConverter 实例是通过 结构函数 注入的,接下来可以在 GeneratePdfReport() 要领中构建生成 pdf 的详细业务逻辑。
public byte[] GeneratePdfReport() { var html = $@"<!DOCTYPE html> <html lang=""en""> <head> This is the header of this document. </head> <body> <h1>This is the heading for demonstration purposes only.</h1> <p>This is a line of text for demonstration purposes only.</p> </body> </html>"; GlobalSettings globalSettings = new GlobalSettings(); globalSettings.ColorMode = ColorMode.Color; globalSettings.Orientation = Orientation.Portrait; globalSettings.PaperSize = PaperKind.A4; globalSettings.Margins = new MarginSettings { Top = 25, Bottom = 25 }; ObjectSettings objectSettings = new ObjectSettings(); objectSettings.PagesCount = true; objectSettings.HtmlContent = html; WebSettings webSettings = new WebSettings(); webSettings.DefaultEncoding = "utf-8"; HeaderSettings headerSettings = new HeaderSettings(); headerSettings.FontSize = 15; headerSettings.FontName = "Ariel"; headerSettings.Right = "Page [page ] of [toPage]"; headerSettings.Line = true; FooterSettings footerSettings = new FooterSettings(); footerSettings.FontSize = 12; footerSettings.FontName = "Ariel"; footerSettings.Center = "This is for demonstration purposes only."; footerSettings.Line = true; objectSettings.HeaderSettings = headerSettings; objectSettings.FooterSettings = footerSettings; objectSettings.WebSettings = webSettings; HtmlToPdfDocument htmlToPdfDocument = new HtmlToPdfDocument() { GlobalSettings = globalSettings, Objects = { objectSettings }, }; return _converter.Convert(htmlToPdfDocument); }
然后再将 IReportService 和 ReportService 注入到 IOC 容器中,如下代码所示:
services.AddSingleton<IReportService, ReportService>();
建设 ReportControllerGeneratePdfReport() 要领的业务逻辑构建好之后,此刻可以将 IReportService 实例注入到 ReportController 中来最终渲染 pdf,下面的代码展示了如何去实现。
[Route("api/[controller]")] [ApiController] public class ReportController : ControllerBase { private readonly IReportService _reportService; public ReportController(IReportService reportService) { _reportService = reportService; } [HttpGet] public IActionResult Get() { var pdfFile = _reportService.GeneratePdfReport(); return File(pdfFile,"application/octet-stream", "SimplePdf.pdf"); } }
在 ASP.NET Core 中并没有内置对 pdf 的支持,所以有这方面的需求只能借助于第三方框架,而 DinkToPdf 就是这么一款很是优秀的东西包,DinkToPdf 是一款用 .NET 语言编写的用于包装 C++ 的 wkhtmltopdf 的东西包,它可以很是利便的将 Html 转成 PDF ,关于更多 DinkToPdf 可参考 Github:https://github.com/rdvojmoc/DinkToPdf
译文链接:https://www.infoworld.com/article/3605276/how-to-create-pdf-documents-in-aspnet-core-5.html
总结