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írgula em objetos estruturados para processamento posterior. Seja para lidar com dados de estoque, registros de clientes ou logs de transações, converter CSV para um formato DataTable de forma eficiente é crucial. Usando a primeira linha como cabeçalhos de coluna, você pode garantir que as colunas do DataTable estejam alinhadas com o esquema da tabela do seu banco de dados, tornando-o perfeito para operações do Excel .

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. Os recursos de leitura de CSV do IronXL eliminam problemas comuns, ao mesmo tempo que oferecem funcionalidades adicionais como validação de dados e controle do tamanho do arquivo.

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:

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;

Imports IronXL
Imports System.Data

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

Como converter um arquivo CSV para DataTable?

O fluxo de trabalho principal no IronXL envolve apenas algumas linhas de código. Veja como ler um arquivo CSV e convertê-lo em um DataTable usando instruçõ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();
}

Imports IronXL
Imports System.Data

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

' Access the default worksheet
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet

' Convert to DataTable with headers
Dim dataTable As DataTable = worksheet.ToDataTable(True)

' Display the data
For Each row As DataRow In dataTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}" & vbTab)
    Next
    Console.WriteLine()
Next

O método LoadCSV analisa seu arquivo CSV automaticamente, lidando com campos entre aspas e vírgulas internas. O parâmetro fileFormat informa ao IronXL como interpretar os dados CSV internamente, garantindo que sejam tratados como uma estrutura compatível com o 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 arquivo CSV limpo e estruturado com colunas nomeadas que correspondem aos seus cabeçalhos. Para opções de manipulação mais avançadas, explore o guia completo de instruções do IronXL .

O processo de conversão também preserva os tipos de dados — os números permanecem numéricos, as datas são analisadas corretamente e os campos de texto mantêm sua formatação. 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 a formatação de células antes da conversão.

Como importar um DataTable para o SQL Server?

Depois de obter 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");

Imports System.Data
Imports Microsoft.Data.SqlClient
Imports IronXL

' Create connection string
Dim connectionString As String = "Data Source=localhost;Initial Catalog=SalesDB;" &
    "Integrated Security=True;TrustServerCertificate=True;"

' Read CSV into DataTable
Dim workbook As WorkBook = WorkBook.LoadCSV("inventory_report.csv")
Dim dataTable As DataTable = workbook.DefaultWorkSheet.ToDataTable(True)

' Bulk insert into SQL Server
Using connection As New SqlConnection(connectionString)
    connection.Open()

    Using bulkCopy As 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)
    End Using
End Using

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

A classe SqlBulkCopy oferece um desempenho robusto para importações de dados em larga escala. A coleção ColumnMappings mapeia colunas DataTable para colunas de banco de dados com nomes diferentes, garantindo flexibilidade em seu esquema de dados. A propriedade BatchSize otimiza o uso de memória processando os registros em partes, em vez de carregar tudo de uma vez. Saiba mais sobre as funcionalidades de importação e exportação da 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 arquivos Excel do IronXL para pré-validar os dados antes da importação.

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:

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

Imports IronXL
Imports System
Imports System.Data
Imports System.IO

' --- Tab-delimited file ---
Dim tsvPath As String = "export_data.tsv"
Dim tsvWorkbook As WorkBook = WorkBook.LoadCSV(tsvPath, ExcelFileFormat.XLSX, ControlChars.Tab)

' --- Semicolon-delimited file ---
Dim semiPath As String = "european_data.csv"
Dim tempCsv As String = Path.Combine(Path.GetTempPath(), "european_data_comma.csv")

' Replace semicolons with commas for proper parsing
Dim lines As String() = File.ReadAllLines(semiPath)
For i As Integer = 0 To lines.Length - 1
    lines(i) = lines(i).Replace(";"c, ","c)
Next
File.WriteAllLines(tempCsv, lines)

Dim semiWorkbook As WorkBook = WorkBook.LoadCSV(tempCsv, ExcelFileFormat.XLSX)

' Print tab-delimited results
Dim tsvTable As DataTable = tsvWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine("--- Tab-delimited File ---")
For Each col As DataColumn In tsvTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In tsvTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

' Print semicolon-delimited results
Dim semiTable As DataTable = semiWorkbook.DefaultWorkSheet.ToDataTable(True)
Console.WriteLine(vbCrLf & "--- Semicolon-delimited File ---")
For Each col As DataColumn In semiTable.Columns
    Console.Write($"{col.ColumnName}{ControlChars.Tab}")
Next
Console.WriteLine()
For Each row As DataRow In semiTable.Rows
    For Each item In row.ItemArray
        Console.Write($"{item}{ControlChars.Tab}")
    Next
    Console.WriteLine()
Next

Este código demonstra o carregamento de arquivos CSV com diferentes delimitadores em objetos IronXL WorkBook. Os arquivos delimitados por tabulação são lidos usando "\t" como separador, enquanto os arquivos delimitados por ponto e vírgula são convertidos para o formato CSV padrão antes do carregamento. Para cenários com formatos de arquivo mais complexos, você também pode explorar a exportação de dados do Excel para diversos formatos.

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:

• Leia arquivos CSV de qualquer caminho de arquivo usando a funcionalidade LoadCSV
• Converter dados CSV em um DataTable com formatação de dados adequada
• Preservar cabeçalhos de coluna e colunas do DataTable por meio de análise sintática automática. Importe milhões de linhas para uma tabela de banco de dados de forma eficiente usando operações em lote.

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. Seja para criar aplicações ASP.NET , trabalhar com Blazor ou desenvolver aplicativos desktop .NET 10, o IronXL oferece processamento CSV consistente e confiável em todas as plataformas.

Pronto para começar? A documentação do IronXL aborda todos os recursos em detalhes, e uma licença de avaliação permite que você teste a biblioteca completa.