npoi教程-2.1 单元格合并

在NPOI库中，提供了合并单元格的功能。合并单元格是指将多个单元格合并成一个单元格，这样可以获得更加美观的表格布局。

1. 调用合并单元格的方法

使用NPOI库合并单元格非常简单，只需要调用单元格的Merge方法即可。

ICellRange mergedCell = sheet.AddMergedRegion(new CellRangeAddress(firstRow, lastRow, firstCol, lastCol));

其中，参数CellRangeAddress表示需要合并的单元格范围。firstRow和lastRow表示需要合并的单元格所在行范围，firstCol和lastCol表示需要合并的单元格所在列范围。ICellRange是合并后单元格的引用，通过ICellRange可以获得合并后单元格的值。

2. 示例代码

下面我们示范一个合并单元格的代码：

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;
using System.IO;

namespace ConsoleApp1
{
    class Program
    {
        static void Main(string[] args)
        {
            IWorkbook workbook = new XSSFWorkbook();
            ISheet sheet = workbook.CreateSheet("Sheet1");
            IRow row = sheet.CreateRow(0);

            ICell cell1 = row.CreateCell(0);
            ICell cell2 = row.CreateCell(1);
            ICell cell3 = row.CreateCell(2);

            cell1.SetCellValue("合并单元格");
            cell2.SetCellValue("");
            cell3.SetCellValue("");

            CellRangeAddress region = new CellRangeAddress(0, 0, 0, 2);
            sheet.AddMergedRegion(region);

            FileStream sw = File.Create("test.xlsx");
            workbook.Write(sw);
            sw.Close();
        }
    }
}

代码中我们创建了一个.xlsx格式的工作簿，创建了一个数据行Row。其中，第1个单元格设置了值“合并单元格”并且合并了第1到第3个单元格。代码执行结束后会生成一个名为test.xlsx的文件。

3. 总结

本文介绍了NPOI库的合并单元格功能，让表格更加美观清晰。合并单元格是开发中经常需要用到的功能，在NPOI库也提供了非常便捷的方法调用。在实际项目中使用NPOI库开发Excel表格，可以极大提高工作效率，减少开发难度。