1. IronXL
  2. Tutoriais
  3. Planilha aberta do Excel em C#

Como Abrir e Ler Arquivo Excel em C# com IronXL

Curtis Chau
Curtis Chau
Atualizado:
This article was translated from English: Does it need improvement?
Translated
View the article in English

Abra e leia arquivo Excel em C# usando os métodos WorkBook.Load() e GetWorkSheet() do IronXL para acessar qualquer tipo de arquivo Excel (.xls, .csv, .tsv, .xlsx) e ler ou manipular dados com apenas duas linhas de código.

Aprenda a usar C# para ler arquivo Excel e trabalhar com planilhas de todos os tipos, incluindo .xls, .csv, .tsv, e .xlsx. Abrir uma planilha do Excel, ler seus dados e editá-los programaticamente são operações essenciais para muitas aplicações empresariais. O IronXL fornece uma abordagem simplificada que elimina a necessidade de Interop do Excel, oferecendo uma solução com menos linhas de código e tempos de resposta mais rápidos.

Início Rápido: Carregue um Workbook e Abra uma Planilha em Uma Linha

Apenas duas chamadas de método simples permitem que você carregue qualquer arquivo Excel suportado e abra uma planilha nomeada—sem necessidade de configuração complexa ou interop. O IronXL torna simples começar a ler ou editar dados imediatamente.

  1. Instale IronXL com o Gerenciador de Pacotes NuGet

    PM > Install-Package IronXL.Excel

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

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

  3. Implante para testar em seu ambiente de produção.

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

    arrow pointer
### Fluxo de trabalho mínimo (5 etapas)

Para abrir e trabalhar com uma planilha do Excel, siga estas etapas:

IronXL C# tutorial: 5 steps to open Excel worksheets - install library, load workbook, select worksheet, access data
  1. Instale a biblioteca C# para abrir arquivos Excel
  2. Carregue o arquivo Excel em um objeto `WorkBook` usando `WorkBook.Load()`
  3. Selecione uma `WorkSheet` usando métodos de acesso múltiplos
  4. Acesse dados de células através do objeto `WorkSheet` selecionado
  5. Obter dados de intervalos de linhas e colunas


Como Acesso a Biblioteca Excel C#?

Acesse a Biblioteca Excel C# via DLL ou instale-a usando seu gerenciador NuGet preferido. Uma vez que você acessou a biblioteca IronXL e a adicionou ao seu projeto, você pode usar todas as funções abaixo para abrir planilhas do Excel em C#. Para instruções detalhadas de instalação e requisitos de sistema, consulte a documentação do IronXL.

Install-Package IronXL.Excel

O IronXL suporta a implantação em múltiplas plataformas, incluindo Linux, macOS e containers Docker, tornando-o versátil para vários ambientes de desenvolvimento.

Como Carrego um Arquivo Excel?

Use a função WorkBook.Load() do IronXL para carregar arquivos Excel no projeto. Esta função requer um parâmetro de string, que é o caminho do arquivo Excel a ser aberto. O IronXL suporta o carregamento de vários formatos de planilha, incluindo XLS, XLSX, CSV, TSV e mais. Para orientação abrangente sobre como carregar diferentes tipos de arquivos, veja o tutorial de carregamento de planilhas.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-load-workbook.cs
using IronXL;

// Get a worksheet by its name
WorkSheet workSheet = workBook.GetWorkSheet("SheetName");
Imports IronXL

' Get a worksheet by its name
Dim workSheet As WorkSheet = workBook.GetWorkSheet("SheetName")
$vbLabelText   $csharpLabel

O arquivo Excel no caminho especificado será carregado no objeto workBook. Agora, especifique a planilha do Excel a ser aberta. O parâmetro WorkBookLoadOptions permite que você manipule workbooks protegidos por senha e controle o comportamento de recálculo de fórmulas.

Como Abro uma Planilha do Excel?

Para abrir um WorkSheet específico de um arquivo Excel, o IronXL fornece a função WorkBook.GetWorkSheet(). Use-a para abrir a planilha pelo nome:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-get-worksheet.cs
// Get a worksheet by its name
WorkSheet workSheet = workBook.GetWorkSheet("SheetName");
' Get a worksheet by its name
Dim workSheet As WorkSheet = workBook.GetWorkSheet("SheetName")
$vbLabelText   $csharpLabel

O WorkSheet especificado abrirá em workSheet com todos os seus dados. Existem várias outras maneiras de abrir um WorkSheet específico de um arquivo Excel:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-multiple-open.cs
using IronXL;
using System.Linq;

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

// Open the default worksheet
WorkSheet workSheet2 = workBook.DefaultWorkSheet;

// Open the first sheet
WorkSheet workSheet3 = workBook.WorkSheets.First();

// Open the first or default sheet
WorkSheet workSheet4 = workBook.WorkSheets.FirstOrDefault();
Imports IronXL
Imports System.Linq

