O NPOI é uma API .NET de código aberto para o desenvolvimento de aplicativos para trabalhar com planilhas. Está disponível gratuitamente e você pode usá -lo em seus projetos .NET. O NPOI é simples, fácil de usar e pode ser configurado facilmente para começar a trabalhar com planilhas do Excel. Neste artigo, exploraremos o trabalho com a API NPOI para criar, ler e salvar arquivos do Excel XLSX, embora possa funcionar com o formato de arquivo XLS da mesma maneira. Este artigo contém detalhes sobre a instalação da API NPOI, configurando o ambiente de desenvolvimento e trabalhando com planilhas usando o NPOI.

  1. Guia de instalação para API NPOI: A primeira etapa para usar a API NPOI é instalar o pacote. Você pode instalar o NPOI baixando o pacote no site oficial ou usando o Nuget Package Manager no Visual Studio. Depois que o pacote for instalado, você pode começar a usá -lo em seu projeto. Veja este Guia de Instalação NPOI para referência.
  2. Configurando o ambiente de desenvolvimento: Para usar a API NPOI, você deve ter o ambiente de desenvolvimento pronto para trabalhar com ele. Você pode instalar o Visual Studio em sua máquina para esse fim.
  3. Criando uma nova planilha usando API NPOI: Agora que seu ambiente está configurado, você pode começar a trabalhar com a API em seu projeto, incluindo uma referência às suas DLLs.

Trabalhando com planilhas

Tudo bem, então agora que você está configurado NPOI, vamos começar o uso da API NPOI para trabalhar com arquivos XLSX. Especificamente, seremos:

  • Criando uma nova planilha usando NPOI em C#
  • Lendo dados de um arquivo XLSX com NPOI
  • Salvando uma planilha do Excel como XLSX usando NPOI

Crie uma nova planilha usando npoi em C#

O snippet de código a seguir demonstra como criar uma nova planilha com uma única planilha:

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// create a new workbook
IWorkbook wb = new XSSFWorkbook();

// create a new worksheet
ISheet ws = wb.CreateSheet("Sheet1");

// create a new row
IRow row = ws.CreateRow(0);

// create a new cell and set its value
ICell cell = row.CreateCell(0);
cell.SetCellValue("Hello World!");

// save the workbook
using (var fileStream = new FileStream("myWorkbook.xlsx", FileMode.Create, FileAccess.Write))
{
    wb.Write(fileStream);
}

lendo dados de planilhas usando npoi api

Uma das tarefas mais comuns ao trabalhar com planilhas é ler dados deles. A API NPOI fornece várias maneiras de ler dados das planilhas. O snippet de código a seguir demonstra como ler dados de uma célula em uma planilha:

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// load an existing workbook
IWorkbook wb = new XSSFWorkbook("myWorkbook.xlsx");

// get the first worksheet
ISheet ws = wb.GetSheetAt(0);

// get the first row
IRow row = ws.GetRow(0);

// get the first cell
ICell cell = row.GetCell(0);

// get the cell value
string cellValue = cell.StringCellValue;

escrevendo dados para planilhas usando npoi api

Outra tarefa comum ao trabalhar com planilhas está escrevendo dados para elas. A API NPOI fornece várias maneiras de escrever dados para planilhas. O snippet de código a seguir demonstra como escrever dados em uma célula em uma planilha:

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// load an existing workbook
IWorkbook wb = new XSSFWorkbook("myWorkbook.xlsx");

// get the first worksheet
ISheet ws = wb.GetSheetAt(0);

// get the first row
IRow row = ws.GetRow(0);

// get the first cell
ICell cell = row.CreateCell(1);

// set the cell value
cell.SetCellValue("World!");

// save the workbook
using (var fileStream = new FileStream("myWorkbook.xlsx", FileMode.Create, FileAccess.Write))
{
    wb.Write(fileStream);
}

No exemplo acima, carregamos uma pasta de trabalho existente e recuperamos a primeira planilha. Em seguida, recuperamos a primeira linha e criamos uma nova célula no índice da coluna 1. Definimos o valor da célula e salvarmos a pasta de trabalho.

Atualizando as planilhas existentes usando a API NPOI

A NPOI API também fornece várias maneiras de atualizar as planilhas existentes. O snippet de código a seguir demonstra como atualizar o valor de uma célula em uma planilha.

using NPOI.SS.UserModel;
using NPOI.XSSF.UserModel;

// load an existing workbook
IWorkbook wb = new XSSFWorkbook("myWorkbook.xlsx");

// get the first worksheet
ISheet ws = wb.GetSheetAt(0);

// get the first row
IRow row = ws.GetRow(0);

// get the first cell
ICell cell = row.GetCell(0);

// set the cell value
cell.SetCellValue("Hello NPOI!");

// save the workbook
using (var fileStream = new FileStream("myWorkbook.xlsx", FileMode.Create, FileAccess.Write))
{
    wb.Write(fileStream);
}

No exemplo acima, carregamos uma pasta de trabalho existente e recuperamos a primeira planilha. Em seguida, recuperamos a primeira linha e a primeira célula e atualizamos o valor da célula. Finalmente, salvamos a pasta de trabalho.

mais exemplos npoi para trabalhar com planilhas