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 gestiona datos de inventario, registros de clientes o registros de transacciones, es fundamental convertir CSV a DataTable de forma eficiente. Al utilizar la primera fila como encabezados de columna, puede asegurarse de que las columnas de DataTable se alineen con el esquema de su tabla de base de datos, lo que lo hace perfecto para operaciones de Excel a SQL.

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 de NuGet en Visual Studio y ejecuta uno de los siguientes comandos:

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;

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 se comprueba que la instalación se ha realizado correctamente?

Crea un programa de prueba que cargue un archivo CSV para verificar la instalación. Si aparece algún mensaje sobre la licencia, deberá obtener una clave de licencia. Comprueba las referencias de paquetes en tu archivo de proyecto para asegurarte de que IronXL aparece con la versión correcta. Ejecute una operación básica de lectura de CSV: si se completa sin errores, la instalación funciona correctamente.

Instalar con NuGet

PM >  Install-Package IronXL.Excel

Echa un vistazo a IronXL en NuGet para una instalación rápida. Con más de 10 millones de descargas, está transformando el desarrollo de PDF con C#. También puede descargar el DLL.

¿Cómo se convierte 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 a 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();
}

El método LoadCSV analiza tu archivo CSV automáticamente, gestionando los campos entre comillas y las comas incrustadas. El parámetro fileFormat indica a IronXL cómo interpretar los datos CSV internamente, garantizando que se traten como una estructura compatible con Excel. Una vez cargada, el método ToDataTable(true) convierte la hoja de cálculo en un DataTable, con el parámetro true indicando que la primera fila debe utilizarse como encabezados de columna. El resultado es un archivo DataTable limpio y estructurado con columnas con nombres que coinciden con los encabezados de tu 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 se importa un DataTable a SQL Server?

Una vez que tenga su DataTable, importarlo a SQL Server resulta eficiente utilizando 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");

La clase SqlBulkCopy ofrece un gran rendimiento para importaciones de datos a gran escala. La colección ColumnMappings asigna las columnas DataTable a columnas de la base de datos con nombres diferentes, lo que garantiza la flexibilidad en su esquema de datos. La propiedad BatchSize optimiza el uso de la memoria al procesar los registros por partes en lugar de cargarlos todos 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.

Aquí, puede utilizar la consulta SELECT * FROM dbo.Inventory; en SSMS para comprobar que sus datos CSV se han importado a SQL Server. En primer lugar, echa un vistazo a los datos utilizados en el archivo CSV de ejemplo:

Ahora, si observas el resultado de la consulta, verás que se han copiado correctamente todas las columnas, encabezados y filas en la tabla de la base de datos.

¿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. El siguiente ejemplo muestra cómo cargar archivos delimitados por tabulaciones y por punto y coma:

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 muestra cómo cargar 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 cargarse. La hoja de cálculo predeterminada de cada libro se convierte en una DataTable con ToDataTable(true), que utiliza la primera fila como encabezados de columna. Para casos más complejos relacionados con formatos de archivo, también puede explorar la posibilidad de exportar datos de Excel a diversos formatos.

La flexibilidad para manejar diferentes delimitadores resuelve muchos de los retos del análisis de CSV en el mundo real. Al trabajar con formatos de datos europeos, el manejo de delimitadores de IronXL se adapta a las diferencias regionales en los estándares de formato de datos. En el caso de archivos con estructuras inconsistentes, preprocesa el texto sin formato antes de pasarlo a LoadCSV.

El estándar RFC 4180 define la especificación del formato CSV que IronXL sigue para los campos entre comillas y las comas incrustadas. Esta flexibilidad también se analiza en detalle en el hilo de la comunidad de Stack Overflow sobre la lectura de CSV en DataTable en .NET.

¿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 a 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. Con numerosos ejemplos de código y referencias claras a las API, podrás procesar archivos CSV de forma eficiente en tus aplicaciones .NET 10 en un abrir y cerrar de ojos.