如何在C#中使用OpenXml为Excel文档设置完整边框

问题排查 #

你无法实现全边框设置的核心原因是：仅为列定义（Column类）设置边框样式不会自动应用到整列所有单元格，OpenXml中边框属于单元格样式的一部分，必须绑定到实际存在的单元格对象才会生效。

正确实现步骤 #

• 第一步：定义全边框样式并注册到工作簿样式表

// 定义四边全薄边框样式
var fullBorder = new Border(
    new LeftBorder() { Style = BorderStyleValues.Thin },
    new RightBorder() { Style = BorderStyleValues.Thin },
    new TopBorder() { Style = BorderStyleValues.Thin },
    new BottomBorder() { Style = BorderStyleValues.Thin },
    new DiagonalBorder()
);
// 将边框存入样式表
WorkbookStylesPart stylesPart = workbookPart.WorkbookStylesPart;
stylesPart.Stylesheet.Borders.Append(fullBorder);
stylesPart.Stylesheet.Borders.Count++;
// 创建关联全边框的单元格格式
var borderCellFormat = new CellFormat() 
{ 
    BorderId = (UInt32)stylesPart.Stylesheet.Borders.Count - 1, 
    ApplyBorder = true 
};
stylesPart.Stylesheet.CellFormats.Append(borderCellFormat);
stylesPart.Stylesheet.CellFormats.Count++;
// 获取全边框样式的索引，后续绑定到单元格
uint fullBorderStyleId = (UInt32)stylesPart.Stylesheet.CellFormats.Count - 1;

• 第二步：遍历需要设置边框的单元格范围，为所有单元格绑定边框样式

// 示例：设置A1到D20范围的全边框
uint startRow = 1, endRow = 20;
uint startCol = 1, endCol = 4;
SheetData sheetData = workbookPart.WorksheetParts.First().Worksheet.Elements<SheetData>().First();

for (uint row = startRow; row <= endRow; row++)
{
    Row currentRow = sheetData.Elements<Row>().FirstOrDefault(r => r.RowIndex == row);
    if (currentRow == null)
    {
        currentRow = new Row() { RowIndex = row };
        sheetData.Append(currentRow);
    }
    for (uint col = startCol; col <= endCol; col++)
    {
        Cell currentCell = currentRow.Elements<Cell>().FirstOrDefault(c => GetColumnIndex(c.CellReference) == col);
        if (currentCell == null)
        {
            // 空单元格必须显式创建，否则边框不显示
            currentCell = new Cell() { CellReference = GetCellReference(col, row) };
            currentRow.Append(currentCell);
        }
        // 绑定全边框样式
        currentCell.StyleIndex = fullBorderStyleId;
    }
}

// 辅助方法：列号+行号转单元格引用，例如1,1转为A1
private string GetCellReference(uint columnIndex, uint rowIndex)
{
    return $"{GetColumnName(columnIndex)}{rowIndex}";
}

// 辅助方法：列号转列名，例如1转为A，27转为AA
private string GetColumnName(uint columnIndex)
{
    string columnName = string.Empty;
    uint modulo;
    while (columnIndex > 0)
    {
        modulo = (columnIndex - 1) % 26;
        columnName = Convert.ToChar(65 + modulo).ToString() + columnName;
        columnIndex = (uint)((columnIndex - modulo) / 26);
    }
    return columnName;
}

// 辅助方法：从单元格引用中提取列号，例如A1提取为1
private uint GetColumnIndex(string cellReference)
{
    string columnPart = System.Text.RegularExpressions.Regex.Match(cellReference, @"[A-Za-z]+").Value;
    uint columnIndex = 0;
    foreach (char c in columnPart.ToUpper())
    {
        columnIndex = columnIndex * 26 + (uint)(c - 'A' + 1);
    }
    return columnIndex;
}

注意事项 #

• 空单元格必须显式创建并指定样式，否则对应位置不会显示边框
• 不要遗漏CellFormat的ApplyBorder = true属性，否则边框样式不会生效
• 若需要设置的范围较大，可先统计实际使用的单元格上下界，减少无效遍历提升性能

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