IRONSOFTWAREHOME
USANDO O IRONXL

Como ler um arquivo Excel em um aplicativo de console C#

Curtis Chau
Curtis Chau
Updated: 28 de junho de 2026

Trabalhar com arquivos Excel é uma tarefa comum no desenvolvimento de software, especialmente quando se trata de manipulação de dados e análise.

Ler arquivos Excel em uma aplicação de console C# é uma tarefa comum em muitos cenários de negócios e processamento de dados. Arquivos Excel, com sua estrutura de dados tabular, são frequentemente usados para armazenar e trocar informações.

Em aplicações C#, IronXL fornece uma solução poderosa e fácil de usar para manipular arquivos Excel. Este artigo o guiará pelo processo de leitura de arquivos Excel em uma Aplicação de Console C# usando a biblioteca IronXL.

Como Ler um Arquivo Excel em um Aplicativo de Console C#

  1. Crie uma Aplicação de Console C# no Visual Studio
  2. Instale a Biblioteca IronXL C# Excel
  3. Crie um Objeto da classe Workbook
  4. Carregue o arquivo Excel usando o método Workbook.Load
  5. Carregue a Planilha usando o método WorkSheets
  6. Leia os dados do Arquivo Excel usando o método WorkSheet.Row
  7. Percorra os valores da Celula
  8. Imprima o Cell.Text na Janela do Console

Introdução à Biblioteca IronXL

IronXL é uma biblioteca .NET projetada para simplificar tarefas relacionadas a Excel para desenvolvedores. Se você precisa criar, modificar ou ler arquivos Excel, IronXL oferece um conjunto abrangente de recursos e funcionalidades. IronXL simplifica o processo de interação com livros, planilhas e células do Excel.

Com IronXL, os desenvolvedores podem ler e escrever dados facilmente em arquivos Excel, permitindo uma integração perfeita da funcionalidade do Excel em projetos C# sem necessidade de Interop do Microsoft Office ou Excel instalado.

Ao aproveitar as capacidades do IronXL, os desenvolvedores podem manipular valores de célula, extrair dados de um Workbook do Excel e gerar documentos Excel dinamicamente. Com sua API intuitiva e conjunto de recursos robusto, o IronXL capacita os desenvolvedores a lidar eficientemente com dados do Excel, tornando tarefas como análise de dados, relatórios e geração de documentos mais fáceis.

Seja trabalhando com arquivos do Microsoft Excel, planilhas ou folhas de trabalho, IronXL fornece as ferramentas necessárias para agilizar o processo de desenvolvimento de aplicações C#.

Recursos do IronXL

Antes de avançar, vamos destacar alguns recursos chave do IronXL:

  1. Criar e Editar Arquivos Excel: O IronXL suporta a criação e modificação de arquivos Excel, permitindo que os desenvolvedores manipulem planilhas, células e formatação.
  2. Ler Arquivos Excel: A biblioteca facilita a extração de dados de arquivos Excel existentes, tornando fácil ler e processar dados de planilhas Excel dentro de aplicações .NET.
  3. Exportar para Excel: IronXL permite a exportação de dados de sua aplicação para um formato Excel, assegurando compatibilidade com outras ferramentas e plataformas.
  4. Fórmulas e Funções: Suporte para fórmulas e funções do Excel permite cálculos dinâmicos e manipulação de dados.
  5. Formatação de Células: IronXL fornece recursos para formatação de células, incluindo estilos, fontes, cores e bordas.

Criando Aplicação de Console usando o Visual Studio

Vamos começar criando uma nova Aplicação de Console C# no Visual Studio.

  1. Abra o Visual Studio.
  2. Selecione 'Criar um Novo Projeto'.

Como Ler um Arquivo Excel em uma Aplicação de Console C#: Figura 1

  1. Escolha 'App de Console' nos modelos C#.

Como Ler um Arquivo Excel em uma Aplicação de Console C#: Figura 2

  1. Forneça um nome para seu projeto e clique em 'Avançar'.

Como Ler um Arquivo Excel em uma Aplicação de Console C#: Figura 3

  1. Defina o .NET Framework apropriado e clique em 'Criar'.

Como Ler um Arquivo Excel em uma Aplicação de Console C#: Figura 4

Instalar IronXL usando o Console do Gerenciador de Pacotes NuGet ou Soluções

Agora que temos nossa aplicação de console, precisamos instalar a biblioteca IronXL.

Opção 1: Usando o Console do Gerenciador de Pacotes NuGet

PM > Install-Package IronXL.Excel

Opção 2: Usando o Gerenciador de Pacotes NuGet no Visual Studio

  1. Clique com o botão direito no seu projeto no Solution Explorer.
  2. Selecione 'Gerenciar Pacotes NuGet'.
  3. Procure por 'IronXL' e clique em 'Instalar'.

