深入解析C#中的第三方库NPOI：Excel和Word文件处理的利器

六月荷香

一、引言
在.NET开发中，操作Office文档（特别是Excel和Word）是一项常见的需求。然而，在服务器端或无Microsoft Office环境的场景下，直接使用Office Interop可能会面临挑战。为了解决这个问题，开源库NPOI应运而生，它提供了无需安装Office即可创建、读取和修改Excel (.xls, .xlsx) 和 Word (.doc) 文件的能力。
二、NPOI简介
NPOI是一个基于.NET的API，用于读写微软的OLE 2 Compound Document formats，如Microsoft Office Excel和Word。它是Apache POI项目的.NET移植版本，允许开发者在没有安装Office的情况下处理这些格式的文件。
三、主要组件与方法
1. 安装与引用
Install-Package NPOI
或者在Visual Studio中右键项目 -> 管理NuGet程序包 -> 搜索并安装NPOI。
2. 引用命名空间

1. using NPOI.SS.UserModel; // Excel相关的接口和类
2. using NPOI.XSSF.UserModel; // 处理.xlsx文件
3. using NPOI.HSSF.UserModel; // 处理.xls文件
4. using System.IO; // 文件操作

复制代码

3. 创建/打开工作簿

• 创建一个新的Excel工作簿（.xlsx）:
  var workbook = new XSSFWorkbook();
  
• 打开一个现有的Excel文件（.xlsx或.xls）:
  

1. FileStream file = new FileStream("path_to_your_file.xlsx", FileMode.Open, FileAccess.Read);
2. var workbook = new XSSFWorkbook(file); // .xlsx格式
3. var workbook = new HSSFWorkbook(file); // .xls格式

复制代码

4. 创建/获取工作表

• 创建新的工作表：
  ISheet sheet = workbook.CreateSheet("Sheet1");
  
• 获取已存在的工作表：
  ISheet sheet = workbook.GetSheetAt(0); // 获取索引为0的工作表
  5. 写入单元格数据
  
• 创建行与单元格：
  

1. IRow row = sheet.CreateRow(rowIndex);
2. ICell cell = row.CreateCell(columnIndex);

复制代码

• 设置单元格值：
  

1. cell.SetCellValue("文本内容"); // 文本
2. cell.SetCellValue(12345); // 数字

复制代码

6. 合并单元格

1. var region = new CellRangeAddress(startRow, endRow, startColumn, endColumn);
2. sheet.AddMergedRegion(region);

复制代码

7. 设置单元格样式

• 创建样式对象：
  var style = workbook.CreateCellStyle();
  
• 设置样式属性（如字体、颜色、对齐方式等）：
  

1. style.Alignment = HorizontalAlignment.Center;
2. IFont font = workbook.CreateFont();
3. font.Boldweight = (short)FontBoldWeight.Bold;
4. style.SetFont(font);

复制代码

• 应用到单元格：
  cell.CellStyle = style;
  8. 保存文件
  

1. FileStream outputStream = new FileStream("output.xlsx", FileMode.Create);
2. workbook.Write(outputStream);
3. outputStream.Close();

复制代码

9. 关闭资源

• 确保关闭Workbook以及相关的文件流以释放资源：
  

1. workbook.Close();
2. file.Close();

复制代码

四、高级功能

• 读取现有文件：通过FileStream打开并读取Excel文件内容。
  
• 读取公式结果：通过ICell.CachedFormulaResultType或ICell.CellFormula属性获取公式计算结果。
  
• 操作图表和图片：NPOI支持插入、更新和删除Excel中的图表和图片。
  
• 处理Word文档：通过XWPFDocument类来创建、读取和修改Word(.doc)文件。
  

五、总结
NPOI库凭借其强大的功能和轻量级设计，已成为.NET环境下处理Office文档的标准工具之一。无论是在Web应用程序后台处理用户上传的Excel文件，还是在批处理任务中生成报表，NPOI都能提供高效且易于使用的解决方案。通过深入理解和熟练运用NPOI的各种方法，开发者可以轻松应对各种复杂的文档处理任务。
六、完整的读取数据例子
[code]using NPOI.HSSF.UserModel;using NPOI.SS.UserModel;using System.IO;  public void ReadExcelFile(string filePath)    {        // 创建一个FileStream对象来打开Excel文件        using (FileStream file = new FileStream(filePath, FileMode.Open, FileAccess.Read))        {            // 根据文件扩展名选择合适的Workbook实现            IWorkbook workbook;            if (Path.GetExtension(filePath).ToLower() == ".xlsx")            {                workbook = new XSSFWorkbook(file);            }            else            {                workbook = new HSSFWorkbook(file); // 适用于.xls文件            }            // 获取第一个工作表（索引从0开始）            ISheet sheet = workbook.GetSheetAt(0);            // 遍历所有行            for (int rowIndex = 0; rowIndex