如何在ASP.NET Core 中快速構建PDF文件
比如我們需要ASP.NET Core 中需要通過PDF來進行某些簡單的報表開發，隨著這並不難，但還是會手忙腳亂的去搜索一些資料，那麼恭喜您，這篇帖子會幫助到您，我們就不會再去浪費一些寶貴的時間。
在本文中我們將要使用DinkToPDF來處理我們在.NET Core Web 程式中進行構建PDF文件！就現在我們不多說，直接開始有趣的部分。
前言
您可以通過建立PDF文件在我的倉庫中，獲取原始碼，歡迎給個免費的Star...
現在我們建立一個.NET Core 3.0 專案，至於是mvc、Api、這些我並不在意。建立專案後直接Nuget安裝DinkToPDF。隨後您需要下載我的程式碼倉庫中的“NativeLibrary”資料夾，在其中，我們將找到兩個檔案32bit和64bit，因此我們需要為作業系統選擇合適的庫。我們將從64位資料夾中選擇檔案。
最後，我們需要啟動該庫，並且IOC DinkToPDF。
public void ConfigureServices(IServiceCollection services)
{
var context = new CustomAssemblyLoadContext();
context.LoadUnmanagedLibrary(Path.Combine(Directory.GetCurrentDirectory(), "libwkhtmltox.dll"));
services.AddSingleton(typeof(IConverter), new SynchronizedConverter(new PdfTools()));
services.AddControllers();
}建立實體
在真實情況的專案中，我們可以從資料庫中收集資料或從其他API接收資料。但是為了簡單起見，我們將從本地儲存中收集PDF文件的資料。隨後，我們將建立一個HTML模板並將其儲存在PDF文件中。
public class Employee
{
public string Name { get; set; }
public string LastName { get; set; }
public int Age { get; set; }
public string Gender { get; set; }
}再隨後，我們要建立一個新的資料夾Services和裡面兩類檔案 DataServices.cs 和 TemplateGenerator.cs 。完整的結構應如下所示：
public class DataServices
{
public static List<Employee> GetAllEmployess() =>
new List<Employee>
{
new Employee { Name="Hao Zi Zhang", LastName="Turner", Age=35, Gender="Male"},
new Employee { Name="Yu Chen", LastName="Markus", Age=22, Gender="Female"},
new Employee { Name="Jian Zhi Chu", LastName="Martins", Age=40, Gender="Male"},
new Employee { Name="ElderJames", LastName="Packner", Age=30, Gender="Female"},
new Employee { Name="BlaZui", LastName="Doe", Age=45, Gender="Male"}
};
}
其中新增服務中返回了某些資料，用於模擬服務。我們要生成一個HTML模板，因此我們需要修改 TemplateGenerator.cs 檔案：
public class TempleGenertor
{
public static string GetHTMLString()
{
var employees = DataServices.GetAllEmployess();
var sb = new StringBuilder();
sb.Append(@"
<html>
<head>
</head>
<body>
<div class='header'><h1>This is the generated PDF report!!!</h1></div>
<table align='center'>
<tr>
<th>Name</th>
<th>LastName</th>
<th>Age</th>
<th>Gender</th>
</tr>");
foreach (var emp in employees)
{
sb.AppendFormat(@"<tr>
<td>{0}</td>
<td>{1}</td>
<td>{2}</td>
<td>{3}</td>
</tr>", emp.Name, emp.LastName, emp.Age, emp.Gender);
}
sb.Append(@"
</table>
</body>
</html>");
return sb.ToString();
}
}
如果想要指定css樣式，則可以建立某些資料夾，隨後在API通過伺服器路徑來抉擇配置。
.header {
text-align: center;
color: green;
padding-bottom: 35px;
}
table {
width: 80%;
border-collapse: collapse;
}
td, th {
border: 1px solid gray;
padding: 15px;
font-size: 22px;
text-align: center;
}
table th {
background-color: green;
color: white;
}
就是這樣，我們有用於HTML建立的HTML模板。現在，我們可以繼續執行Controller邏輯。
[Route("api/PdfCreator")]
[ApiController]
public class PdfCreatorController : ControllerBase
{
private IConverter _converter;
public PdfCreatorController(IConverter converter)
{
_converter = converter;
}
[HttpGet]
public IActionResult CreatePDF()
{
var globalSettings = new GlobalSettings
{
ColorMode = ColorMode.Color,
Orientation = Orientation.Portrait,
PaperSize = PaperKind.A4,
Margins = new MarginSettings { Top = 10 },
DocumentTitle = "PDF Report"
};
var objectSettings = new ObjectSettings
{
PagesCount = true,
HtmlContent = TempleGenertor.GetHTMLString(),
WebSettings = { DefaultEncoding = "utf-8", UserStyleSheet = Path.Combine(Directory.GetCurrentDirectory(), "assets", "style.css") },
HeaderSettings = { FontName = "Arial", FontSize = 9, Right = "Page [page] of [toPage]", Line = true },
FooterSettings = { FontName = "Arial", FontSize = 9, Line = true, Center = "Report Footer" }
};
var pdf = new HtmlToPdfDocument()
{
GlobalSettings = globalSettings,
Objects = { objectSettings }
};
var file = _converter.Convert(pdf);
return File(file, "application/pdf");
}
}
程式碼說明
在上面的程式碼中，我們首先通過使用 IConverter 介面將註冊的 Converter 與依賴注入注入到建構函式中。然後，我們建立兩個物件 globalSettings ， objectSettings 並將它們用作 HtmlToPdfDcoument 屬性中的配置。
現在讓我們來說說 GlobalSettings 和 ObjectSettings 類。
關於GlobalSettings類
它括了PDF文件的整體配置屬性。我們僅使用其中的幾個屬性來設定顏色模式，方向，紙張尺寸，文件標題等…但它還有還多屬性。
關於ObjectSettings類
ObjectSettings由相關的PDF文件的內容的屬性。因此，我們可以配置頁面計數器的可見性，頁首和頁尾的格式，文件的正文內容（HtmlContent屬性）或的Web設定。
HtmlContent屬性是此類的非常重要的屬性。它包含我們生成的HTML模板，並顯示PDF文件的主體。
WebSettings也非常重要，尤其是如果我們有一個外部CSS檔案來進行樣式設定時。在此屬性中，我們可以配置文件的編碼並提供CSS檔案的路徑。如果我們檢查此屬性，我們將發現更多可以配置的設定，例如PDF文件的背景，文字大小 等等..
啟動專案
通過路由定位到我們的API中，重定向PDF列印介面。
一切看起來都是那麼完美，就這樣我們就可以輕鬆的在ASP.NET Core中構建PDF文件並且還可以完美適配相關邏輯和某些文件設定