如何避免Razor Pages生成的Excel报表数据组跨页拆分？

针对你用Razor Pages生成Excel报表时，每组（标题行+4行数据）被跨页拆分的问题，下面按常用的Excel生成库给出具体解决方法：

使用EPPlus库的方案 #

EPPlus支持通过设置行的分页属性，确保整组数据不被拆分。你可以给每组的最后一行设置“禁止在下方分页”，或者给标题行设置“禁止在上方分页”：

// 假设每组共5行（1行标题+4行数据），起始行从2开始（根据你的报表结构调整）
int startRow = 2;
int groupTotalRows = 5;

foreach (var dataGroup in yourDataGroups)
{
    // 设置当前组最后一行的下方禁止分页，强制整组留在同一页
    worksheet.Row(startRow + groupTotalRows - 1).PageBreak = false;
    
    // 这里写填充标题行和4行数据的代码...
    
    startRow += groupTotalRows;
}

// 最后校验：如果最后一组行数不足一页，确保不拆分
int lastGroupStartRow = startRow - groupTotalRows;
int remainingRows = worksheet.Dimension.End.Row - lastGroupStartRow + 1;
if (remainingRows <= groupTotalRows)
{
    worksheet.Row(lastGroupStartRow).PageBreak = false;
}

使用NPOI库的方案 #

NPOI通过Row.Break属性控制分页逻辑，同样可以针对组的边界行设置禁止分页：

// NPOI行索引从0开始，注意调整起始行
int startRowIndex = 0;
int groupTotalRows = 5;

foreach (var dataGroup in yourDataGroups)
{
    // 获取当前组的最后一行，若不存在则创建
    IRow lastGroupRow = worksheet.GetRow(startRowIndex + groupTotalRows - 1);
    if (lastGroupRow == null)
    {
        lastGroupRow = worksheet.CreateRow(startRowIndex + groupTotalRows - 1);
    }
    // 设置该行下方禁止分页
    lastGroupRow.Break = false;
    
    // 这里写填充标题行和4行数据的代码...
    
    startRowIndex += groupTotalRows;
}

通用思路：提前计算分页位置 #

你可以先根据纸张大小、行高算出每页能容纳的总行数，然后遍历数据组时判断：如果当前组加上后会超出页容量，就手动插入分页符，把当前组放到下一页：

// 假设每页最多容纳50行（根据实际情况调整）
int pageMaxRows = 50;
int currentRow = 2;
int groupTotalRows = 5;

foreach (var dataGroup in yourDataGroups)
{
    // 检查当前组是否会跨页
    if (currentRow + groupTotalRows > pageMaxRows)
    {
        // 在当前行前插入分页符，让组内容留在下一页
        worksheet.InsertPageBreak(currentRow - 1);
        // 更新下一页的行容量上限
        pageMaxRows += 50;
    }
    
    // 填充组数据的代码...
    
    currentRow += groupTotalRows;
}

内容的提问来源于stack exchange，提问作者Baker6Romeo