Leitura de Arquivo XLSX em C

Use o IronXL no seu projeto para uma maneira simples de trabalhar com formatos de arquivo Excel em C#. Você pode instalar o IronXL via download direto ou alternativamente usar NuGet Install para Visual Studio. O software é gratuito para desenvolvimento.

Install-Package IronXl.Excel

Antes de começar a ler arquivos XLSX, explore a documentação abrangente do IronXL para entender todos os recursos disponíveis. O IronXL suporta tanto os formatos .xls quanto .xlsx, tornando-o versátil para arquivos Excel legados e modernos.

Tutorial de Como Fazer

Por que usar o método WorkBook.Load()?

No código acima, a função WorkBook.Load() carrega sample.xlsx em workBook. Qualquer tipo de função pode ser executada em workBook acessando a planilha específica de um arquivo Excel. O método WorkBook.Load detecta automaticamente o formato do arquivo, seja ele XLS, XLSX, XLSM, XLTX ou CSV. Para cenários de carregamento mais avançados, confira o guia detalhado sobre carregamento de planilhas.

Quais são as diferentes maneiras de acessar uma planilha?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-worksheet.cs

using IronXL;

// Access sheet by name
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

workBook é o WorkBook que é declarado na parte acima.

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-worksheet-index.cs

using IronXL;

// Access sheet by index
WorkSheet workSheet = workBook.WorkSheets[0];

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-default-worksheet.cs

using IronXL;

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-worksheet.cs

using IronXL;
using System.Linq;

// Access the first worksheet
WorkSheet workSheet = workBook.WorkSheets.First();

OU

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-or-default-worksheet.cs

using IronXL;
using System.Linq;

// Access the first or default worksheet
WorkSheet workSheet = workBook.WorkSheets.FirstOrDefault();

Quando devo usar cada método de acesso à planilha?

Cada método tem seu caso de uso ideal:

• GetWorkSheet("name"): Quando você sabe o nome exato da folha
• WorkSheets[index]: Para iterar através das folhas programaticamente
• DefaultWorkSheet: Acesso rápido ao trabalhar com arquivos de folha única
• First() ou FirstOrDefault(): Opções seguras quando os nomes das folhas podem mudar

Depois de obter workSheet da ExcelSheet, você pode obter qualquer tipo de dado dela e executar todas as funções do Excel nela. Para operações mais complexas em planilhas, consulte o guia sobre abrir planilhas do Excel em C#.

Quais tipos de dados posso ler das células?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-data.cs

using IronXL;

// Accessing data as a string
string dataString = workSheet["A1"].ToString();

// Accessing data as an integer
int dataInt = workSheet["B1"].Int32Value;

O IronXL fornece vários acessadores de valores para diferentes tipos de dados:

• StringValue: Para dados de texto
• Int32Value: Para inteiros
• DoubleValue: Para decimais
• DateTimeValue: Para datas
• BoolValue: Para valores verdadeiro/falso

Como leio várias células de uma vez?

Você também pode obter dados de várias células de uma coluna específica:

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

Isso exibe os valores da célula A2 para A10. Para técnicas de seleção de faixa mais avançadas, visite o tutorial de seleção de faixas.

Como é uma implementação completa?

Um exemplo completo do código específico acima é fornecido aqui:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-log-data.cs

using IronXL;
using System;

