NPOI 操作详解（操作Excel）

目录

[1. 安装 NPOI](#1. 安装 NPOI)

[2. 使用 NPOI 创建新 Excel 文件](#2. 使用 NPOI 创建新 Excel 文件)

[3. 设置列宽和行高](#3. 设置列宽和行高)

[1. 设置列宽](#1. 设置列宽)

[2. 设置行高](#2. 设置行高)

[3. 同时设置列宽和行高](#3. 同时设置列宽和行高)

[4. 设置统一的行高](#4. 设置统一的行高)

[5. 设置统一的列宽](#5. 设置统一的列宽)

[6. 应用统一的行高和列宽](#6. 应用统一的行高和列宽)

[4. 合并单元格](#4. 合并单元格)

[5. 设置单元格样式（字体、边框、背景色等）](#5. 设置单元格样式（字体、边框、背景色等）)

[5. 向现有的 Excel 文件追加数据](#5. 向现有的 Excel 文件追加数据)

[6. 综合操作示例](#6. 综合操作示例)

---

概述：NPOI 是一个功能强大的第三方库，支持 .xls 和 .xlsx 格式，且完全开源。NPOI 可以在任何平台上运行，无需安装 Excel。

优点： 跨平台，支持 .xls 和 .xlsx 格式，性能较好。
**缺点：**与原生 Excel 功能兼容性较低，格式化和高级功能支持相对有限。

1. 安装 NPOI

2. 使用 NPOI 创建新 Excel 文件

以下代码演示了如何使用 NPOI 创建一个新的 Excel 文件，并向其中写入 DataTable 数据。

using System.Data;
using System.IO;
using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel; // 对于 .xlsx 文件
using NPOI.HSSF.UserModel; // 对于 .xls 文件

public void CreateNewExcel(string filePath, DataTable dataTable)
{
    IWorkbook workbook;
    if (filePath.EndsWith(".xlsx"))
        workbook = new XSSFWorkbook(); // 创建 .xlsx 文件
    else
        workbook = new HSSFWorkbook(); // 创建 .xls 文件

    var sheet = workbook.CreateSheet("Sheet1");

    // 写入表头
    var headerRow = sheet.CreateRow(0);
    for (int i = 0; i < dataTable.Columns.Count; i++)
    {
        headerRow.CreateCell(i).SetCellValue(dataTable.Columns[i].ColumnName);
    }

    // 写入数据
    for (int i = 0; i < dataTable.Rows.Count; i++)
    {
        var dataRow = sheet.CreateRow(i + 1);
        for (int j = 0; j < dataTable.Columns.Count; j++)
        {
            dataRow.CreateCell(j).SetCellValue(dataTable.Rows[i][j].ToString());
        }
    }

    // 保存文件
    using (var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write))
    {
        workbook.Write(stream);
    }
}

3. 设置列宽和行高

1. 设置列宽

public void SetColumnWidth(IWorkbook workbook, int sheetIndex, int columnIndex)
{
    var sheet = workbook.GetSheetAt(sheetIndex);

    // 设置列宽（单位是 1/256 字符宽度）
    sheet.SetColumnWidth(columnIndex, 20 * 256); // 设置第 1 列宽度为 20
}

2. 设置行高

public void SetColumnRowHeight(IWorkbook workbook, int sheetIndex, int rowIndex)
{
    var sheet = workbook.GetSheetAt(sheetIndex);

    // 设置行高（单位是点数）
    var row = sheet.GetRow(rowIndex) ?? sheet.CreateRow(rowIndex);
    row.HeightInPoints = 25; // 设置行高为 25 点
}

3. 同时设置列宽和行高

public void SetColumnWidthAndRowHeight(IWorkbook workbook, int sheetIndex, int columnIndex, int rowIndex)
{
    var sheet = workbook.GetSheetAt(sheetIndex);

    // 设置列宽（单位是 1/256 字符宽度）
    sheet.SetColumnWidth(columnIndex, 20 * 256); // 设置第 1 列宽度为 20

    // 设置行高（单位是点数）
    var row = sheet.GetRow(rowIndex) ?? sheet.CreateRow(rowIndex);
    row.HeightInPoints = 25; // 设置行高为 25 点
}

4. 设置统一的行高

在 NPOI 中，行高是通过每一行对象来设置的。可以遍历所有行并设置它们的行高，也可以在每次创建行时直接设定统一的高度。

public void SetUniformRowHeight(ISheet sheet, float heightInPoints)
{
    for (int i = 0; i <= sheet.LastRowNum; i++)
    {
        var row = sheet.GetRow(i) ?? sheet.CreateRow(i);
        row.HeightInPoints = heightInPoints; // 设置行高
    }
}

5. 设置统一的列宽

列宽可以直接对整个列进行设置，无需单独遍历单元格。列宽是以 1/256 字符宽度为单位的，设置时需要乘以 256。

public void SetUniformColumnWidth(ISheet sheet, int widthInCharacters)
{
    for (int i = 0; i < sheet.GetRow(0).LastCellNum; i++) // 以第一行的单元格数量为列数
    {
        sheet.SetColumnWidth(i, widthInCharacters * 256); // 设置列宽
    }
}

6. 应用统一的行高和列宽

可以将行高和列宽设置封装在一个方法中调用：

public void SetUniformRowHeightAndColumnWidth(ISheet sheet, float rowHeightInPoints, int columnWidthInCharacters)
{
    SetUniformRowHeight(sheet, rowHeightInPoints);
    SetUniformColumnWidth(sheet, columnWidthInCharacters);
}

使用示例：

假设我们有一个表格 sheet，要将所有行高统一设置为 20 点，列宽统一设置为 15 个字符宽：

SetUniformRowHeightAndColumnWidth(sheet, 20, 15);

这样就能高效地将整个表格的行高和列宽统一设置，无需遍历每个单元格。

4. 合并单元格

合并单元格可以通过 CellRangeAddress 设置，需要定义起始和结束的行列。

using NPOI.SS.Util;

public void MergeCells(IWorkbook workbook, int sheetIndex, int firstRow, int lastRow, int firstCol, int lastCol)
{
    var sheet = workbook.GetSheetAt(sheetIndex);

    // 合并单元格
    var cellRangeAddress = new CellRangeAddress(firstRow, lastRow, firstCol, lastCol);
    sheet.AddMergedRegion(cellRangeAddress);

    // 可以对合并后的单元格设置样式
    var cell = sheet.GetRow(firstRow).GetCell(firstCol) ?? sheet.GetRow(firstRow).CreateCell(firstCol);
    var style = workbook.CreateCellStyle();
    style.Alignment = HorizontalAlignment.Center;
    cell.CellStyle = style;
}

5. 设置单元格样式（字体、边框、背景色等）

使用 ICellStyle 进行字体、对齐、边框、背景等样式的配置：

public void SetCellStyle(IWorkbook workbook, int sheetIndex, int rowIndex, int colIndex)
{
    var sheet = workbook.GetSheetAt(sheetIndex);
    var cell = sheet.GetRow(rowIndex).GetCell(colIndex) ?? sheet.GetRow(rowIndex).CreateCell(colIndex);

    var style = workbook.CreateCellStyle();

    // 设置字体
    var font = workbook.CreateFont();
    font.FontHeightInPoints = 12;
    font.FontName = "Arial";
    font.IsBold = true;
    style.SetFont(font);

    // 设置边框
    style.BorderBottom = BorderStyle.Thin;
    style.BorderLeft = BorderStyle.Thin;
    style.BorderRight = BorderStyle.Thin;
    style.BorderTop = BorderStyle.Thin;

    // 设置背景颜色
    style.FillForegroundColor = IndexedColors.LightBlue.Index;
    style.FillPattern = FillPattern.SolidForeground;

    cell.CellStyle = style;
    cell.SetCellValue("示例文本");
}

5. 向现有的 Excel 文件追加数据

追加数据时，可以定位到现有数据的末尾，创建新行并写入。

public void AppendDataToExistingExcel(string filePath, DataTable dataTable)
{
    IWorkbook workbook;
    using (var stream = new FileStream(filePath, FileMode.Open, FileAccess.Read))
    {
        workbook = filePath.EndsWith(".xlsx") ? (IWorkbook)new XSSFWorkbook(stream) : new HSSFWorkbook(stream);
    }

    var sheet = workbook.GetSheetAt(0);
    int lastRowNum = sheet.LastRowNum;

    for (int i = 0; i < dataTable.Rows.Count; i++)
    {
        var dataRow = sheet.CreateRow(lastRowNum + i + 1);
        for (int j = 0; j < dataTable.Columns.Count; j++)
        {
            dataRow.CreateCell(j).SetCellValue(dataTable.Rows[i][j].ToString());
        }
    }

    using (var stream = new FileStream(filePath, FileMode.Open, FileAccess.Write))
    {
        workbook.Write(stream);
    }
}

6. 综合操作示例

将所有设置组合在一起，确保不同操作可以在一个文件中同时应用：

public void FullExample(string filePath, DataTable dataTable)
{
    IWorkbook workbook = filePath.EndsWith(".xlsx") ? (IWorkbook)new XSSFWorkbook() : new HSSFWorkbook();
    var sheet = workbook.CreateSheet("Sheet1");

    // 设置表头
    var headerRow = sheet.CreateRow(0);
    for (int i = 0; i < dataTable.Columns.Count; i++)
    {
        headerRow.CreateCell(i).SetCellValue(dataTable.Columns[i].ColumnName);
    }

    // 写入数据
    for (int i = 0; i < dataTable.Rows.Count; i++)
    {
        var dataRow = sheet.CreateRow(i + 1);
        for (int j = 0; j < dataTable.Columns.Count; j++)
        {
            dataRow.CreateCell(j).SetCellValue(dataTable.Rows[i][j].ToString());
        }
    }

    // 设置列宽和行高
    SetColumnWidthAndRowHeight(workbook, 0, 1, 1);

    // 合并单元格（比如合并第 2 行第 1 列到第 2 列）
    MergeCells(workbook, 0, 1, 1, 0, 1);

    // 设置单元格样式
    SetCellStyle(workbook, 0, 1, 1);

    // 保存文件
    using (var stream = new FileStream(filePath, FileMode.Create, FileAccess.Write))
    {
        workbook.Write(stream);
    }
}

总结：

• 创建、读取、追加、设置样式等基本操作可以涵盖常见的 NPOI 使用场景。
• NPOI 适合处理数据量较大的 Excel 文件，不依赖于 Excel 安装，并且支持 .xls 和 .xlsx 格式。