HTML to PDF Converter ASP.NET Core samples · .NET 10 and .NET 11

ExpertPdf Html To Pdf Converter for .NET - Control Page Breaks with Html to Pdf Converter - C# / ASP.NET Sample

This sample shows how to use ExpertPdf html to pdf converter to convert a raw html code to pdf and also how to control the page breaks from the html code.

To insert a page break in pdf, the html code must have an element with the style page-break-before: always or page-break-after: always. Before or after that specific element, a page break will be inserted into the generated pdf document. The element can be anything (image, table, table row, div, text, etc).

To instruct a certain section from the content to remain on the same page in the generated pdf document, an element with the style page-break-inside: avoid must be used.

Html Code:


Base Url:

Rendering engine:


C# code of this sample

Pages/PageBreaks.cshtml.cs
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.AspNetCore.Mvc.RazorPages;
using Microsoft.AspNetCore.Mvc.Rendering;
using ExpertPdf.HtmlToPdf;
using ExpertPdf.HtmlToPdf.PdfDocument;

namespace ExpertPdf.Samples.Pages
{
    public class PageBreaksModel : PageModel
    {
        public void OnGet()
        {
            TxtHtmlCode = Helper.PageBreaksText();
        }

        [BindProperty]
        public string TxtHtmlCode { get; set; }

        [BindProperty]
        public string TxtBaseUrl { get; set; }

        [BindProperty]
        public string DdlRenderingEngine { get; set; } = "Chromium";

        public List<SelectListItem> RenderingEngines { get; } = Helper.RenderingEngines();

        public IActionResult OnPost()
        {
            // instantiate a html to pdf converter object
            PdfConverter converter = new PdfConverter() { AllowLocalAccess = false };
            // the rendering engine: Chromium is the recommended engine for modern pages
            converter.RenderingEngine = (RenderingEngine)Enum.Parse(typeof(RenderingEngine), DdlRenderingEngine);

            converter.PdfDocumentOptions.TopMargin = 10;
            converter.PdfDocumentOptions.BottomMargin = 10;
            converter.PdfDocumentOptions.LeftMargin = 10;
            converter.PdfDocumentOptions.RightMargin = 10;

            // create a new pdf document converting an url
            Document doc = converter.GetPdfDocumentObjectFromHtmlString(TxtHtmlCode, TxtBaseUrl);

            // save pdf document
            byte[] pdf = doc.Save();

            // close pdf document
            doc.Close();

            // return resulted pdf document
            FileResult fileResult = new FileContentResult(pdf, "application/pdf");
            fileResult.FileDownloadName = "Sample.pdf";
            return fileResult;

        }
    }
}