Что такое NPOI?

NPOI - это .NET-версия проекта POI на Java, расположенного по адресу http://poi.apache.org/. POI является проектом с открытым исходным кодом, который может помочь вам читать/записывать файлы xls(x), doc(x), ppt(x). Он имеет широкое применение.
Например, вы можете использовать его для:

  • создания отчета Excel без установленного на сервере пакета Microsoft Office и более эффективной работы, чем вызов компонента Microsoft Excel ActiveX в фоновом режиме;

  • извлечения текста и изображений из документов Excel, Word и PowerPoint;

  • создания листов Excel, содержащих формулы.

В этой статье я собираюсь познакомить вас с тем, как создавать, читать и обновлять файлы .XLSX с использованием NPOI на языке C#.

Установка NOPI через NuGet

PM>Install-Package NPOI

Использование пространства имен NPOI

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;
using NPOI.SS.Util;
using NPOI.HSSF.Util;

Пример 1. Создание нового документа Excel и добавление данных

// Создание новой рабочей книги
IWorkbook workbook = new XSSFWorkbook();

// Создание нового листа
ISheet sheet = workbook.CreateSheet("Sheet1");

// Добавление данных в ячейки
IRow row = sheet.CreateRow(0);
row.CreateCell(0).SetCellValue("Привет");
row.CreateCell(1).SetCellValue("Мир");

// Сохранение документа Excel
using (FileStream fileStream = new FileStream("path/file.xlsx", FileMode.Create))
{
    workbook.Write(fileStream, false);
}

Пример 2. Чтение данных из существующего документа Excel

// Открытие существующей рабочей книги
IWorkbook workbook;
using (FileStream fileStream = new FileStream("path/file.xlsx", FileMode.Open, FileAccess.Read))
{
    workbook = new XSSFWorkbook(fileStream);
}

// Получение листа
ISheet sheet = workbook.GetSheetAt(0);

// Чтение данных из ячейки
IRow row = sheet.GetRow(0);
string cellValue = row.GetCell(0).StringCellValue;

// Вывод данных ячейки
Console.WriteLine(cellValue);

Пример 3. Обновление данных в документе Excel

// Открытие существующей рабочей книги
IWorkbook workbook;
using (FileStream fileStream = new FileStream("path/file.xlsx", FileMode.Open, FileAccess.ReadWrite))
{
    workbook = new XSSFWorkbook(fileStream);
}

// Получение листа
ISheet sheet = workbook.GetSheetAt(0);

// Обновление данных ячейки
IRow row = sheet.GetRow(0);
row.GetCell(0).SetCellValue("Обновленное значение");

// Сохранение документа Excel
using (FileStream fileStream = new FileStream("path/file.xlsx", FileMode.Create))
{
    workbook.Write(fileStream, false);
}

Дополнительные настройки

Объединение ячеек:

// Параметры CellRangeAddress: начальная строка, конечная строка, начальный столбец, конечный столбец
sheet.AddMergedRegion(new CellRangeAddress(0, 0, 0, 0));

Настройка выравнивания:

// Создание объекта стиля
ICellStyle cellStyle = workbook.CreateCellStyle();
// Настройка горизонтального выравнивания
cellStyle.Alignment = NPOI.SS.UserModel.HorizontalAlignment.Center;
// Настройка вертикального выравнивания
cellStyle.VerticalAlignment = NPOI.SS.UserModel.VerticalAlignment.Center;
// Настройка отступа
cellStyle.Indention = 3;
// Автоматический перенос текста
cellStyle.WrapText = true;
// Уменьшение размера шрифта для заполнения ячейки
cellStyle.ShrinkToFit = true;
// Вращение текста
cellStyle.Rotation = 90;
// Применение стиля
sheet.GetRow(0).GetCell(0).CellStyle = cellStyle;

Настройка шрифта:

// Создание объекта шрифта
IFont font = workbook.CreateFont();
// Настройка шрифта
font.FontName = "Times New Roman";
// Жирный шрифт
font.IsBold = true;
// Курсивный шрифт
font.IsItalic = true;
// Размер шрифта
font.FontHeightInPoints = 14;
// Подчеркнутый шрифт
font.Underline = FontUnderlineType.Single;
// Цвет шрифта
font.Color = HSSFColor.Black.Index;
// Зачеркнутый шрифт
font.IsStrikeout = true;
// Верхний индекс
//font.TypeOffset = FontSuperScript.Super;
// Нижний индекс
//font.TypeOffset = FontSuperScript.Sub;
// Создание объекта стиля
ICellStyle cellStyle = workbook.CreateCellStyle();
cellStyle.SetFont(font);
// Применение стиля
sheet.GetRow(0).GetCell(0).CellStyle = cellStyle;

Настройка цвета заливки ячейки:

// Создание объекта стиля
ICellStyle cellStyle = workbook.CreateCellStyle();
// Настройка цвета
cellStyle.FillForegroundColor = NPOI.HSSF.Util.HSSFColor.Pink.Index;
cellStyle.FillPattern = FillPattern.SolidForeground;
// Применение стиля
sheet.GetRow(0).GetCell(0).CellStyle = cellStyle;

Настройка высоты строки и ширины столбца:

// Высота строки
row.Height = 25 * 20;
// Ширина столбца
sheet.SetColumnWidth(0, 18 * 256);

Комментарии (1)


  1. CrazyAlex25
    04.07.2023 07:29
    +2

    Было интересно увидеть сравнение EPPlus vs NPOI vs OpenXML в удобстве использования и возможностей