EPPlus单元格和样式（含文字竖排）

一、EPPlus单元格基础操作

EPPlus作为.NET平台下强大的Excel操作库，其核心功能围绕工作表(Worksheet)中的单元格(Cell)展开。开发者通过ExcelWorksheet对象可以精确控制每个单元格的内容和属性。

1.1 单元格数据写入

最基础的单元格操作是数据写入，EPPlus提供了多种便捷方式：

// 创建新工作表
using (var package = new ExcelPackage(new FileInfo("Sample.xlsx")))
{
    var worksheet = package.Workbook.Worksheets.Add("Sheet1");
    // 方式1：直接赋值
    worksheet.Cells["A1"].Value = "基础数据";
    // 方式2：行列索引
    worksheet.Cells[2, 1].Value = 100; // 第二行第一列
    // 方式3：范围赋值
    worksheet.Cells["B2:D4"].Value = "批量数据";
    package.Save();
}

1.2 单元格数据类型处理

EPPlus会自动识别常见数据类型，但特殊场景需要显式指定：

// 数值格式
worksheet.Cells["A2"].Value = 1234.56;
worksheet.Cells["A2"].Style.Numberformat.Format = "#,##0.00";
// 日期格式
worksheet.Cells["A3"].Value = DateTime.Now;
worksheet.Cells["A3"].Style.Numberformat.Format = "yyyy-mm-dd";
// 布尔值
worksheet.Cells["A4"].Value = true;

二、单元格样式深度定制

样式设置是EPPlus的核心功能之一，通过ExcelStyle对象可以实现像素级控制。

2.1 字体样式控制

var style = worksheet.Cells["A1:D1"].Style;
style.Font.Bold = true;
style.Font.Size = 14;
style.Font.Name = "微软雅黑";
style.Font.Color.SetColor(Color.Red);

2.2 边框与填充设置

// 边框设置
var border = worksheet.Cells["B2:D4"].Style.Border;
border.Top.Style = ExcelBorderStyle.Thick;
border.Bottom.Style = ExcelBorderStyle.Thick;
border.Left.Style = ExcelBorderStyle.Thin;
border.Right.Style = ExcelBorderStyle.Thin;
border.Top.Color.SetColor(Color.Blue);
// 背景填充
worksheet.Cells["B2:D4"].Style.Fill.PatternType = ExcelFillStyle.Solid;
worksheet.Cells["B2:D4"].Style.Fill.BackgroundColor.SetColor(Color.LightGray);

2.3 对齐方式优化

// 水平对齐
worksheet.Cells["A5"].Style.HorizontalAlignment = ExcelHorizontalAlignment.Center;
// 垂直对齐
worksheet.Cells["A5"].Style.VerticalAlignment = ExcelVerticalAlignment.Center;
// 文本换行
worksheet.Cells["A6"].Style.WrapText = true;
worksheet.Row(6).Height = 50; // 配合行高调整

三、文字竖排实现方案

文字竖排是中文报表中常见的需求，EPPlus通过以下两种方式实现：

3.1 文本方向旋转

// 90度竖排
worksheet.Cells["A1"].Style.TextRotation = 90;
// 自定义角度（0-180度）
worksheet.Cells["B1"].Style.TextRotation = 45;
// 垂直堆叠（255度特殊值）
worksheet.Cells["C1"].Style.TextRotation = 255;

3.2 字符间距调整（进阶方案）

当标准旋转不能满足需求时，可通过合并单元格模拟竖排：

// 合并5行1列的单元格
var mergeCell = worksheet.Cells["A2:A6"];
mergeCell.Merge = true;
// 设置竖排文本（需手动处理换行）
string verticalText = "竖\n排\n文\n本";
mergeCell.Value = verticalText;
mergeCell.Style.HorizontalAlignment = ExcelHorizontalAlignment.Center;
mergeCell.Style.VerticalAlignment = ExcelVerticalAlignment.Center;

四、样式继承与优化技巧

4.1 样式模板应用

// 创建样式模板
var titleStyle = package.Workbook.Styles.CreateStyle("TitleStyle");
titleStyle.Font.Bold = true;
titleStyle.Font.Size = 16;
titleStyle.Fill.PatternType = ExcelFillStyle.Solid;
titleStyle.Fill.BackgroundColor.SetColor(Color.LightBlue);
// 应用样式
worksheet.Cells["A1:D1"].StyleName = "TitleStyle";

4.2 条件格式应用

// 数据条条件格式
var condition = worksheet.ConditionalFormatting.AddDataBar(
    worksheet.Cells["B2:B10"]);
condition.LowBoundary.Value = 0;
condition.HighBoundary.Value = 100;
condition.BarDirection = ExcelConditionalFormattingBarDirection.Context;

五、性能优化建议

1. 批量操作：使用Worksheet.Cells["A1:Z1000"].Value = object[,]进行批量赋值
2. 样式复用：避免为每个单元格单独创建样式对象
3. 内存管理：及时调用Dispose()释放资源
4. 异步处理：大数据量时考虑异步保存

六、常见问题解决方案

6.1 样式不生效问题

检查顺序：样式设置必须在数据写入之后，且需在Save()之前完成。

6.2 竖排显示不全

解决方案：

// 调整列宽和行高
worksheet.Column(1).Width = 5;
worksheet.Row(1).Height = 100;
// 设置自动换行
worksheet.Cells["A1"].Style.WrapText = true;

6.3 兼容性问题

不同Excel版本对样式的支持存在差异，建议：

• 测试目标环境的Excel版本
• 避免使用过于复杂的样式组合
• 提供基础样式和增强样式两种版本

七、高级应用场景

7.1 动态样式生成

// 根据数据值动态设置样式
foreach (var cell in worksheet.Cells["B2:B10"])
{
    if (double.Parse(cell.Text) > 80)
    {
        cell.Style.Font.Color.SetColor(Color.Green);
    }
    else
    {
        cell.Style.Font.Color.SetColor(Color.Red);
    }
}

7.2 模板文件应用

// 加载现有模板
using (var package = new ExcelPackage(new FileInfo("Template.xlsx")))
{
    var worksheet = package.Workbook.Worksheets["Data"];
    // 填充数据同时保留模板样式
    worksheet.Cells["B2"].Value = "新数据";
    // ...其他操作
    package.SaveAs(new FileInfo("Output.xlsx"));
}

八、最佳实践总结

1. 分层设计：将样式定义与数据操作分离
2. 模块化：创建可复用的样式工具类
3. 异常处理：捕获InvalidCastException等常见异常
4. 版本控制：记录生成的Excel版本信息
5. 性能基准：对10万级数据量进行压力测试

通过系统掌握EPPlus的单元格操作和样式设置技术，开发者可以高效创建专业级的Excel报表，特别是文字竖排等特殊需求的实现，能显著提升报表的可读性和美观度。建议开发者结合实际项目需求，建立适合自身的样式库和操作规范。