// Load an Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Specify the range
foreach (var cell in workSheet["B2:B10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

Ele exibe o seguinte resultado:

Com o arquivo Excel Sample.xlsx:

Essas metodologias mostram como é fácil usar dados de arquivos do Excel em seu projeto. Para exemplos práticos de leitura de arquivos do Excel sem Interop, explore os exemplos de leitura do Excel.

Quais funções agregadas estão disponíveis?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-aggregate-function.cs

using IronXL;

// Apply aggregate functions
decimal sum = workSheet["G2:G10"].Sum(); // Sum of cells from G2 to G10
decimal min = workSheet["G2:G10"].Min(); // Minimum value in cells from G2 to G10
decimal max = workSheet["G2:G10"].Max(); // Maximum value in cells from G2 to G10

O IronXL suporta inúmeras funções matemáticas, incluindo:

• Average(): Calcular o valor médio
• Count(): Contar células não vazias
• CountIf(): Contar células que atendem a critérios
• Median(): Encontrar o valor do meio
• StdDev(): Calcular o desvio padrão

Como implemento várias funções juntas?

Para mais detalhes, confira nosso tutorial detalhado sobre Como Escrever Arquivos Excel em C# com especificidades sobre funções agregadas. Você também pode explorar a lista completa de funções matemáticas disponíveis no IronXL.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-min-max.cs

using IronXL;
using System;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Calculate sum, minimum, and maximum for a range of cells
decimal sum = workSheet["G2:G10"].Sum();
decimal min = workSheet["G2:G10"].Min();
decimal max = workSheet["G2:G10"].Max();

// Output results
Console.WriteLine("Sum is: {0}", sum);
Console.WriteLine("Min is: {0}", min);
Console.WriteLine("Max is: {0}", max);

Este código exibe a seguinte saída:

E é assim que o arquivo Excel Sample.xlsx parece:

Qual é o método básico de conversão?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable.cs

using IronXL;
using System.Data;

// Convert worksheet to DataTable
DataTable dt = workSheet.ToDataTable();

Como uso a primeira linha como cabeçalhos de coluna?

Para usar a primeira linha do ExcelSheet como DataTable ColumnName:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable-header.cs

using IronXL;
using System.Data;

// Convert worksheet to DataTable with the first row as column names
DataTable dt = workSheet.ToDataTable(true);

O parâmetro Booleano de ToDataTable() define a primeira linha como os nomes das colunas do seu DataTable. Por padrão, seu valor é False. Isso é especialmente útil ao trabalhar com dados estruturados que incluem cabeçalhos.

Como faço para iterar através do DataTable?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-print-datatable.cs

using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Convert WorkSheet to DataTable
DataTable dt = workSheet.ToDataTable(true); // Use first row as column names

// Iterate through rows and columns and display data
foreach (DataRow row in dt.Rows) // Access rows
{
    for (int i = 0; i < dt.Columns.Count; i++) // Access columns of corresponding row
    {
        Console.Write(row[i] + " ");
    }
    Console.WriteLine();
}

Usando o código acima, cada valor de célula da WorkSheet pode ser acessado e usado conforme necessário. Para operações de DataTable mais avançadas, consulte o guia sobre importar e exportar como DataSet.

Como converto um livro de trabalho em DataSet?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-excel-to-dataset.cs

using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Convert the WorkBook to a DataSet
DataSet ds = workBook.ToDataSet();

// Iterate through tables in the DataSet and display table names
foreach (DataTable dt in ds.Tables)
{
    Console.WriteLine(dt.TableName);
}

A saída do código acima se parece com isto:

E o arquivo Excel Sample.xlsx parece assim:

Como acesso cada valor de célula em todas as planilhas?

No exemplo acima, podemos facilmente analisar um arquivo do Excel em um DataSet e trabalhar com cada WorkSheet de um arquivo do Excel como um DataTable. Mergulhe mais fundo em como analisar o Excel como um DataSet aqui, com exemplos de código.

Vamos ver mais um exemplo de como acessar cada valor de célula de todas as ExcelSheets. Aqui, podemos acessar cada valor de célula de cada WorkSheet de um arquivo Excel.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-all-excel-sheets.cs

// ESTE TRECHO DE CÓDIGO NÃO ESTÁ DISPONÍVEL!

$vbLabelText   $csharpLabel

Usando o exemplo acima, é conveniente acessar cada valor de célula de cada WorkSheet de um arquivo Excel. Essa abordagem é particularmente útil ao lidar com livros de trabalho com múltiplas folhas, onde os dados são distribuídos por diferentes abas.

Para mais sobre como Ler Arquivos Excel Sem Interop, confira o código aqui. A documentação de referência da API fornece detalhes abrangentes sobre todos os métodos e propriedades disponíveis na Referência da API do IronXL.

---

Tutorial de Acesso Rápido

### Referência da API para IronXL

Leia mais sobre os recursos, classes, campos de método, namespaces e enums do IronXL na documentação.

Referência da API para IronXL