IRONSOFTWAREHOME

Leitura de Arquivo XLSX em C#

Curtis Chau
Curtis Chau
Updated: 9 de maio de 2026

Para ler arquivos XLSX em C#, use o método WorkBook.Load do IronXL para abrir arquivos Excel e acessar planilhas para ler dados de células, realizar cálculos e converter para formatos DataTable ou DataSet programaticamente.

Início Rápido: Carregue um workbook e acesse uma planilha sem esforço

Com o IronXL, você pode carregar um arquivo XLSX usando o método WorkBook.Load em uma única linha. Em seguida, acesse sua primeira ou nomeada planilha instantaneamente e comece a ler os valores das células.

  1. 1Install IronXL with NuGet Package Manager

    PM > Install-Package IronXL.Excel

  2. 2Copie e execute este trecho de código.

    IronXL.WorkBook workbook = IronXL.WorkBook.Load("your-file.xlsx");
    C#
  3. 3Implante para testar em seu ambiente de produção.

    Comece a usar IronXL em seu projeto hoje com uma avaliação gratuita
    arrow pointer

Ler arquivos .XLSX em C#

  • Obtenha o IronXL para o seu projeto
  • Carregar um WorkBook
  • Acessar dados de um WorkSheet
  • Aplicar funções como Soma, Mínimo e Máximo
  • Ler um WorkSheet como um DataTable, DataSet e mais

Como obtenho o IronXL para o meu projeto?

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.

PM > 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

Como carrego um WorkBook?

O WorkBook é a classe do IronXL cujo objeto fornece acesso completo ao arquivo Excel e a todas as suas funções. Por exemplo, para acessar um arquivo Excel, use o código:

using IronXL;

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

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

No código acima, a função Load() carrega WorkBook em WorkBook. Qualquer tipo de função pode ser realizada em WorkBook acessando o WorkSheet específico de um arquivo Excel. O método 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.


Como acesso uma planilha específica?

Para acessar um WorkSheet específico de um arquivo Excel, o IronXL fornece a classe WorkBook. Ele pode ser usado de várias maneiras diferentes:

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

using IronXL;

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

O WorkBook["SheetName"] é o WorkSheet que é declarado na parte acima.

OU

WorkBook

OU

using IronXL;

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

OU

WorkBook.Load()

OU

using IronXL;

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

OU

sample.xlsx

OU

using IronXL;
using System.Linq;

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

OU

workBook

OU

using IronXL;
using System.Linq;

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

OU

workBook

OU

WorkBook.Load

OU

WorkSheet

OU

WorkSheet

OU

workBook

OU

WorkBook

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 planilha
  • WorkSheets[index]: Para iterar através das planilhas programaticamente
  • DefaultWorkSheet: Acesso rápido ao trabalhar com arquivos de uma única planilha
  • First() ou FirstOrDefault(): Opções seguras quando os nomes das planilhas podem mudar

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


Como acesso dados de uma Planilha?

Os dados podem ser acessados de ExcelSheet workSheet com este processo:

Quais tipos de dados posso ler das células?

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: For integers
  • DoubleValue: For decimals
  • DateTimeValue: For dates
  • 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);
}

Este 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:

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:

Saída do console mostrando dados extraídos da planilha com valores de Governo, Privado, Midmarket e Parceiros de Canal

Com o arquivo Excel Sample.xlsx:

Planilha do Excel com dados comerciais mostrando colunas de Segmento, País, Produto e Faixa de Desconto em 16 linhas

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.


Como posso executar funções em dados?

Acesse dados filtrados de um WorkSheet Excel aplicando funções agregadas como Sum, Min, ou Max usando o código a seguir:

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

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(): Calcule o valor médio
  • Count(): Conte células não vazias
  • CountIf(): Conte células que atendem aos critérios
  • Median(): Encontre o valor do meio
  • StdDev(): Calcule 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.

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:

Terminal mostrando resultados de análise de dados: Soma=482, Min=12, Max=350 em fundo preto

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

Planilha do Excel com dados de vendas mostrando segmentos, países, produtos, unidades vendidas e preços em várias linhas

Como leio a Planilha do Excel como DataTable?

Usando o IronXL, é fácil trabalhar com um WorkSheet Excel como um DataTable. Esse recurso é particularmente útil quando você precisa integrar dados do Excel com pipelines de processamento de dados existentes ou vincular dados a controles de interface do usuário.

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

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 de ExcelSheet como DataTable ColumnName:

using IronXL;
using System.Data;

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

O parâmetro Boolean 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?

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 do WorkSheet pode ser acessado e utilizado conforme necessário. Para operações DataTable mais avançadas, veja o guia sobre importar e exportar como DataSet.