Como Ler um Arquivo Excel em uma Aplicação de Console C#: Figura 5

Passos para Ler Arquivos Excel usando IronXL

Agora, vamos passar pelos passos para ler um arquivo Excel usando IronXL em nossa Aplicação de Console C#. O seguinte trecho de código permite que você leia arquivos Excel na aplicação de console C#:

using IronXL;

class Program
{
    public static void Main()
    {
        // Specify the path to the Excel file
        string excelFilePath = "path/to/your/excel/file.xlsx";

        // Load the Excel file in a using block to automatically dispose resources
        using (WorkBook workBook = WorkBook.Load(excelFilePath))
        {
            // Access the first worksheet in the workbook
            WorkSheet workSheet = workBook.WorkSheets[0];

            // Iterate through each row in the worksheet
            foreach (var row in workSheet.Rows)
            {
                // Iterate through each cell in the row
                foreach (var cell in row)
                {
                    // Print the text of the cell followed by a tab
                    Console.Write(cell.Text + "\t");
                }
                // Move to the next line after each row
                Console.WriteLine();
            }
        } // WorkBook is automatically disposed here
    }
}

Este trecho de código C# demonstra como usar a biblioteca IronXL para ler dados de um arquivo Excel e exibi-los em uma aplicação de console. O seguinte arquivo Excel será lido e exibido na janela do console:

Como Ler um Arquivo Excel em uma Aplicação de Console C#: Figura 6

Agora, vamos dividir o código passo a passo:

Importando o Namespace IronXL

using IronXL;

Esta linha importa o namespace IronXL, que contém classes e métodos para trabalhar com qualquer documento Excel.

Método Principal

public static void Main() {
    // Main method where the program execution begins 
}

O método Main é o ponto de entrada da aplicação. Nós escreveremos o trecho de código acima neste método principal.

Caminho do Arquivo Excel

string excelFilePath = "path/to/your/excel/file.xlsx";

Esta linha especifica o caminho para o arquivo Excel que você deseja ler. Substitua "path/to/your/excel/file.xlsx" pelo caminho real para o seu arquivo Excel.

Carregar o Arquivo Excel

using (WorkBook workBook = WorkBook.Load(excelFilePath))

O método WorkBook.Load() é usado para carregar o arquivo Excel especificado por excelFilePath em um objeto WorkBook (Excel) chamado workBook. Envolvê-lo em um bloco using garante que a planilha seja corretamente descartada quando não for mais necessária, já que WorkBook implementa IDisposable.

Acessando a Planilha

WorkSheet workSheet = workBook.WorkSheets[0];

Esta linha acessa a primeira planilha Excel no livro (workBook.WorkSheets [0]) e a atribui a um objeto Excel WorkSheet chamado workSheet.

Iterando pelas Linhas e Colunas

foreach (var row in workSheet.Rows)
{
    foreach (var cell in row)
    {
        Console.Write(cell.Text + "\t");
    }
    Console.WriteLine();
}

Esses loops foreach aninhados iteram por cada linha e coluna na planilha. Para cada célula, o valor de texto da célula (cell.Text) é impresso no console, seguido por um caracter de tabulação (" "). Após imprimir todas as células em uma linha, um caracter de nova linha é impresso para mover para a próxima linha.

Descartando o caderno de exercícios

using (WorkBook workBook = WorkBook.Load(excelFilePath))
{
    // Work with the workbook here
} // WorkBook is automatically disposed here

Como WorkBook implementa IDisposable, o bloco using descarta automaticamente a planilha e libera todos os recursos associados quando a execução sai do bloco.

Para mais exemplos de código funcionais, por favor visite esta página de exemplos de código.

Saída

Ao executar a aplicação, os dados do arquivo Excel serão impressos na janela do console:

Como Ler um Arquivo Excel em uma Aplicação de Console C#: Figura 7

Conclusão

Neste tutorial, exploramos o processo de leitura de arquivos Excel em uma Aplicação Console C# usando a biblioteca IronXL. Com seus recursos intuitivos, o IronXL simplifica as tarefas relacionadas ao Excel, tornando-se uma ferramenta valiosa para desenvolvedores .NET que trabalham em aplicações centradas em dados.

Sinta-se à vontade para explorar funcionalidades adicionais fornecidas pelo IronXL para manipulações avançadas do Excel em seus projetos C# visitando esta página de documentação.

O IronXL oferece uma avaliação gratuita para testar toda a sua funcionalidade antes de tomar uma decisão informada. Para uso comercial, você precisa comprar uma chave de licença a partir de $999.

Para mais informações sobre pacotes de licença, por favor visite esta página de licenciamento. Baixe a biblioteca aqui e experimente.

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.