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'.

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

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

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

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

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'.

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

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

Imports IronXL

Module Program
    Public Sub Main()
        ' Specify the path to the Excel file
        Dim excelFilePath As String = "path/to/your/excel/file.xlsx"

        ' Load the Excel file in a using block to automatically dispose resources
        Using workBook As WorkBook = WorkBook.Load(excelFilePath)
            ' Access the first worksheet in the workbook
            Dim workSheet As WorkSheet = workBook.WorkSheets(0)

            ' Iterate through each row in the worksheet
            For Each row In workSheet.Rows
                ' Iterate through each cell in the row
                For Each cell In row
                    ' Print the text of the cell followed by a tab
                    Console.Write(cell.Text & vbTab)
                Next
                ' Move to the next line after each row
                Console.WriteLine()
            Next
        End Using ' WorkBook is automatically disposed here
    End Sub
End Module

Imports IronXL

Module Program
    Public Sub Main()
        ' Specify the path to the Excel file
        Dim excelFilePath As String = "path/to/your/excel/file.xlsx"

        ' Load the Excel file in a using block to automatically dispose resources
        Using workBook As WorkBook = WorkBook.Load(excelFilePath)
            ' Access the first worksheet in the workbook
            Dim workSheet As WorkSheet = workBook.WorkSheets(0)

            ' Iterate through each row in the worksheet
            For Each row In workSheet.Rows
                ' Iterate through each cell in the row
                For Each cell In row
                    ' Print the text of the cell followed by a tab
                    Console.Write(cell.Text & vbTab)
                Next
                ' Move to the next line after each row
                Console.WriteLine()
            Next
        End Using ' WorkBook is automatically disposed here
    End Sub
End Module

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:

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

Importando o Namespace IronXL

using IronXL;

using IronXL;

Imports IronXL

Imports 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 
}

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

Public Shared Sub Main()
	' Main method where the program execution begins 
End Sub

Public Shared Sub Main()
	' Main method where the program execution begins 
End Sub

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";

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

Dim excelFilePath As String = "path/to/your/excel/file.xlsx"

Dim excelFilePath As String = "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))

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

net

net

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];

WorkSheet workSheet = workBook.WorkSheets[0];

Dim workSheet As WorkSheet = workBook.WorkSheets(0)

Dim workSheet As 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();
}

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

Imports Microsoft.VisualBasic

For Each row In workSheet.Rows
	For Each cell In row
		Console.Write(cell.Text & vbTab)
	Next cell
	Console.WriteLine()
Next row

Imports Microsoft.VisualBasic

For Each row In workSheet.Rows
	For Each cell In row
		Console.Write(cell.Text & vbTab)
	Next cell
	Console.WriteLine()
Next row

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

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

Imports System

Using workBook As WorkBook = WorkBook.Load(excelFilePath)
    ' Work with the workbook here
End Using ' WorkBook is automatically disposed here

Imports System

Using workBook As WorkBook = WorkBook.Load(excelFilePath)
    ' Work with the workbook here
End Using ' 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:

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.