Como ler um arquivo CSV em um DataTable em C#

Por que a Conversão de CSV para DataTable é Importante?

A conversão de CSV para DataTable permite que os desenvolvedores transformem valores separados por vírgulas em objetos estruturados para processamento posterior. Quer você esteja lidando com dados de inventário, registros de clientes ou logs de transações, converter CSV para um DataTable de forma eficiente é crucial. Usar a primeira linha como cabeçalhos de coluna garante que as colunas do DataTable se alinhem com o esquema da tabela do banco de dados, tornando-o perfeito para operações de Excel para SQL.

Abordagens tradicionais muitas vezes têm dificuldades com arquivos grandes, diferentes delimitadores ou gerenciamento de memória. IronXL elimina esses desafios e lida com diferentes delimitadores, campos entre aspas e vírgulas embutidas sem código extra. As capacidades de leitura de CSV do IronXL eliminam pontos problemáticos comuns enquanto fornecem recursos adicionais como validação de dados e controle de tamanho de arquivos.

Como Instalar o IronXL?

Começar a usar o IronXL requer uma instalação simples do pacote NuGet. Abra o Console do Gerenciador de Pacotes NuGet no Visual Studio e execute um dos seguintes comandos:

Install-Package IronXL

Install-Package IronXL

Ou, se você preferir a CLI do .NET:

dotnet add package IronXL

dotnet add package IronXL

Uma vez instalado, adicione o namespace IronXL ao seu projeto:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

Isso fornece acesso a todas as funcionalidades de processamento de CSV sem qualquer dependência de Excel. Para mais detalhes, consulte a documentação do IronXL e o guia de instalação do NuGet.

Como Verificar se a Instalação Foi Bem-sucedida?

Crie um programa de teste que carregue um arquivo CSV para verificar a instalação. Se você encontrar mensagens de licenciamento, será necessário obter uma chave de licença. Verifique as referências de pacote no arquivo do seu projeto para garantir que o IronXL apareça com a versão correta. Execute uma operação básica de leitura de CSV -- se for concluída sem erros, sua instalação está funcionando corretamente.

Instalar com NuGet

PM >  Install-Package IronXl.Excel

Confira o IronXL no NuGet para uma instalação rápida. Com mais de 10 milhões de downloads, ele está transformando o desenvolvimento de PDFs com C#. Você também pode baixar a DLL .

Como Você Converte um Arquivo CSV para DataTable?

O fluxo de trabalho principal no IronXL envolve apenas algumas linhas de código. Aqui está como ler um arquivo CSV e convertê-lo em um DataTable usando declarações de nível superior em C# 10+:

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

using IronXL;
using System.Data;

// Load CSV file into a WorkBook object
WorkBook workbook = WorkBook.LoadCSV("sales_data.csv",
    fileFormat: ExcelFileFormat.XLSX);

// Access the default worksheet
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Convert to DataTable with headers
DataTable dataTable = worksheet.ToDataTable(true);

// Display the data
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

O método LoadCSV analisa automaticamente seu arquivo CSV, lidando com campos entre aspas e vírgulas embutidas. O parâmetro fileFormat informa ao IronXL como interpretar internamente os dados CSV, garantindo que seja tratado como uma estrutura compatível com Excel. Uma vez carregado, o método ToDataTable(true) converte a planilha em um DataTable, com o parâmetro true indicando que a primeira linha deve ser usada como cabeçalhos de coluna. Isso resulta em um DataTable limpo e estruturado com colunas nomeadas que correspondem aos seus cabeçalhos de CSV. Para mais opções avançadas de manipulação, explore o guia completo de como fazer do IronXL.

O processo de conversão também preserva os tipos de dados -- números permanecem numéricos, datas são interpretadas corretamente e campos de texto mantêm seu formato. Essa inferência automática de tipo economiza tempo de desenvolvimento considerável em comparação com abordagens de análise manual. Para cenários que exigem formatação de dados personalizada, você pode aplicar formatação de célula antes da conversão.

Como Você Importa um DataTable no SQL Server?

Uma vez que você tem seu DataTable, importá-lo para o SQL Server torna-se eficiente usando SqlBulkCopy. O exemplo a seguir usa instruções de alto nível em C#:

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

using System.Data;
using Microsoft.Data.SqlClient;
using IronXL;

// Create connection string
string connectionString = "Data Source=localhost;Initial Catalog=SalesDB;" +
    "Integrated Security=True;TrustServerCertificate=True;";

// Read CSV into DataTable
WorkBook workbook = WorkBook.LoadCSV("inventory_report.csv");
DataTable dataTable = workbook.DefaultWorkSheet.ToDataTable(true);

// Bulk insert into SQL Server
using SqlConnection connection = new SqlConnection(connectionString);
connection.Open();

using SqlBulkCopy bulkCopy = new SqlBulkCopy(connection);

// Set destination table name
bulkCopy.DestinationTableName = "dbo.Inventory";

// Map DataTable columns to SQL table columns
bulkCopy.ColumnMappings.Add("ProductCode", "product_code");
bulkCopy.ColumnMappings.Add("Quantity", "quantity");
bulkCopy.ColumnMappings.Add("LastUpdated", "last_updated");

// Set batch size for better performance
bulkCopy.BatchSize = 1000;

// Write data to SQL Server
bulkCopy.WriteToServer(dataTable);

Console.WriteLine($"Successfully imported {dataTable.Rows.Count} records");

