Cómo leer un archivo CSV en un DataTable en C#

¿Por qué es importante la conversión de CSV a DataTable?

La conversión de CSV a DataTable permite a los desarrolladores transformar valores separados por comas en objetos estructurados para su posterior procesamiento. Tanto si maneja datos de inventario, registros de clientes o registros de transacciones, convertir CSV a DataTable de forma eficiente es crucial. Utilizando la primera fila como encabezados de columna, puede asegurarse de que las columnas de DataTable se alinean con el esquema de su tabla de base de datos, lo que la hace perfecta para operaciones de Excel a DataSet.

Los enfoques tradicionales a menudo enfrentan dificultades con archivos grandes, diferentes delimitadores o gestión de memoria. IronXL elimina estos retos y gestiona diferentes delimitadores, campos entre comillas y comas incrustadas sin código adicional. Las capacidades de lectura de CSV de IronXL eliminan los problemas habituales al tiempo que ofrecen funciones adicionales como la validación de datos y el control del tamaño de los archivos.

¿Cómo se instala IronXL?

Para empezar a utilizar IronXL, solo hay que instalar un sencillo paquete de NuGet. Abre la Consola del Administrador de Paquetes NuGet en Visual Studio y ejecuta:

Install-Package IronXL

Install-Package IronXL

O si prefieres la CLI de .NET:

dotnet add package IronXL

dotnet add package IronXL

Una vez instalado, agrega el espacio de nombres IronXL a tu proyecto:

using IronXL;
using System.Data;

using IronXL;
using System.Data;

Imports IronXL
Imports System.Data

Esto proporciona acceso a todas las capacidades de procesamiento de CSV sin ninguna dependencia de Excel. Para obtener más detalles, consulte la documentación de IronXL y la guía de instalación de NuGet.

¿Cómo convertir un archivo CSV a DataTable?

El flujo de trabajo principal en IronXL requiere solo unas pocas líneas de código. A continuación se explica cómo leer un archivo CSV y convertirlo en un DataTable utilizando sentencias de nivel superior en 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

El método LoadCSV analiza su archivo CSV automáticamente, manejando los campos entrecomillados y las comas incrustadas. El parámetro fileFormat indica a IronXL cómo interpretar los datos CSV internamente, asegurando que se traten como una estructura compatible con Excel. Una vez cargado, el método ToDataTable(true) convierte la hoja de cálculo en un DataTable, con el parámetro true que indica que la primera fila debe utilizarse como encabezado de columna. El resultado es un DataTable limpio y estructurado con columnas nombradas que coinciden con las cabeceras de su CSV. Para opciones de manipulación más avanzadas, consulta la guía práctica completa de IronXL.

El proceso de conversión también conserva los tipos de datos: los números siguen siendo numéricos, las fechas se analizan correctamente y los campos de texto mantienen su formato. Esta inferencia automática de tipos ahorra un tiempo de desarrollo considerable en comparación con los métodos de análisis sintáctico manual. En los casos que requieran un formato de datos personalizado, puede aplicar el formato de celda antes de la conversión.

¿Cómo importar un DataTable a SQL Server?

Una vez que tengas tu DataTable, importarlo a SQL Server se vuelve eficiente usando SqlBulkCopy. El siguiente ejemplo utiliza sentencias de nivel superior de 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")

La clase SqlBulkCopy proporciona un gran rendimiento para la importación de datos a gran escala. La colección ColumnMappings asigna columnas DataTable a columnas de bases de datos con nombres diferentes, lo que garantiza la flexibilidad de su esquema de datos. La propiedad BatchSize optimiza el uso de memoria procesando los registros en trozos en lugar de cargar todo a la vez. Más información sobre las capacidades de importación y exportación de IronXL.

Para una mayor integridad de los datos, considere la posibilidad de implementar soporte para transacciones en sus operaciones de copia masiva. Esto garantiza que las importaciones parciales se puedan revertir si se producen errores. También puede utilizar las funciones de escritura de archivos Excel de IronXL para validar previamente los datos antes de importarlos.

¿Cómo se manejan diferentes delimitadores de CSV?

No todos los archivos CSV usan comas. IronXL admite diversos delimitadores, lo que lo hace práctico para formatos de datos internacionales o sistemas heredados:

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 demuestra la carga de archivos CSV con diferentes delimitadores en objetos IronXL WorkBook. Los archivos delimitados por tabulaciones se leen utilizando "\t" como separador, mientras que los archivos delimitados por punto y coma se convierten al formato CSV estándar antes de cargarlos. Para casos más complejos relacionados con formatos de archivo, también puede explorar la posibilidad de exportar datos de Excel a diversos formatos.

¿Qué funciones de IronXL son compatibles además del formato CSV?

IronXL ofrece mucho más que la lectura de archivos CSV. La biblioteca gestiona todo el espectro de operaciones de Excel y hojas de cálculo en C#, lo que la convierte en una única dependencia para aplicaciones centradas en datos.

¿Cuáles son los próximos pasos?

IronXL convierte la importación de bases de datos CSV en un proceso sencillo y fiable. Con solo unas pocas líneas de código, puedes:

• Lee archivos CSV desde cualquier ruta de archivo utilizando la funcionalidad LoadCSV
• Convertir datos CSV en un DataTable con el formato de datos adecuado
• Conservar los encabezados de columna y las columnas de DataTable mediante el análisis sintáctico automático
• Importa millones de filas a una tabla de base de datos de forma eficiente mediante operaciones masivas

La biblioteca se encarga de las complejidades del análisis de CSV, la gestión de la memoria y las conversiones de tipos de datos, lo que le permite centrarse en su lógica de negocio en lugar de en los detalles del procesamiento de archivos. Tanto si estás creando aplicaciones ASP.NET, trabajando con Blazor o desarrollando aplicaciones de escritorio .NET 10, IronXL ofrece un procesamiento de CSV coherente y fiable en todas las plataformas.

¿Listo para comenzar? La documentación de IronXL cubre todas las características en profundidad, y una Licencia Trial le permite evaluar la biblioteca IronXL completa.