一、引言
在.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. 引用命名空间
using NPOI.SS.UserModel; // Excel相关的接口和类
using NPOI.XSSF.UserModel; // 处理.xlsx文件
using NPOI.HSSF.UserModel; // 处理.xls文件
using System.IO; // 文件操作
3. 创建/打开工作簿
- 创建一个新的Excel工作簿(.xlsx):
var workbook = new XSSFWorkbook();
- 打开一个现有的Excel文件(.xlsx或.xls):
FileStream file = new FileStream("path_to_your_file.xlsx", FileMode.Open, FileAccess.Read);
var workbook = new XSSFWorkbook(file); // .xlsx格式
var workbook = new HSSFWorkbook(file); // .xls格式
4. 创建/获取工作表
- 创建新的工作表:
ISheet sheet = workbook.CreateSheet("Sheet1");
- 获取已存在的工作表:
ISheet sheet = workbook.GetSheetAt(0); // 获取索引为0的工作表
5. 写入单元格数据
- 创建行与单元格:
IRow row = sheet.CreateRow(rowIndex);
ICell cell = row.CreateCell(columnIndex);
- 设置单元格值:
cell.SetCellValue("文本内容"); // 文本
cell.SetCellValue(12345); // 数字
6. 合并单元格
var region = new CellRangeAddress(startRow, endRow, startColumn, endColumn);
sheet.AddMergedRegion(region);
7. 设置单元格样式
- 创建样式对象:
var style = workbook.CreateCellStyle();
- 设置样式属性(如字体、颜色、对齐方式等):
style.Alignment =