' Open by sheet index
Private workSheet As WorkSheet = workBook.WorkSheets(0)

' Open the default worksheet
Private workSheet2 As WorkSheet = workBook.DefaultWorkSheet

' Open the first sheet
Private workSheet3 As WorkSheet = workBook.WorkSheets.First()

' Open the first or default sheet
Private workSheet4 As WorkSheet = workBook.WorkSheets.FirstOrDefault()
$vbLabelText   $csharpLabel

Para tarefas mais avançadas de gerenciamento de planilhas, como adicionar, renomear ou excluir planilhas, consulte o guia de gerenciamento de planilhas.

Agora, obtenha dados do Excel WorkSheet aberto.

Como Obtenho Dados de uma Planilha?

Obtenha dados de um Excel WorkSheet aberto das seguintes maneiras:

  1. Obtenha um valor de célula específico do Excel WorkSheet.
  2. Obtenha dados em um Range específico.
  3. Obtenha todos os dados de WorkSheet.
  4. Exporte dados para outros formatos.

Vamos examinar como obter dados de diferentes maneiras com estes exemplos:

Como Obtenho Valores de Células Específicas?

A primeira abordagem para obter dados de um Excel WorkSheet é obter valores de células específicos. Acesse-os assim:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-cell-address.cs
// Access a specific cell value by its address
string val = workSheet["Cell Address"].ToString();
' Access a specific cell value by its address
Dim val As String = workSheet("Cell Address").ToString()
$vbLabelText   $csharpLabel

workSheet é o WorkSheet do arquivo Excel, conforme mostrado nos exemplos a seguir. Valores de células específicas também podem ser acessados especificando o índice de linha e o índice de coluna.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-cell-row.cs
// Access a cell value by row index and column index
string val = workSheet.Rows[RowIndex].Columns[ColumnIndex].Value.ToString();
' Access a cell value by row index and column index
Dim val As String = workSheet.Rows(RowIndex).Columns(ColumnIndex).Value.ToString()
$vbLabelText   $csharpLabel

Aqui está um exemplo de como abrir um arquivo Excel no seu projeto C# e obter valores de células específicas usando ambos os métodos:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-specified-cell.cs
using IronXL;
using System;

WorkBook workBook = WorkBook.Load("sample.xlsx");

// Open WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Get value By Cell Address
int intValue = workSheet["C6"].Int32Value;

// Get value by Row and Column Address
string strValue = workSheet.Rows[3].Columns[1].Value.ToString();

Console.WriteLine("Getting Value by Cell Address: {0}", intValue);
Console.WriteLine("Getting Value by Row and Column Indexes: {0}", strValue);
Imports IronXL
Imports System

Private workBook As WorkBook = WorkBook.Load("sample.xlsx")

' Open WorkSheet
Private workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Get value By Cell Address
Private intValue As Integer = workSheet("C6").Int32Value

' Get value by Row and Column Address
Private strValue As String = workSheet.Rows(3).Columns(1).Value.ToString()

Console.WriteLine("Getting Value by Cell Address: {0}", intValue)
Console.WriteLine("Getting Value by Row and Column Indexes: {0}", strValue)
$vbLabelText   $csharpLabel

Este código exibe a seguinte saída:

Console mostrando a recuperação de dados da planilha: endereço da célula retorna 'Canadá', índices de linha/coluna retornam '90540'

Valor do arquivo Excel sample.xlsx em row [3].Column [1] e célula C6:

Planilha Excel com tabela de dados empresariais mostrando segmentos, países e valores com células destacadas

Os índices de linhas e colunas começam em 0.

Abra WorkSheets do Excel e obtenha dados de células específicas, e você pode ler mais sobre como ler dados do Excel em C# de planilhas já abertas. Para mais exemplos de como ler arquivos do Excel, confira o tutorial de como ler arquivos Excel.

Como obtenho dados de um intervalo específico?

Agora examine como obter dados em um intervalo específico de um Excel WorkSheet aberto usando o IronXL. A funcionalidade de seleção de intervalo oferece opções poderosas para extração de dados.

O IronXL fornece uma maneira inteligente de obter dados em um intervalo específico. Especifique from para to valores:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-select-range.cs
// Access data from a specific range
var rangeData = workSheet["From Cell Address : To Cell Address"];
' Access data from a specific range
Dim rangeData = workSheet("From Cell Address : To Cell Address")
$vbLabelText   $csharpLabel

Aqui está um exemplo de uso de intervalo para obter dados de um Excel WorkSheet aberto:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-from-range.cs
using IronXL;
using System;

// Load 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);
}
Imports IronXL
Imports System

' Load Excel file
Dim workBook As WorkBook = WorkBook.Load("sample.xlsx")
Dim workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Specify the range
For Each cell In workSheet("B2:B10")
    Console.WriteLine("Value is: {0}", cell.Text)
Next
$vbLabelText   $csharpLabel

