IRONSOFTWAREHOME
USANDO O IRONXL

Como obter dados de uma planilha do Excel em C#

Curtis Chau
Curtis Chau
Updated: 8 de maio de 2026

IronXL é uma API rica em recursos que oferece várias funcionalidades para trabalhar com arquivos Excel em C#. Este tutorial explorará como buscar dados de planilhas Excel em C# usando IronXL.

Para seguir este tutorial, você precisa ter o seguinte:

  • Microsoft Visual Studio instalado em sua máquina
  • Conhecimento básico de programação em C#
  • Biblioteca IronXL instalada em seu projeto

Você pode baixar IronXL do site oficial ou através do Gerenciador de Pacotes NuGet no Visual Studio.

Instalando IronXL no Visual Studio

Para instalar IronXL em um projeto C#, siga estas etapas:

  1. Abra o Microsoft Visual Studio.
  2. Crie um novo projeto ou abra um projeto existente.
  3. Clique com o botão direito no projeto no Solution Explorer e selecione 'Gerenciar Pacotes NuGet'.
  4. Na janela 'Gerenciador de Pacotes NuGet', selecione a guia 'Procurar'.
  5. Na caixa de pesquisa, digite 'IronXL' e pressione Enter.
  6. Selecione 'IronXL.Excel' e clique no botão 'Instalar'.
  7. Clique no botão 'Aceito' para aceitar o contrato de licença.
  8. Aguarde a conclusão da instalação.

Como Buscar Dados de uma Planilha Excel em C#, Figura 1: Instalando a biblioteca IronXL no projeto do Visual Studio Instalando a biblioteca IronXL no projeto do Visual Studio

Depois de realizar estas etapas, o IronXL deverá estar instalado e pronto para uso em seu projeto C#.

Passo 1: Importar as Bibliotecas Necessárias

Adicione o seguinte código de exemplo para importar a biblioteca IronXL e outras bibliotecas necessárias.

using IronXL;
using System;
using System.Data;
using System.Data.OleDb;
using System.Windows.Forms;

Usar o namespace IronXL fornece todas as classes e funções necessárias para trabalhar com arquivos Excel usando a biblioteca IronXL.

Passo 2: Carregar o Arquivo Excel

O primeiro passo é carregar o arquivo. IronXL fornece uma WorkBook classe para carregar um arquivo Excel. Podemos usar a classe WorkBook para abrir um arquivo Excel existente ou criar uma nova pasta de trabalho.

Para carregar um arquivo Excel existente, use o seguinte código:

WorkBook workbook = WorkBook.Load("path/to/excel/file.xlsx");

Este código carrega o arquivo Excel especificado em um objeto WorkBook.

Para criar um novo WorkBook, use o seguinte código de exemplo:

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);

Este código cria uma nova pasta de trabalho no formato de arquivo especificado (aqui, XLSX).

Como Buscar Dados de uma Planilha Excel em C#, Figura 3: IronXL pode carregar e criar Planilhas Excel nos formatos de arquivo .XLS e .XLSX IronXL pode carregar e criar Planilhas Excel nos formatos de arquivo .XLS e .XLSX

Passo 3: Recuperar a Planilha Excel

Após carregar o arquivo Excel, é necessário indicar a planilha Excel da qual buscar dados. Um WorkBook pode conter múltiplos objetos WorkSheet. Cada WorkSheet precisa especificar o nome da planilha antes de acessar os dados.

WorkSheet worksheet = workbook.WorkSheets["Sheet1"];

Este código recupera a primeira planilha (com o nome da planilha Sheet1) da pasta de trabalho. Se você quiser recuperar uma planilha pelo índice, pode usar o seguinte código:

WorkSheet worksheet = workbook.WorkSheets[0];

Este código recupera a primeira planilha da pasta de trabalho, assumindo que ela exista.

Passo 4: Recuperar Dados da Planilha Excel

Da planilha Excel recuperada, torna-se possível acessar os dados. IronXL fornece vários métodos para recuperar dados de uma planilha Excel. Aqui estão alguns dos métodos mais comumente usados:

  • Operador de indexação []: Recupera o valor de uma única célula.
  • GetRow: Retrieves a single row of data.
  • GetColumn: Retrieves a single column of data.
  • GetRange: Retrieves a range of cells.

Para recuperar o valor de uma única célula, use o seguinte código:

object value = worksheet["A1"].Value;

Este código recupera o valor da célula A1 na planilha.

Para recuperar uma única linha de dados, use o seguinte código:

var dataRow = worksheet.GetRow(1);

Este código recupera a primeira linha de dados na planilha.

Para recuperar uma única coluna de dados, use o seguinte código:

var dataColumn = worksheet.GetColumn(1);

Este código recupera a primeira coluna de dados na planilha.

Para recuperar um intervalo de células, use o seguinte código:

var cellRange = worksheet.GetRange("A1:B2");

Este código recupera o intervalo de células de A1 a B2 na planilha.

Passo 5: Extrair Dados da Planilha Excel

Para extrair um único valor dos dados recuperados, ele precisa ser convertido para o tipo de dado apropriado.

O código a seguir mostra como extrair um valor inteiro da célula A1:

int value = worksheet["A1"].IntValue;

O seguinte código pode ser usado para extrair uma linha de dados:

var dataRow = worksheet.GetRow(1);
var values = dataRow.Values;

foreach (var value in values)
{
    int intValue = (int)value;
    // Do something with the extracted value
}

Este código extrai a primeira linha de dados e itera pelos valores na linha, convertendo cada valor para um inteiro.

Em seguida, o seguinte código mostra como extrair uma coluna de dados:

var dataColumn = worksheet.GetColumn(1);
var values = dataColumn.Values;

foreach (var value in values)
{
    string strValue = (string)value;
    // Do something with the extracted value
}

Este código extrai a primeira coluna de dados e itera sobre os valores na coluna, convertendo cada valor em uma string.

O próximo exemplo demonstra como extrair um intervalo de células:

var cellRange = worksheet.GetRange("A1:B2");
var values = cellRange.Values;

foreach (var row in values)
{
    foreach (var value in row)
    {
        // Do something with the extracted value
    }
}

Este código extrai o intervalo de células de A1 a B2 e itera pelos valores em cada célula.

Conclusão

Este tutorial explorou como buscar dados de planilhas do Excel em C# usando IronXL, bem como carregar um arquivo Excel, recuperar a planilha necessária, recuperar dados da planilha, extrair dados e importar dados para um banco de dados. IronXL fornece uma API rica em recursos para trabalhar com arquivos Excel, tornando fácil integrar dados Excel em aplicações C#. Com IronXL, podemos ler e escrever arquivos Excel e interagir com seus dados programaticamente. Além disso, podemos usar o IronXL para automatizar tarefas do Excel, como gerar relatórios, criar gráficos e formatar células.

Mais sobre IronXL

IronXL é uma biblioteca amigável e conveniente para leitura e escrita em arquivos Excel & CSV, com funções pequenas e facilmente memorizáveis.

Este tutorial apenas arranhou a superfície do que IronXL pode fazer. IronXL fornece uma ampla gama de recursos adicionais, como formatação de células, funções matemáticas e formatação condicional para citar alguns.

Benefícios Notáveis do Uso do IronXL

  • Suporte dedicado de engenheiros .NET, suporte multiplataforma, Azure, AWS e Docker.
  • Instalação simples via Microsoft Visual Studio
  • Teste gratuito para desenvolvimento, com licenças a partir de $999
  • Integração fácil em projetos C# ou VB.NET
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

Artigos relacionados

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.