In this article I will explain with an example, how to export HTML string to PDF file in ASP.Net Core Razor Pages.
The data from database will be populated in HTML Table using Entity Framework in ASP.Net Core Razor Pages.
Finally, the HTML Table will be exported and downloaded as PDF file using itext7.pdfhtml library in ASP.Net Core Razor Pages.
Installing itext7.pdfhtml Library
In order to install itext7.pdfhtml library, use the following command in Nuget Package Manager Console window.
Install-Package itext7.pdfhtml -Version 4.0.4
Here I am making use of Microsoft’s Northwind Database. You can download it from here.
You need to import the following namespaces.
using System.IO;
using System.Text;
using iText.Html2pdf;
using iText.IO.Source;
using iText.Kernel.Geom;
using iText.Kernel.Pdf;
The Model class consists of the following four properties.
public class Customer
    public string CustomerID { get; set; }
    public string ContactName { get; set; }
    public string City { get; set; }
    public string Country { get; set; }
Database Context
Once the Entity Framework is configured and connected to the database table, the Database Context will look as shown below.
Note: For beginners in ASP.Net Core and Entity Framework, please refer my article ASP.Net Core Razor Pages: Simple Entity Framework Tutorial with example. It covers all the information needed for connecting and configuring Entity Framework with ASP.Net Core.
using Microsoft.EntityFrameworkCore;
namespace Export_Grid_PDF_Razor_Core
    public class DBCtx : DbContext
        public DBCtx(DbContextOptions<DBCtx> options) : base(options)
        public DbSet<Customer> Customers { get; set; }
Razor PageModel (Code-Behind)
The PageModel consists of following two Handler methods.
Handler method for handling GET operation
Inside this Handler method, the Top 10 records are fetched from the Customers table using Entity Framework and assigned to the public property Customers and returned to the Razor Page.
Handler method for handling the PDF File Export and Download operation
This Handler method is executed when the Export button is clicked.
Note: The following Handler method performs File Download operation. Hence the return type is set to FileResult. For more details on FileResult, please refer my article FileResult return type in ASP.Net Core Razor Pages.
The HTML string sent from the Razor Page is extracted from the GridHtml parameter.
Then, the HTML string is read and saved to the MemoryStream class object.
Next, the ByteArrayOutputStream class object is created and passed to the PdfWriter class object and the PdfDocument is initialized using the PdfWriter class object.
Then, the ConvertToPdf method of HtmlConverter class is used to convert it to PDF document by passing the MemoryStream and PdfDocument object.
Finally, the ByteArrayOutputStream class object is converted to Byte Array and exported and downloaded as PDF file using the File function.
public class IndexModel : PageModel
    private DBCtx Context { get; }
    public IndexModel(DBCtx _context)
        this.Context = _context;
    public List<Customer> Customers { get; set; }
    public void OnGet()
        this.Customers = this.Context.Customers.Take(10).ToList();
    public FileResult OnPostExport(string GridHtml)
        using (MemoryStream stream = new MemoryStream(Encoding.ASCII.GetBytes(GridHtml)))
            ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
            PdfWriter writer = new PdfWriter(byteArrayOutputStream);
            PdfDocument pdfDocument = new PdfDocument(writer);
            HtmlConverter.ConvertToPdf(stream, pdfDocument);
            return File(byteArrayOutputStream.ToArray(), "application/pdf", "Grid.pdf");
Razor Page (HTML)
Displaying the Records
For displaying the records, an HTML Table is used.
A loop will be executed over the Model which will generate the HTML Table rows with the Customer records.
Exporting the HTML Table to PDF File
Below the HTML Table there is an HTML Form within which a Submit button has been placed.
The Export Button has been set with the POST Handler method using the asp-page-handler attribute.
Note: In the Razor PageModel, the Handler method name is OnPostExport but here it will be specified as Export when calling from the Razor HTML Page.
Also, there is an HTML Hidden Field element which will be used to send the HTML content of the Table to the Razor PageModel.
When the Submit button is clicked, first the HTML is extracted and set into the Hidden Field element and finally the Form is submitted.
@model Export_Grid_PDF_Razor_Core.Pages.IndexModel
@addTagHelper*, Microsoft.AspNetCore.Mvc.TagHelpers
    Layout = null;
<!DOCTYPE html>
    <meta name="viewport" content="width=device-width" />
    <hr />
    <div id="Grid">
        <table cellpadding="5" cellspacing="0" style="border: 1px solid #ccc; font-family: Arial; font-size: 10pt;">
                <th style="background-color: #B8DBFD;border: 1px solid #ccc">CustomerID</th>
                <th style="background-color: #B8DBFD;border: 1px solid #ccc">ContactName</th>
                <th style="background-color: #B8DBFD;border: 1px solid #ccc">City</th>
                <th style="background-color: #B8DBFD;border: 1px solid #ccc">Country</th>
            @foreach (var customer in Model.Customers)
                    <td style="border: 1px solid #ccc">@customer.CustomerID</td>
                    <td style="border: 1px solid #ccc">@customer.ContactName</td>
                    <td style="border: 1px solid #ccc">@customer.City</td>
                    <td style="border: 1px solid #ccc">@customer.Country</td>
    <br /><br />
    <form method="post">
        <input type="hidden" name="GridHtml" />
        <input type="submit" id="btnSubmit" value="Export" asp-page-handler="Export" />
    <script type="text/javascript" src=""></script>
    <script type="text/javascript">
        $(function () {
            $("#btnSubmit").click(function () {
HTML Table
ASP.Net Core Razor Pages: Export HTML string to PDF File
Exported PDF File
ASP.Net Core Razor Pages: Export HTML string to PDF File