Como Importar Arquivos Excel em C

IronXL Torna a Importação do Excel Mais Fácil

Importe dados usando as funções fornecidas pela biblioteca IronXL Excel, que usaremos neste tutorial. O software está disponível gratuitamente para desenvolvimento. O IronXL oferece uma abrangente API Excel C# que simplifica o trabalho com arquivos Excel sem exigir o Microsoft Office ou dependências de Interop. Isso o torna ideal para ambientes de servidor e implantações em nuvem.

Métodos de instalação

Install-Package IronXl.Excel

Processo Básico de Carregamento de WorkBook

Para as necessidades do nosso projeto hoje, vamos importar dados do Excel em nossa aplicação C# usando o software IronXL instalado na etapa 1. A biblioteca suporta vários formatos de Excel e fornece métodos intuitivos para carregar planilhas.

Para o passo 2, carregaremos nosso Excel WorkBook em nosso projeto CSharp usando a função WorkBook.Load() do IronXL. Passamos o caminho do WorkBook do Excel como um parâmetro de string nessa função:

// Load Excel file
WorkBook wb = WorkBook.Load("Path");

// Load Excel file
WorkBook wb = WorkBook.Load("Path");

O arquivo Excel no caminho especificado será carregado em wb. Este método suporta formatos de planilha comuns como XLSX, XLS, CSV, TSV, entre outros.

Acessando uma Planilha Específica

Em seguida, precisamos acessar uma planilha específica do arquivo Excel cujos dados serão importados para o projeto. Para esse propósito, podemos usar a função GetWorkSheet() do IronXL, passando o nome da folha como um parâmetro de string para especificar qual folha do WorkBook importar. Saiba mais sobre a gestão de planilhas em nosso guia abrangente.

// Specify sheet name of Excel WorkBook
WorkSheet ws = wb.GetWorkSheet("SheetName");

// Specify sheet name of Excel WorkBook
WorkSheet ws = wb.GetWorkSheet("SheetName");

O WorkSheet será importado como ws, e wb é o WorkBook que definimos no exemplo de código acima.

Métodos Alternativos para Acessar Planilhas

Existem as seguintes maneiras alternativas de importar uma planilha Excel para o projeto. Cada método proporciona flexibilidade dependendo do seu caso de uso específico:

// Import WorkSheet by various methods

// by sheet indexing
WorkSheet mySheet = wb.WorkSheets[SheetIndex];

// get default WorkSheet
WorkSheet defaultSheet = wb.DefaultWorkSheet;

// get first WorkSheet
WorkSheet firstSheet = wb.WorkSheets.First();

// for the first or default sheet
WorkSheet firstOrDefaultSheet = wb.WorkSheets.FirstOrDefault();

// Import WorkSheet by various methods

// by sheet indexing
WorkSheet mySheet = wb.WorkSheets[SheetIndex];

// get default WorkSheet
WorkSheet defaultSheet = wb.DefaultWorkSheet;

// get first WorkSheet
WorkSheet firstSheet = wb.WorkSheets.First();

// for the first or default sheet
WorkSheet firstOrDefaultSheet = wb.WorkSheets.FirstOrDefault();

Agora, podemos facilmente importar qualquer tipo de dado dos arquivos Excel especificados. Vamos explorar todos os possíveis aspectos para importar dados de arquivos Excel em nosso projeto.

Método Básico de Importação de Células

Este é o aspecto básico da importação de dados de arquivos Excel em nosso projeto. IronXL fornece várias maneiras de acessar dados de células, tornando-o flexível para diferentes cenários.

Para isso, podemos usar um sistema de endereçamento de células para especificar quais dados de células precisamos importar. Ele retorna o valor de um endereço específico de célula do arquivo Excel:

var cellValue = ws["Cell Address"];

var cellValue = ws["Cell Address"];

Importando Dados Usando Índices de Linha e Coluna

Também podemos importar dados de células de arquivos Excel usando índices de linha e coluna. Esta linha de código retorna o valor do índice de linha e coluna especificado. Esta abordagem é particularmente útil ao iterar dados programaticamente:

