Cómo usar una biblioteca CSV en C# para leer y escribir archivos

¿Cómo empezar a utilizar IronXL?

Instalar IronXL lleva solo segundos a través de NuGet Package Manager. Abre tu Consola del Administrador de Paquetes en Visual Studio y ejecuta:

Install-Package IronXL.Excel

Después de la instalación, agrega el espacio de nombres IronXL a tu archivo C#.

using IronXL;

using IronXL;

Imports IronXL

IronXL funciona en entornos Windows, Linux y macOS, soportando .NET Framework 4.6.2+ y .NET Core/5/6/7/8+. La biblioteca opera independientemente sin dependencias de Microsoft Office, lo que la hace ideal para implementaciones en servidores y aplicaciones en la nube. Para instrucciones detalladas de configuración, visita la guía de instalación de IronXL.

¿Cómo leer archivos CSV con IronXL?

IronXL soporta la lectura de archivos CSV con facilidad, siguiendo todo el proceso un patrón intuitivo. La biblioteca maneja automáticamente desafíos comunes como la detección de codificación y la identificación de delimitadores, problemas que los desarrolladores encuentran con frecuencia al analizar datos CSV:

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");
// Access the imported worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Read specific cell values
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;
// iterating from row 1 to skip the header row
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

// Load a CSV file into a WorkBook
WorkBook workBook = WorkBook.Load("sales_data.csv");
// Access the imported worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;
// Read specific cell values
string customerName = workSheet["A2"].StringValue;
decimal orderAmount = workSheet["B2"].DecimalValue;
// iterating from row 1 to skip the header row
for (int i = 1; i < workSheet.Rows.Count(); i++)
{
    var row = workSheet.Rows[i];
    Console.WriteLine($"Customer: {row.Columns[0].Value}, Amount: {row.Columns[1].Value}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Este código carga un archivo CSV en un objeto WorkBook, el cual proporciona toda la funcionalidad de una hoja de cálculo. La propiedad DefaultWorkSheet brinda acceso inmediato a los datos CSV. Las celdas individuales se pueden acceder usando la notación familiar de Excel como "A2", con métodos de conversión de tipo incorporados (StringValue, DecimalValue, IntValue) asegurando un manejo adecuado de los datos. El bucle for demuestra la iteración de filas, tratando cada fila como una colección de celdas. Hemos usado un bucle que automáticamente saltará la primera fila ya que es una fila de encabezado; sin embargo, si deseas mantener tu encabezado como parte de la salida, solo usa:

foreach (var row in workSheet.Rows)
{
    Console.WriteLine($"{row.Columns[0].Value}, {row.Columns[1].Value}");
}

foreach (var row in workSheet.Rows)
{
    Console.WriteLine($"{row.Columns[0].Value}, {row.Columns[1].Value}");
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Para escenarios más complejos, explora el tutorial completo de lectura.

¿Cómo escribir archivos CSV en C#?

Crear archivos CSV con IronXL admite múltiples enfoques, desde construir nuevas hojas de cálculo hasta convertir estructuras de datos existentes. Esta flexibilidad lo hace ideal para escenarios de exportación de datos:

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");
// Add header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";
// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;
// Save as CSV
workBook.SaveAsCsv("inventory.csv");

// Create a new workbook
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("inventory");
// Add header row
workSheet["A1"].Value = "Product";
workSheet["B1"].Value = "Quantity";
workSheet["C1"].Value = "Price";
// Add data rows
workSheet["A2"].Value = "Widget";
workSheet["B2"].Value = 100;
workSheet["C2"].Value = 19.99;
// Save as CSV
workBook.SaveAsCsv("inventory.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Este ejemplo crea un nuevo libro desde cero y lo llena con datos. El método SaveAsCsv() exporta la hoja de trabajo a formato CSV, manejando automáticamente el formato y los delimitadores adecuados. IronXL preserva los tipos de datos durante la exportación, asegurando que los números se mantengan numéricos en lugar de convertir todo a cadenas. El método SaveAsCsv admite delimitadores personalizados cuando sea necesario.

DataTable dataTable = GetDataFromDatabase();
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("export");
workSheet.InsertDataTable(dataTable, "A1");
workBook.SaveAsCsv("export.csv");

DataTable dataTable = GetDataFromDatabase();
WorkBook workBook = WorkBook.Create();
WorkSheet workSheet = workBook.CreateWorkSheet("export");
workSheet.InsertDataTable(dataTable, "A1");
workBook.SaveAsCsv("export.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

¿Puede IronXL convertir entre formatos CSV y Excel?

La característica destacada de IronXL es la conversión fluida entre formatos CSV y Excel. Esta capacidad elimina la necesidad de bibliotecas separadas al trabajar con diferentes tipos de archivo, un requisito común discutido por desarrolladores:

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");
// Convert Excel to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

// Convert CSV to Excel
WorkBook csvWorkBook = WorkBook.Load("data.csv");
csvWorkBook.SaveAs("data.xlsx");
// Convert Excel to CSV
WorkBook xlsxWorkBook = WorkBook.Load("report.xlsx");
xlsxWorkBook.SaveAsCsv("report.csv");

IRON VB CONVERTER ERROR developers@ironsoftware.com

Estas conversiones preservan la integridad de los datos, incluyendo tipos numéricos, fechas y fórmulas cuando sea aplicable. Al convertir archivos Excel de múltiples hojas a CSV, IronXL crea archivos CSV separados para cada hoja de trabajo:

WorkBook multiSheetWorkBook = WorkBook.Load("multi_sheet.xlsx");
multiSheetWorkBook.SaveAsCsv("output.csv");
// Creates: output.Sheet1.csv, output.Sheet2.csv, etc.

WorkBook multiSheetWorkBook = WorkBook.Load("multi_sheet.xlsx");
multiSheetWorkBook.SaveAsCsv("output.csv");
// Creates: output.Sheet1.csv, output.Sheet2.csv, etc.

IRON VB CONVERTER ERROR developers@ironsoftware.com

El proceso de conversión maneja características complejas de Excel con gracia. Las fórmulas se evalúan a sus valores, el formato se preserva cuando es posible, y las reglas de validación de datos se mantienen en el formato de Excel. Aprende más sobre la conversión de Excel a CSV en la documentación.

Y para ver cómo uno de estos archivos CSV resiste en comparación con el archivo .xlsx original, veamos el archivo output.Customers abierto en notepad vs. la hoja de Customers vista en Excel:

Empiece con IronXL ahora.

Comience gratis

¿Por qué elegir IronXL para el manejo de archivos CSV?

Al evaluar bibliotecas CSV de C#, los desarrolladores consideran factores como la facilidad de uso, la completitud de características y el soporte a largo plazo. IronXL aborda estas necesidades de manera completa:

Más allá de las operaciones básicas de CSV, IronXL proporciona características empresariales como el manejo de archivos protegidos por contraseña, la preservación del estilo de celda y el cálculo de fórmulas. La API unificada significa que los desarrolladores aprenden una biblioteca para todas las necesidades de hojas de cálculo, reduciendo la complejidad en proyectos que manejan múltiples formatos de archivo.

La compatibilidad multiplataforma asegura un comportamiento consistente en entornos de desarrollo y producción. El enfoque de código administrado de la biblioteca elimina las dependencias específicas de la plataforma, simplificando la implementación y el mantenimiento. Para comparaciones detalladas de características, consulta la página de características de IronXL.

Conclusión

IronXL agiliza todo el flujo de trabajo de lectura y escritura de archivos CSV, conversión entre Excel y CSV y manejo de características avanzadas de hojas de cálculo. Es más que solo otra biblioteca CSV, es un conjunto completo de herramientas de hoja de cálculo para desarrolladores de .NET.

Al combinar una API limpia, soporte integral y pruebas de grado empresarial, IronXL ayuda a los desarrolladores a evitar perder tiempo persiguiendo errores, parcheando con pull requests ad-hoc o dependiendo de paquetes de código abierto fragmentados.

Si tu proyecto requiere funcionalidad confiable y de alto rendimiento para hojas de cálculo, IronXL es la elección correcta. Te capacita para gestionar archivos, procesar datos y construir soluciones escalables, todo con estabilidad profesional y facilidad de uso.

¿Listo para simplificar tu manejo de CSV y Excel? Comienza con una prueba gratis comenzando desde $liteLicense, que incluye soporte profesional y actualizaciones continuas.