使用HtmlRenderer.PdfSharp转PDF时，page-break-inside: avoid为何无法阻止表格行拆分？

在.NET环境使用HtmlRenderer.PdfSharp转换HTML到PDF时，常遇到表格行或单元格内容被垂直拆分跨页的问题，即便给table、tr、th、td设置page-break-inside: avoid;和break-inside: avoid;也无法解决。以下是针对该问题的可行解决方案：

方案一：调整表格CSS渲染模式 #

HtmlRenderer.PdfSharp对表格元素的分页控制支持有限，通过修改表格的display属性，让渲染引擎将行识别为不可拆分的块级单元：

修改后的CSS样式：

body {
    font-family: Arial, sans-serif;
    font-size: 12px;
    margin: 0;
    padding: 0;
}
table {
    width: 100%;
    border-collapse: collapse;
    display: block; /* 改为块级元素 */
    page-break-inside: avoid !important;
}
tbody {
    display: block; /* 让tbody作为块级容器 */
}
tr {
    display: table-row;
    page-break-inside: avoid !important;
    break-inside: avoid !important;
}
th, td {
    border: 1px solid #ccc;
    padding: 8px;
    text-align: left;
    page-break-inside: avoid !important;
}

该方法通过改变表格的渲染结构，强制渲染引擎将每一行视为一个整体，避免跨页拆分。

方案二：手动插入分页符 #

对于结构固定的表格，可以在预估会跨页的行之前手动插入分页标记，确保整行在新页面显示：

在HTML中需要分页的位置添加：

<div style="page-break-before: always;"></div>

此方法适合内容高度可预测的场景，无需依赖渲染引擎的自动分页逻辑。

方案三：替换为更现代的PDF生成库 #

HtmlRenderer.PdfSharp已停止维护，对现代CSS属性支持不足。推荐替换为以下活跃维护的库：

PuppeteerSharp #

基于Chrome/Chromium引擎，完美支持CSS分页属性，能彻底解决行拆分问题。示例代码：

using System;
using System.IO;
using PuppeteerSharp;

namespace HtmlToPdfFix
{
    class Program
    {
        static async System.Threading.Tasks.Task Main(string[] args)
        {
            string outputPath = "OutputNoSplit.pdf";
            string htmlContent = GetHtmlContent();

            await new BrowserFetcher().DownloadAsync(BrowserFetcher.DefaultChromiumRevision);
            using var browser = await Puppeteer.LaunchAsync(new LaunchOptions { Headless = true });
            using var page = await browser.NewPageAsync();
            
            await page.SetContentAsync(htmlContent);
            await page.PdfAsync(outputPath, new PdfOptions 
            { 
                Format = PaperFormat.A4, 
                MarginOptions = new MarginOptions { Top = 10, Bottom = 10, Left = 10, Right = 10 } 
            });

            Console.WriteLine($"PDF生成成功：{Path.GetFullPath(outputPath)}");
            Console.ReadKey();
        }

        private static string GetHtmlContent()
        {
            return @"
<!DOCTYPE html>
<html>
<head>
    <title>Fixed Table Split Issue</title>
    <style>
        body {
            font-family: Arial, sans-serif;
            font-size: 12px;
            margin: 0;
            padding: 0;
        }
        table {
            width: 100%;
            border-collapse: collapse;
        }
        th, td {
            border: 1px solid #ccc;
            padding: 8px;
            text-align: left;
        }
        tr {
            break-inside: avoid; /* 直接生效 */
        }
    </style>
</head>
<body>
    <h1>Table Row Split Fixed</h1>
    <p>以下表格行不会再跨页拆分</p>
    <table>
        <thead>
            <tr>
                <th>Row #</th>
                <th>Description</th>
                <th>Details</th>
            </tr>
        </thead>
        <tbody>" + GenerateTableRows(20) + @"
        </tbody>
    </table>
</body>
</html>";
        }

        private static string GenerateTableRows(int count)
        {
            System.Text.StringBuilder sb = new System.Text.StringBuilder();
            for (int i = 1; i <= count; i++)
            {
                sb.AppendFormat(@"
            <tr>
                <td>{0}</td>
                <td>This is a description for row {0}. It's a moderately long text to ensure it takes up some space.</td>
                <td>
                    <p>More detailed information for row {0}.</p>
                    <p>This cell contains more content to increase its height and make it prone to splitting.</p>
                    <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
                </td>
            </tr>", i);
            }
            return sb.ToString();
        }
    }
}

iText7 #

支持高级PDF生成和CSS分页控制，适合复杂文档场景，对表格分页的处理更灵活。

内容的提问来源于stack exchange，提问作者Albin Mathew Sabu