var cellValueByIndex = ws.Rows[RowIndex].Columns[ColumnIndex];

var cellValueByIndex = ws.Rows[RowIndex].Columns[ColumnIndex];

Armazenando Valores Importados em Variáveis

Para atribuir valores de células importados a variáveis, use este código. O método ToString() garante compatibilidade com variáveis de string, mas você também pode fazer conversões para outros tipos conforme necessário:

// Import Data by Cell Address
// by cell addressing
string val = ws["Cell Address"].ToString();

// by row and column indexing
string valWithIndexing = ws.Rows[RowIndex].Columns[ColumnIndex].Value.ToString();

// for numeric values
decimal numericValue = ws["B2"].DecimalValue;

// for date values
DateTime dateValue = ws["C2"].DateTimeValue;

// Import Data by Cell Address
// by cell addressing
string val = ws["Cell Address"].ToString();

// by row and column indexing
string valWithIndexing = ws.Rows[RowIndex].Columns[ColumnIndex].Value.ToString();

// for numeric values
decimal numericValue = ws["B2"].DecimalValue;

// for date values
DateTime dateValue = ws["C2"].DateTimeValue;

Nos exemplos acima, o índice de linha e coluna começa em 0. Para operações de célula mais avançadas, explore nosso guia sobre limpeza de células e cópia de células.

Sintaxe da Função de Intervalo

To import data in a specific range from an Excel WorkBook, use the range function. Defina o intervalo descrevendo os endereços das células inicial e final. Isso retorna todos os valores de células dentro do intervalo especificado. Para técnicas abrangentes de seleção de intervalo, veja nosso guia de seleção de intervalo.

var rangeData = ws["Starting Cell Address:Ending Cell Address"];

var rangeData = ws["Starting Cell Address:Ending Cell Address"];

Exemplo Completo de Importação de Intervalo

Para mais informações sobre como trabalhar com intervalos em arquivos Excel e aprender mais sobre como extrair dados de diferentes maneiras. O exemplo a seguir demonstra a importação de valores de células individuais e intervalos:

:path=/static-assets/excel/content-code-examples/how-to/csharp-import-excel-import.cs

using IronXL;
using System;

// Import Excel WorkBook
WorkBook wb = WorkBook.Load("sample.xlsx");

// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");

// Import data of specific cell
string val = ws["A4"].Value.ToString();
Console.WriteLine("Import Value of A4 Cell address: {0}", val);

Console.WriteLine("import Values in Range From B3 To B9 :\n");

// Import data in specific range
foreach (var item in ws["B3:B9"])
{
    Console.WriteLine(item.Value.ToString());
}

Console.ReadKey();

O código acima exibe a seguinte saída:

With the values of Excel file sample.xlsx as:

Funções Agregadas Disponíveis

Aplique funções agregadas a arquivos Excel e importe os dados resultantes dessas funções. IronXL fornece funções matemáticas integradas que tornam a análise de dados direta. Aqui estão exemplos de diferentes funções e seu uso:

• Sum()

  // To find the sum of a specific cell range
  var sum = ws["Starting Cell Address:Ending Cell Address"].Sum();

  // To find the sum of a specific cell range
  var sum = ws["Starting Cell Address:Ending Cell Address"].Sum();

  $vbLabelText   $csharpLabel

• Average()

  // To find the average of a specific cell range
  var average = ws["Starting Cell Address:Ending Cell Address"].Avg();

  // To find the average of a specific cell range
  var average = ws["Starting Cell Address:Ending Cell Address"].Avg();

  $vbLabelText   $csharpLabel

• Min()

  // To find the minimum in a specific cell range
  var minimum = ws["Starting Cell Address:Ending Cell Address"].Min();

  // To find the minimum in a specific cell range
  var minimum = ws["Starting Cell Address:Ending Cell Address"].Min();

  $vbLabelText   $csharpLabel

• Max()

  // To find the maximum in a specific cell range
  var maximum = ws["Starting Cell Address:Ending Cell Address"].Max();

  // To find the maximum in a specific cell range
  var maximum = ws["Starting Cell Address:Ending Cell Address"].Max();

  $vbLabelText   $csharpLabel