A classe SqlBulkCopy fornece alto desempenho para importações de dados em larga escala. A coleção ColumnMappings mapeia colunas DataTable para colunas do banco de dados com nomes diferentes, garantindo flexibilidade no seu esquema de dados. A propriedade BatchSize otimiza o uso da memória processando registros em blocos em vez de carregar tudo de uma vez. Saiba mais sobre as capacidades de importação e exportação do IronXL.

Para integridade de dados adicional, considere implementar suporte a transações em torno de suas operações de cópia em massa. Isso assegura que importações parciais possam ser revertidas se ocorrerem erros. Você também pode usar os recursos de gravação de arquivo Excel do IronXL para pré-validar dados antes da importação.

Aqui, você pode usar a consulta SELECT * FROM dbo.Inventory; no SSMS para verificar se seus dados CSV foram importados para o SQL Server. Primeiro, veja os dados usados no arquivo CSV de exemplo:

Agora, se você olhar para a saída da consulta, poderá ver que ela copiou com sucesso todas as colunas, cabeçalhos e linhas para a tabela do banco de dados.

Como Lidar com Diferentes Delimitadores CSV?

Nem todos os arquivos CSV usam vírgulas. O IronXL lida com vários delimitadores, tornando-o prático para formatos de dados internacionais ou sistemas legados. O exemplo a seguir demonstra o carregamento de arquivos delimitados por tabulação e ponto e vírgula:

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

using IronXL;
using System;
using System.Data;
using System.IO;

// --- Tab-delimited file ---
string tsvPath = "export_data.tsv";
WorkBook tsvWorkbook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, "\t");

// --- Semicolon-delimited file ---
string semiPath = "european_data.csv";
string tempCsv = Path.Combine(Path.GetTempPath(), "european_data_comma.csv");

// Replace semicolons with commas for proper parsing
string[] lines = File.ReadAllLines(semiPath);
for (int i = 0; i < lines.Length; i++)
{
    lines[i] = lines[i].Replace(';', ',');
}
File.WriteAllLines(tempCsv, lines);

WorkBook semiWorkbook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX);

// Print tab-delimited results
DataTable tsvTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("--- Tab-delimited File ---");
foreach (DataColumn col in tsvTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in tsvTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

// Print semicolon-delimited results
DataTable semiTable = semiWorkbook.DefaultWorkSheet.ToDataTable(true);
Console.WriteLine("\n--- Semicolon-delimited File ---");
foreach (DataColumn col in semiTable.Columns)
    Console.Write($"{col.ColumnName}\t");
Console.WriteLine();
foreach (DataRow row in semiTable.Rows)
{
    foreach (var item in row.ItemArray)
        Console.Write($"{item}\t");
    Console.WriteLine();
}

Este código demonstra o carregamento de arquivos CSV com diferentes delimitadores em objetos WorkBook do IronXL. Arquivos delimitados por tabulação são lidos usando "\t" como separador, enquanto arquivos delimitados por ponto e vírgula são convertidos para o formato CSV padrão antes de serem carregados. A planilha padrão de cada workbook é convertida em um DataTable com ToDataTable(true), que usa a primeira linha como cabeçalhos de coluna. Para cenários de formatos de arquivo mais complexos, você também pode explorar a exportação de dados Excel para vários formatos.

A flexibilidade para lidar com diferentes delimitadores resolve muitos desafios reais de análise de CSV. Ao trabalhar com formatos de dados europeus, o tratamento de delimitadores do IronXL acomoda diferenças regionais nos padrões de formatação de dados. Para arquivos com estruturas inconsistentes, processe o texto bruto antes de passá-lo para LoadCSV.

O padrão RFC 4180 define a especificação do formato CSV que o IronXL segue para campos entre aspas e vírgulas incorporadas. Essa flexibilidade também é discutida em detalhe no tópico da comunidade Stack Overflow sobre como ler CSV em DataTable no .NET.

Quais são os recursos suportados pelo IronXL além do CSV?

IronXL abrange muito mais do que a leitura de CSV. A biblioteca lida com todo o espectro de operações de Excel e planilhas no C#, tornando-se uma única dependência para aplicativos centrados em dados.

Quais são os próximos passos?

IronXL transforma as importações de bancos de dados CSV em um processo simples e confiável. Com apenas algumas linhas de código, você pode:

• Ler arquivos CSV de qualquer caminho usando a funcionalidade LoadCSV
• Converta dados CSV em um DataTable com formatação de dados adequada
• Preservar cabeçalhos de coluna e colunas DataTable através da análise automática
• Importar milhões de linhas em uma tabela de banco de dados de forma eficiente usando operações em massa

A biblioteca lida com as sutilezas da análise de CSV, gerenciamento de memória e conversões de tipos de dados, permitindo que você se concentre na lógica de negócios em vez de detalhes de processamento de arquivos. Quer você esteja construindo aplicativos ASP.NET, trabalhando com Blazor, ou desenvolvendo aplicativos desktop .NET 10, o IronXL fornece processamento CSV consistente e confiável em todas as plataformas.

Pronto para começar? A documentação do IronXL cobre cada funcionalidade em profundidade, e uma licença de avaliação permite que você avalie toda a biblioteca. Com exemplos extensivos de código e referências claras de API, você estará processando arquivos CSV de forma eficiente em seus aplicativos .NET 10 em pouco tempo.