O código acima puxará dados de B2 para B10 da seguinte forma:

Saída do console mostrando valores de países extraídos da planilha, incluindo Canadá, Alemanha, México, França, Estados Unidos

Os valores do arquivo Excel sample.xlsx, de B2 a B10:

Planilha Excel com dados de países na coluna B destacados, mostrando segmentos de negócios e valores correspondentes

Como obtenho dados de uma linha?

Você também pode descrever um intervalo para uma linha específica. Por exemplo:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-select-row-range.cs
var rowData = workSheet["A1:E1"];
Dim rowData = workSheet("A1:E1")
$vbLabelText   $csharpLabel

Isso exibirá todos os valores de A1 a E1. Leia mais sobre C# Intervalos do Excel e como trabalhar com diferentes identificações de linhas e colunas.

Como obtenho todos os dados de uma planilha?

Obter todos os dados de células do Excel WorkSheet aberto é fácil usando o IronXL. Para esta tarefa, acesse cada valor de célula por índices de linha e coluna. Você também pode exportar a planilha inteira para vários formatos, como CSV, JSON ou XML para facilitar o processamento. Veja o exemplo a seguir, que percorre todas as células WorkSheet e acessa seus valores.

Neste exemplo, dois loops trabalham juntos: um percorre cada linha do Excel WorkSheet e o outro percorre cada coluna de uma linha específica. Dessa forma, cada valor de célula é facilmente acessado.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-open-excel-worksheet-all.cs
using IronXL;
using System;
using System.Linq;

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

// Access all rows of the open Excel WorkSheet
for (int i = 0; i < workSheet.Rows.Count(); i++)
{
    // Access all columns of a specific row
    for (int j = 0; j < workSheet.Columns.Count(); j++)
    {
        // Access each cell for the specified column
        Console.WriteLine(workSheet.Rows[i].Columns[j].Value.ToString());
    }
}
Imports IronXL
Imports System
Imports System.Linq

' Load Excel file
Private workBook As WorkBook = WorkBook.Load("sample2.xlsx")
Private workSheet As WorkSheet = workBook.GetWorkSheet("Sheet1")

' Access all rows of the open Excel WorkSheet
For i As Integer = 0 To workSheet.Rows.Count() - 1
	' Access all columns of a specific row
	For j As Integer = 0 To workSheet.Columns.Count() - 1
		' Access each cell for the specified column
		Console.WriteLine(workSheet.Rows(i).Columns(j).Value.ToString())
	Next j
Next i
$vbLabelText   $csharpLabel

A saída do código acima exibirá cada valor de célula do Excel WorkSheet completo aberto. Para trabalhar com conjuntos de dados maiores, considere usar a funcionalidade de exportação DataSet e DataTable do IronXL para melhor desempenho e gerenciamento de memória.

Perguntas frequentes

Como faço para abrir uma planilha do Excel em C# sem o Microsoft Office instalado?

IronXL oferece uma solução simples usando os métodos WorkBook.Load() e GetWorkSheet(). Com apenas duas linhas de código, você pode abrir qualquer arquivo do Excel (.xls, .xlsx, .csv, .tsv) sem precisar instalar o Excel Interop ou o Microsoft Office no seu sistema.

Quais formatos de arquivo são suportados ao abrir planilhas do Excel?

O IronXL suporta vários formatos de planilha, incluindo .xls (formato antigo do Excel), .xlsx (formato moderno do Excel), .csv (valores separados por vírgula) e .tsv (valores separados por tabulação). A função WorkBook.Load() lida automaticamente com todos esses formatos de forma integrada.

Posso implantar meu aplicativo de planilha do Excel no Linux ou no macOS?

Sim, o IronXL suporta implantação multiplataforma, incluindo Linux, macOS e contêineres Docker. Isso o torna versátil para diversos ambientes de desenvolvimento além do Windows, eliminando limitações específicas de plataforma.

Como faço para instalar a biblioteca Excel C# no meu projeto?

Você pode acessar o IronXL baixando um arquivo DLL ou instalando-o via gerenciador de pacotes NuGet. A biblioteca fornece documentação completa com instruções detalhadas de instalação e requisitos de sistema para que você possa começar rapidamente.

Qual é o código básico para carregar um arquivo do Excel e acessar uma planilha específica?

Basta usar duas linhas: WorkBook wb = WorkBook.Load("sample.xlsx"); WorkSheet ws = wb.GetWorkSheet("Sheet1"); Isso carrega seu arquivo Excel e abre a planilha especificada para acesso e manipulação imediatos dos dados.

Curtis Chau
Curtis Chau
  Converse agora mesmo com a equipe de engenharia.
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 ...

Leia mais
Pronto para começar?
Nuget Downloads 1,974,422 | Versão: 2026.4 acaba de ser lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronXL.Excel
executar um exemplo Veja seus dados se transformarem em uma planilha.