Como Ler um Arquivo Excel como DataSet?

O IronXL fornece uma função simples para usar um arquivo Excel completo (WorkBook) como um DataSet. Use o método ToDataSet para transformar o workbook inteiro em DataSet.
Neste exemplo, veremos como usar o arquivo Excel como um DataSet.

Como converto um livro de trabalho em DataSet?

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:

Captura de tela corrompida ou incompleta mostrando apenas os rótulos Sheet1, Sheet2, Sheet3

E o arquivo Excel Sample.xlsx parece assim:

(center content omitted for brevity)

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

No exemplo acima, podemos facilmente analisar um arquivo Excel em um DataSet e trabalhar com cada DataTable de um arquivo 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 todos os ExcelSheets. Aqui, podemos acessar cada valor de célula de cada ExcelSheet de um arquivo Excel.

using IronXL;
using System;

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

// Iterate through every WorkSheet in the WorkBook
foreach (WorkSheet workSheet in workBook.WorkSheets)
{
    Console.WriteLine($"Worksheet: {workSheet.Name}");

    // Access each filled cell value on the current WorkSheet
    foreach (var cell in workSheet.FilledCells)
    {
        Console.WriteLine($"{cell.Address}: {cell.Text}");
    }
}
C#

Usando o exemplo acima, é conveniente acessar cada valor de célula de cada ExcelSheet de um arquivo Excel. Essa abordagem é particularmente útil quando se lida com workbooks de várias planilhas onde os dados estã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

WorkSheet

WorkSheet

WorkSheet

Perguntas frequentes

Como faço para ler arquivos XLSX em C#?

Para ler arquivos XLSX em C#, utilize o método WorkBook.Load do IronXL. Basta carregar o arquivo Excel com IronXL.WorkBook.Load("seu-arquivo.xlsx"), e então acessar as planilhas para ler os dados das células, realizar cálculos e converter para os formatos DataTable ou DataSet programaticamente.

Quais formatos de arquivo são suportados ao carregar arquivos do Excel?

O IronXL suporta vários formatos de arquivo do Excel, incluindo .xls, .xlsx, .xlsm, .xltx e .csv. O método WorkBook.Load detecta automaticamente o formato do arquivo, tornando-o versátil tanto para arquivos Excel antigos quanto para os modernos.

Como posso instalar a biblioteca de leitura do Excel no meu projeto C#?

Você pode instalar o IronXL por meio de download direto ou via NuGet Install para Visual Studio. O software é gratuito para fins de desenvolvimento e oferece uma maneira simples de trabalhar com formatos de arquivo Excel em C#.

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

O IronXL oferece várias maneiras de acessar planilhas: você pode usar workBook.GetWorkSheet("SheetName") para acessar pelo nome, workBook.WorkSheets[0] para acessar pelo índice ou workBook.WorkSheets.First() para obter a primeira planilha.

Posso realizar cálculos com os dados do Excel depois de carregá-los?

Sim, após carregar um arquivo XLSX com o IronXL, você pode aplicar diversas funções como Soma, Mínimo e Máximo aos dados. A biblioteca fornece acesso completo às funcionalidades do arquivo Excel por meio do objeto WorkBook.

É possível converter dados de uma planilha do Excel para outros formatos?

Sim, o IronXL permite ler uma planilha e convertê-la para vários formatos, incluindo DataTable, DataSet e outros. Isso facilita a integração de dados do Excel em seus aplicativos C#.

Can I convert an entire workbook to a DataSet with IronXL?

Yes, you can convert an entire workbook to a DataSet using the `ToDataSet` method, which allows you to work with each worksheet as a separate DataTable.

What is the recommended way to read multiple cells at once in IronXL?

You can read multiple cells by iterating over a specified range, for example, using `foreach` on `workSheet["A2:A10"]` to read each cell's value.

How do I install IronXL in my C# project?

You can install IronXL via direct download or through NuGet Package Manager in Visual Studio. The library is free for development purposes.

How can I display Excel sheet data results in the console using IronXL?

To display Excel sheet data in the console, load the workbook using `WorkBook.Load`, access the desired worksheet, and iterate through cells to output their values using `Console.WriteLine`.

Curtis Chau
Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...
Leia mais

Pronto para começar?

Nuget Downloads 2,237,574Versão:2026.9recém-lançado

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.9

PM > Install-Package IronXL.Excel
nuget.org/packages/IronXL.Excel/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronXL".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.9

  1. Baixe e descompacte o IronXL em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronXL.dll".

Licenças a partir de US$ 749

Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.