Usando Múltiplas Funções Agregadas Juntas

Leia mais sobre como trabalhar com funções agregadas no Excel para C# e aprenda mais sobre como extrair dados de diferentes métodos. Essas funções são particularmente úteis para gerar estatísticas resumidas ou validar dados importados.

Veja um exemplo de importação de dados de arquivo Excel aplicando essas funções:

:path=/static-assets/excel/content-code-examples/how-to/csharp-import-excel-math-functions.cs

using IronXL;
using System;

// Import Excel file
WorkBook wb = WorkBook.Load("sample.xlsx");

// Specify WorkSheet
WorkSheet ws = wb.GetWorkSheet("Sheet1");

// Import Excel file data by applying aggregate functions
decimal sum = ws["D2:D9"].Sum();
decimal avg = ws["D2:D9"].Avg();
decimal min = ws["D2:D9"].Min();
decimal max = ws["D2:D9"].Max();

Console.WriteLine("Sum From D2 To D9: {0}", sum);
Console.WriteLine("Avg From D2 To D9: {0}", avg);
Console.WriteLine("Min From D2 To D9: {0}", min);
Console.WriteLine("Max From D2 To D9: {0}", max);

Console.ReadKey();

O código acima nos dá este resultado:

E nosso arquivo sample.xlsx contém estes valores:

O Método ToDataSet

Para importar dados completos de arquivo Excel em um projeto C#, primeiro analise o WorkBook carregado em um DataSet. Dessa forma, os dados completos do Excel são importados para o DataSet, e as Planilhas nos arquivos Excel se tornam DataTables dentro desse DataSet. Esta abordagem é particularmente útil para operações de banco de dados ou quando se trabalha com controles vinculados a dados. Saiba mais sobre a importação e exportação como DataSet.

// Import WorkBook into DataSet
DataSet ds = wb.ToDataSet();

// Import WorkBook into DataSet
DataSet ds = wb.ToDataSet();

Isso importa nossa Planilha especificada em um DataSet para uso conforme necessário. Este método é especialmente poderoso ao trabalhar com várias planilhas simultaneamente ou ao integrar dados do Excel com operações ADO.NET.

Tratando Cabeçalhos de Colunas

Frequentemente, a primeira linha de um arquivo Excel serve como nomes das colunas. Nesse caso, torne a primeira linha os nomes das colunas do DataTable. Defina o parâmetro booleano da função ToDataSet() do IronXL da seguinte forma:

// Import WorkBook into DataSet with first row as ColumnNames
DataSet ds = wb.ToDataSet(true);

// Import WorkBook into DataSet with first row as ColumnNames
DataSet ds = wb.ToDataSet(true);

Isso torna a primeira linha do arquivo Excel os nomes das colunas do DataTable, o que é essencial para manter a integridade da estrutura de dados ao trabalhar com dados estruturados do Excel.

Exemplo Completo de Importação de DataSet

Veja um exemplo completo de importação de dados do Excel para um DataSet e uso da primeira linha de uma Planilha Excel como nomes de colunas do DataTable:

:path=/static-assets/excel/content-code-examples/how-to/csharp-import-excel-dataset.cs

using IronXL;
using System;
using System.Data;

WorkBook wb = WorkBook.Load("sample.xlsx");
WorkSheet ws = wb.GetWorkSheet("Sheet1");

// Import Excel data into a DataSet
DataSet ds = wb.ToDataSet(true);

Console.WriteLine("Excel file data imported to dataset successfully.");
Console.ReadKey();

$vbLabelText   $csharpLabel

Trabalhar com funções Dataset e DataTable do Excel pode ser complexo, mas temos mais exemplos disponíveis para incorporar dados de arquivo em seu projeto C#. Para cenários avançados, considere explorar nossos guias sobre Excel para SQL via DataTable e carregamento de Excel a partir de banco de dados SQL.

---

Acesso rápido à biblioteca

### Explore a Referência IronXL

Saiba mais sobre como extrair dados do Excel via células, intervalos, conjuntos de dados e datatables em nossa documentação completa de Referência de API para IronXL.

Explore a Referência IronXL