IRONSOFTWAREHOME
USANDO O IRONXL

Como ler um arquivo CSV em C#

Curtis Chau
Curtis Chau
Updated: 21 de abril de 2026

Este artigo explorará como criar um Leitor de CSV em C# usando a biblioteca IronXL.

IronXL - Biblioteca Excel

IronXL é uma poderosa biblioteca Excel que fornece aos desenvolvedores C# a capacidade de criar, carregar, ler e editar planilhas Excel em vários formatos. Projetado especificamente para .NET, o IronXL prioriza velocidade, precisão e facilidade de uso. Permite salvar arquivos Excel em diferentes formatos e carregar diversos formatos de planilhas no Excel para leitura eficiente de dados.

IronXL suporta formatos de pastas de trabalho Excel com diferentes extensões de arquivos, incluindo CSV e TSV, XLS e XLSX, XSLT e XLSM. É compatível com a versão mais recente do .NET Framework, bem como todas as versões anteriores até 2.0. O IronXL pode ser usado em várias plataformas, incluindo Linux, MacOS, Azure, Docker e AWS.

Como fazer um Leitor de CSV em C# usando IronXL?

Pré-requisitos

Para converter dados de um arquivo CSV para um arquivo Excel e lê-lo em C#, precisamos das seguintes ferramentas:

  1. Visual Studio: é um Ambiente de Desenvolvimento Integrado (IDE) essencial para trabalhar em aplicações C# .NET. É o IDE oficial e recomendado para desenvolver aplicativos C#, e pode ser baixado e instalado a partir do site da Microsoft. No entanto, outros IDEs que suportam um ambiente C# também podem ser usados, se preferido pelo desenvolvedor.
  2. Criar App de Console: Siga os passos para criar uma Aplicação de Console simples.
    • Abra o Visual Studio e clique em 'Criar um Projeto'.

      Como Ler um Arquivo CSV em C#, Figura 2: Janela do Novo Projeto Janela de Novo Projeto

    • Escolha 'App de Console' na lista de opções disponíveis. Certifique-se de que o idioma selecionado seja C#.

      Como Ler um Arquivo CSV em C#, Figura 3: Criar um novo Aplicativo Console Criar um novo App de Console

    • Em seguida, dê o nome que quiser ao seu projeto.

      Como Ler um Arquivo CSV em C#, Figura 4: Configuração Configuração

    • O próximo passo na configuração do projeto é selecionar o .NET Framework. A versão mais recente disponível é .NET 7.0, que é suportada no termo padrão. No entanto, para evitar qualquer erro potencial, você pode optar pela versão mais estável do .NET 6.0, já que a Microsoft fornece suporte de longo prazo para ela. É importante escolher a versão adequada com base em seus requisitos específicos.

  3. IronXL - É a biblioteca Excel .NET que foi projetada para trabalhar com planilhas Excel. Deve ser instalada em sua aplicação C# antes de usá-la. Você pode baixar e instalar o pacote de várias fontes:
    1. NuGet - o gerenciador de pacotes para .NET. Você pode baixar diretamente o IronXL do site do NuGet.
    2. Gerenciador de Pacotes NuGet do Visual Studio: Abra o Gerenciador de Pacotes indo para Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes para Solução...
    3. _Baixar o arquivo zip .NET Excel DLL diretamente do site do Iron e adicioná-lo à Solução do Projeto como referência de projeto.

Adicionar Namespace IronXL

Depois de ter os pré-requisitos, o próximo passo é adicionar o namespace IronXL no topo do código fonte no arquivo main.cs:

using IronXL;

Abrir um Arquivo CSV Existente

O IronXL oferece uma maneira fácil de ler arquivos CSV em C#. Primeiro, abra um arquivo CSV para leitura. É um tipo de arquivo baseado em linhas e colunas. Aqui, a classe WorkBook é usada junto com seu método LoadCSV para abrir um arquivo CSV. O código é o seguinte:

// Load the CSV file and convert it to XLSX format.
var csv = WorkBook.LoadCSV("color_srgb.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");

O método LoadCSV em IronXL permite que você abra um arquivo CSV e o converta para o formato XLSX. Este método fornece opções para especificar o delimitador de lista usado no arquivo CSV. Neste exemplo, o delimitador padrão, que é uma vírgula, é usado. O arquivo resultante é aberto e pode ser processado ainda mais usando os recursos do IronXL para ler e manipular planilhas do Excel.

Como Ler um Arquivo CSV em C#, Figura 5: Arquivo CSV Arquivo CSV

Obter Planilha da Classe de Leitura de CSV

Na etapa anterior, o arquivo CSV foi aberto como uma pasta de trabalho do Excel usando o IronXL. Agora, obtenha a planilha padrão da pasta de trabalho usando a classe WorkSheet. O exemplo a seguir demonstra como obter a planilha para ler dados CSV:

// Retrieve the default worksheet from the loaded workbook.
WorkSheet ws = csv.DefaultWorkSheet;

Para mais informações sobre como trabalhar com planilhas do Excel, você pode visitar esta página de exemplos de código.

Ler Dados CSV usando DataTable em C#

Uma vez que o CSV é carregado com sucesso e os dados estão disponíveis como uma planilha, os dados podem ser lidos do arquivo CSV muito facilmente em um C# DataTable.

Converter Planilha para DataTable

Primeiro, crie uma instância DataTable e converta os dados da planilha em uma tabela usando o método ToDataTable. O código a seguir ajuda a realizar essa tarefa:

// Convert the worksheet data to a DataTable.
DataTable dt = ws.ToDataTable(true);

Iniciar Leitura de Dados CSV

Agora, itere por todos os registros usando a instância DataTable. Os dados são recebidos em linhas e colunas. Primeiro, percorra cada coluna para obter seu valor. Para obter todos os registros juntamente com a linha de cabeçalho, use o seguinte trecho de código:

// Iterate over each row in the DataTable.
foreach (DataRow row in dt.Rows)
{
    // Iterate over each column in the current row.
    for (int i = 0; i < dt.Columns.Count; i++)
    {
        // Print each column value in the current row.
        Console.Write(row[i] + "  ");
    }
    // Move to the next line after printing all columns of the current row.
    Console.WriteLine();
}

No código acima, um loop foreach é usado para obter um único registro de uma coleção de linhas. Em seguida, dentro de um loop for aninhado, o número de colunas é contado e finalmente, os dados de cada linha são impressos na tela. A saída é formatada de forma semelhante a um arquivo CSV.

Como Ler um Arquivo CSV em C#, Figura 6: Saída Saída

Resumo

Este artigo demonstrou como criar um leitor de CSV em C# usando a biblioteca IronXL. Carregar arquivos CSV é facilitado com o IronXL, pois ele suporta o formato CSV em planilhas do Excel. O objeto DataTable é usado para criar um leitor CSV elegante e formatar a saída para corresponder ao arquivo original.

O IronXL também oferece conversão entre diferentes formatos de arquivo e permite criar arquivos do Excel do zero sem a necessidade de Interop e do Microsoft Excel instalados. Ele também é compatível com C# DataSet e DataTable, proporcionando flexibilidade aos desenvolvedores na interconversão de dados sem depender de aplicativos de terceiros. Com seus recursos poderosos, o IronXL é uma ferramenta valiosa para desenvolvedores C# trabalharem com planilhas do Excel e manipularem dados CSV de forma eficiente.

O IronXL é gratuito para desenvolvimento. No entanto, para uso comercial, você precisa adquirir sua licença a partir de $999. Você também pode usar sua versão de teste gratuita para testar a compatibilidade do .dll compilado com seu projeto em modo de produção.

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.