EPPlus库中单元格操作与样式设置详解（含竖排文字实现）

2026年1月4日 互联网

EPPlus库中单元格操作与样式设置详解（含竖排文字实现）

在.NET生态中，处理Excel文件的需求广泛存在于报表生成、数据导出等场景。行业常见技术方案中，EPPlus库因其轻量级、高性能和丰富的API设计，成为开发者处理Excel文件的首选工具之一。本文将围绕EPPlus库的单元格操作、样式设置及竖排文字实现展开，结合实际代码示例，为开发者提供可落地的技术方案。

一、单元格基础操作：数据写入与读取

1.1 单元格赋值

EPPlus通过ExcelWorksheet类提供对单元格的直接访问。开发者可通过行列索引（从1开始）或单元格名称（如”A1”）定位目标单元格。例如，向A1单元格写入字符串：

  1. using (var package = new ExcelPackage())
  2. {
  3.     var worksheet = package.Workbook.Worksheets.Add("Sheet1");
  4.     worksheet.Cells["A1"].Value = "Hello, EPPlus!";
  5.     // 或通过行列索引
  6.     worksheet.Cells[1, 1].Value = "Hello, EPPlus!";
  7. }

1.2 批量写入优化

对于大规模数据写入，EPPlus支持通过二维数组批量赋值，显著提升性能。例如，写入100行×10列的数据：

  1. object[,] data = new object[100, 10];
  2. for (int i = 0; i < 100; i++)
  3. {
  4.     for (int j = 0; j < 10; j++)
  5.     {
  6.         data[i, j] = $"Row{i+1}Col{j+1}";
  7.     }
  8. }
  10. using (var package = new ExcelPackage())
  11. {
  12.     var worksheet = package.Workbook.Worksheets.Add("Sheet1");
  13.     worksheet.Cells["A1"].LoadFromArrays(new[] { data });
  14. }

1.3 单元格类型处理

EPPlus会自动根据赋值内容推断单元格类型（字符串、数字、日期等）。若需显式指定类型，可通过Style.Numberformat.Format属性设置格式代码。例如，将单元格格式化为日期：

  1. worksheet.Cells["A1"].Value = DateTime.Now;
  2. worksheet.Cells["A1"].Style.Numberformat.Format = "yyyy-MM-dd";

二、样式设置：从基础到高级

2.1 基础样式属性

EPPlus的样式系统通过ExcelRange.Style属性暴露，支持字体、边框、填充等基础属性的设置。例如，设置单元格字体为红色加粗：

  1. var cell = worksheet.Cells["A1"];
  2. cell.Style.Font.Bold = true;
  3. cell.Style.Font.Color.SetColor(Color.Red);

2.2 边框与填充

边框设置需指定边线类型（如ExcelBorderStyle.Thin）和颜色。填充支持纯色和渐变效果。例如，为单元格添加蓝色边框和黄色背景：

  1. var cell = worksheet.Cells["A1"];
  2. cell.Style.Border.Top.Style = ExcelBorderStyle.Thin;
  3. cell.Style.Border.Top.Color.SetColor(Color.Blue);
  4. // 其他边线设置类似...
  5. cell.Style.Fill.PatternType = ExcelFillStyle.Solid;
  6. cell.Style.Fill.BackgroundColor.SetColor(Color.Yellow);

2.3 条件格式

EPPlus支持通过ConditionalFormatting实现动态样式。例如，为数值大于100的单元格设置绿色背景：

  1. var cfRule = worksheet.ConditionalFormatting.AddGreaterThan(
  2.     worksheet.Cells["A1:A10"], 
  3.     100
  4. );
  5. cfRule.Style.Fill.BackgroundColor.SetColor(Color.Green);

三、竖排文字实现：原理与代码

3.1 竖排文字原理

Excel中竖排文字通过设置单元格的TextRotation属性实现。EPPlus中，该属性对应ExcelRange.Style.TextRotation枚举，支持0°（默认）、90°、270°（竖排）等角度。

3.2 代码实现

以下代码演示如何将A1单元格的文字设置为竖排：

  1. using (var package = new ExcelPackage())
  2. {
  3.     var worksheet = package.Workbook.Worksheets.Add("Sheet1");
  4.     worksheet.Cells["A1"].Value = "竖排文字示例";
  6.     // 设置竖排（270度）
  7.     worksheet.Cells["A1"].Style.TextRotation = 270;
  9.     // 调整列宽以适应竖排效果
  10.     worksheet.Column(1).Width = 10;
  12.     package.SaveAs(new FileInfo("VerticalText.xlsx"));
  13. }

3.3 注意事项

  1. 列宽调整：竖排文字需配合列宽设置，否则可能显示不全。建议通过AutoFitColumns()或手动设置列宽。
  2. 多行文本：若单元格包含换行符（\n），竖排时需确保Style.WrapText为true。
  3. 兼容性：竖排效果在Excel 2007及以上版本中支持良好，旧版本可能显示异常。

四、性能优化与最佳实践

4.1 减少对象创建

EPPlus操作中，频繁创建ExcelRange对象会导致性能下降。建议通过变量缓存常用单元格引用：

  1. var range = worksheet.Cells["A1:C10"];
  2. range.Style.Font.Bold = true; // 批量设置样式

4.2 异步保存

对于大文件，使用SaveAsAsync避免UI线程阻塞：

  1. await package.SaveAsAsync(new FileInfo("LargeFile.xlsx"));

4.3 内存管理

处理完成后及时释放资源：

  1. using (var package = new ExcelPackage(new FileInfo("Input.xlsx")))
  2. {
  3.     // 操作...
  4. } // 自动调用Dispose

五、常见问题与解决方案

5.1 样式未生效

原因：样式设置顺序错误或未保存文件。
解决：确保在Save()或SaveAs()前完成所有样式设置。

5.2 竖排文字显示错乱

原因：未调整列宽或单元格内容过长。
解决：手动设置列宽或启用自动换行：

  1. worksheet.Cells["A1"].Style.WrapText = true;

5.3 性能瓶颈

原因：单次写入大量数据。
解决：分批写入或使用LoadFromArrays批量处理。

六、总结与扩展

EPPlus库通过直观的API设计，为.NET开发者提供了高效的Excel操作能力。从单元格基础操作到样式定制，再到竖排文字等高级功能，开发者可灵活应对各类报表需求。未来，随着EPPlus版本的迭代，可进一步探索其与云存储（如百度智能云对象存储）的集成，实现自动化报表生成与分发。

通过本文的实践，开发者不仅能够掌握EPPlus的核心用法，还能通过性能优化和最佳实践提升代码质量，为项目交付提供可靠保障。

最新文章