C# CSV a XLSX: Convertir archivos CSV a formato Excel

¿Cómo convertir archivos CSV al formato XLSX en C#?

La conversión principal requiere cargar el archivo CSV y guardarlo en formato Excel. IronXL proporciona WorkBook.LoadCSV, que analiza la fuente delimitada y crea un libro de trabajo listo para exportar. El método acepta la ruta del archivo, el formato Excel de destino y el carácter delimitador.

using IronXL;

// Load CSV file and convert to XLSX format
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");

// Access the default worksheet containing CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Save as Excel XLSX file
workbook.SaveAs("output.xlsx");

using IronXL;

// Load CSV file and convert to XLSX format
WorkBook workbook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.XLSX, ListDelimiter: ",");

// Access the default worksheet containing CSV data
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Save as Excel XLSX file
workbook.SaveAs("output.xlsx");

¿Cuáles son los beneficios de convertir formato CSV a Excel?

El formato XLSX ofrece ventajas mensurables sobre el formato CSV simple para la mayoría de los escenarios de gestión de datos:

• Varias hojas de trabajo : los archivos de Excel admiten varias hojas dentro de un solo libro, lo que permite un almacenamiento de datos organizado que los archivos CSV no pueden igualar. Un solo archivo XLSX puede contener docenas de hojas de trabajo que abarcan diferentes períodos de tiempo, regiones o categorías.
• Compatibilidad con fórmulas : escriba cálculos complejos, agregaciones y lógica condicional directamente en las celdas. Las fórmulas de Excel se recalculan automáticamente cuando cambian los datos de origen, lo que elimina la necesidad de reprocesar archivos CSV manualmente.
• Gráficos visuales : cree gráficos de barras, gráficos de líneas, gráficos circulares y otras visualizaciones a partir de los datos de la hoja de cálculo. IronXL admite la creación de gráficos directamente a través de la API, por lo que los gráficos se integran en el archivo XLSX.
• Formato de celda : controle fuentes, colores, bordes y formatos de números para documentos profesionales. Los archivos CSV almacenan únicamente valores sin procesar; XLSX conserva la capa de visualización junto con los datos.
• Validación de datos : restrinja la entrada de celdas a valores o rangos específicos, lo que evita errores de ingreso de datos en archivos compartidos con los usuarios finales.
• Protección con contraseña : proteja hojas de trabajo y libros de trabajo con contraseñas para controlar el acceso de lectura y escritura, una característica completamente ausente en CSV.

Estas capacidades hacen del formato XLSX la opción estándar para informes, paneles, modelos financieros y cualquier aplicación que requiera más que el almacenamiento de datos sin procesar.

¿Cómo instalar IronXL en un proyecto .NET ?

IronXL se distribuye como un paquete NuGet . Instálelo desde la consola del Administrador de paquetes en Visual Studio:

Install-Package IronXl

Install-Package IronXl

O utilizando la CLI de .NET:

dotnet add package IronXl

dotnet add package IronXl

Después de la instalación, agregue using IronXL; a cualquier archivo que funcione con hojas de cálculo. El paquete está destinado a .NET Framework 4.6.2+, .NET Core 3.1+, .NET 5 a .NET 10, y es compatible con entornos de implementación de Windows, Linux, macOS, Docker y Azure.

No se requieren dependencias de tiempo de ejecución adicionales ni instalación de Microsoft Office. IronXL lee y escribe archivos XLSX utilizando su propio analizador y escritor, lo que lo hace adecuado para implementaciones del lado del servidor y sin cabeza donde no se puede instalar Office.

¿Cómo se maneja la codificación CSV durante la conversión?

Muchos archivos CSV se originan en sistemas heredados, bases de datos internacionales o exportaciones de terceros que utilizan caracteres que no son ASCII. El manejo correcto de la codificación garantiza que los caracteres especiales y el texto internacional permanezcan intactos en el archivo XLSX resultante.

using IronXL;
using System.Text;

// Load CSV with explicit encoding specification
WorkBook workbook = WorkBook.LoadCSV("international-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",",
    encoding: Encoding.UTF8);

// Access the worksheet containing the encoded data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Inspect a cell to verify encoding was preserved
string cellValue = sheet["A1"].StringValue;

// Save the converted Excel file
workbook.SaveAs("encoded-output.xlsx");

using IronXL;
using System.Text;

// Load CSV with explicit encoding specification
WorkBook workbook = WorkBook.LoadCSV("international-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",",
    encoding: Encoding.UTF8);

// Access the worksheet containing the encoded data
WorkSheet sheet = workbook.DefaultWorkSheet;

// Inspect a cell to verify encoding was preserved
string cellValue = sheet["A1"].StringValue;

// Save the converted Excel file
workbook.SaveAs("encoded-output.xlsx");

¿Cómo aplicar el formato de celda después de la conversión CSV?

Los datos CSV sin procesar no contienen información de formato. Después de convertir a XLSX, aplique formatos de números, fuentes y colores de fondo para que la hoja de cálculo sea legible y profesional.

using IronXL;
using IronXl.Styles;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("sales-report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Format the header row with bold text and background color
Range headerRow = sheet["A1:Z1"];
headerRow.Style.Font.Bold = true;
headerRow.Style.SetBackgroundColor("#4472C4");
headerRow.Style.Font.Color = "#FFFFFF";

// Apply currency format to a numeric column
Range priceColumn = sheet["C2:C100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Auto-fit column widths for readability
sheet.AutoSizeColumn(0);
sheet.AutoSizeColumn(1);
sheet.AutoSizeColumn(2);

workbook.SaveAs("formatted-report.xlsx");

using IronXL;
using IronXl.Styles;

// Load CSV data
WorkBook workbook = WorkBook.LoadCSV("sales-report.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Format the header row with bold text and background color
Range headerRow = sheet["A1:Z1"];
headerRow.Style.Font.Bold = true;
headerRow.Style.SetBackgroundColor("#4472C4");
headerRow.Style.Font.Color = "#FFFFFF";

// Apply currency format to a numeric column
Range priceColumn = sheet["C2:C100"];
priceColumn.Style.NumberFormat = "$#,##0.00";

// Auto-fit column widths for readability
sheet.AutoSizeColumn(0);
sheet.AutoSizeColumn(1);
sheet.AutoSizeColumn(2);

workbook.SaveAs("formatted-report.xlsx");

IronXL expone el estilo de celdas y rangos a través de la propiedad Style, que refleja las opciones de formato disponibles en la interfaz de usuario de Excel. Los formatos de números siguen la sintaxis de formato de números de Excel documentada por Microsoft . El método SetBackgroundColor acepta cadenas de colores hexadecimales, lo que facilita la aplicación de colores de marca a los informes generados. Consulte la referencia completa de la API de formato de celda para conocer las propiedades de estilo disponibles.

¿Cómo puedes agregar gráficos después de convertir datos CSV?

Una vez que existen datos CSV en un libro de Excel, IronXL permite crear gráficos directamente a partir de esos datos. Los gráficos transforman números sin procesar en información visual sin necesidad de instalar Microsoft Excel en el servidor.

using IronXL;
using IronXl.Drawing.Charts;

// Load CSV and convert to Excel format
WorkBook workbook = WorkBook.LoadCSV("sales-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet worksheet = workbook.DefaultWorkSheet;

// Create a column chart from the converted CSV data
IChart chart = worksheet.CreateChart(ChartType.Column, 10, 0, 25, 10);

// Add data series from the worksheet ranges
IChartSeries series = chart.AddSeries("A2:A10", "B2:B10");
series.Title = "Monthly Sales";

// Configure chart appearance
chart.SetTitle("Sales Performance");
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart and save the workbook
chart.Plot();
workbook.SaveAs("sales-with-chart.xlsx");

using IronXL;
using IronXl.Drawing.Charts;

// Load CSV and convert to Excel format
WorkBook workbook = WorkBook.LoadCSV("sales-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet worksheet = workbook.DefaultWorkSheet;

// Create a column chart from the converted CSV data
IChart chart = worksheet.CreateChart(ChartType.Column, 10, 0, 25, 10);

// Add data series from the worksheet ranges
IChartSeries series = chart.AddSeries("A2:A10", "B2:B10");
series.Title = "Monthly Sales";

// Configure chart appearance
chart.SetTitle("Sales Performance");
chart.SetLegendPosition(LegendPosition.Bottom);

// Plot the chart and save the workbook
chart.Plot();
workbook.SaveAs("sales-with-chart.xlsx");

¿Cómo convertir un archivo CSV a una tabla de datos y luego a Excel?

Para escenarios que requieren manipulación de datos antes de la exportación, la conversión de datos CSV a través de un DataTable proporciona la máxima flexibilidad. Este enfoque permite a los desarrolladores filtrar, transformar, ordenar o validar filas durante el proceso de conversión utilizando patrones de acceso a datos .NET estándar.

using IronXL;
using System.Data;

// Load CSV file into workbook
WorkBook sourceWorkbook = WorkBook.LoadCSV("input.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Convert worksheet to DataTable for manipulation
DataTable table = sourceWorkbook.DefaultWorkSheet.ToDataTable(true);

// Filter rows -- keep only rows where the third column value is greater than 100
DataRow[] filtered = table.Select("Column3 > 100");
DataTable filteredTable = filtered.Length > 0 ? filtered.CopyToDataTable() : table.Clone();

// Create new workbook from modified data
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.CreateWorkSheet("Processed Data");

// Import filtered DataTable back into Excel
outputSheet.LoadFromDataTable(filteredTable, true);

// Save the final XLSX file
outputWorkbook.SaveAs("processed-output.xlsx");

using IronXL;
using System.Data;

// Load CSV file into workbook
WorkBook sourceWorkbook = WorkBook.LoadCSV("input.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Convert worksheet to DataTable for manipulation
DataTable table = sourceWorkbook.DefaultWorkSheet.ToDataTable(true);

// Filter rows -- keep only rows where the third column value is greater than 100
DataRow[] filtered = table.Select("Column3 > 100");
DataTable filteredTable = filtered.Length > 0 ? filtered.CopyToDataTable() : table.Clone();

// Create new workbook from modified data
WorkBook outputWorkbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet outputSheet = outputWorkbook.CreateWorkSheet("Processed Data");

// Import filtered DataTable back into Excel
outputSheet.LoadFromDataTable(filteredTable, true);

// Save the final XLSX file
outputWorkbook.SaveAs("processed-output.xlsx");

¿Cómo guardar un archivo XLSX en una secuencia en lugar de en una ruta de archivo?

Las aplicaciones del lado del servidor a menudo necesitan entregar archivos de Excel directamente a respuestas HTTP en lugar de escribir archivos temporales en el disco. IronXL admite guardar libros de trabajo en MemoryStream para este propósito.

using IronXL;
using System.IO;

// Load and convert CSV data
WorkBook workbook = WorkBook.LoadCSV("report-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Save workbook to a memory stream instead of a file
using MemoryStream stream = new MemoryStream();
workbook.SaveAs(stream);

// Reset stream position for reading
stream.Position = 0;

// The stream is now ready to pass to an HTTP response, upload to cloud storage,
// or attach to an email. For ASP.NET Core:
// return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "report.xlsx");

// Write bytes to verify stream contains XLSX data
byte[] xlsxBytes = stream.ToArray();
Console.WriteLine($"Generated XLSX size: {xlsxBytes.Length} bytes");

using IronXL;
using System.IO;

// Load and convert CSV data
WorkBook workbook = WorkBook.LoadCSV("report-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

WorkSheet sheet = workbook.DefaultWorkSheet;

// Save workbook to a memory stream instead of a file
using MemoryStream stream = new MemoryStream();
workbook.SaveAs(stream);

// Reset stream position for reading
stream.Position = 0;

// The stream is now ready to pass to an HTTP response, upload to cloud storage,
// or attach to an email. For ASP.NET Core:
// return File(stream, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet", "report.xlsx");

// Write bytes to verify stream contains XLSX data
byte[] xlsxBytes = stream.ToArray();
Console.WriteLine($"Generated XLSX size: {xlsxBytes.Length} bytes");

Guardar en un stream evita operaciones de lectura/escritura en disco y elimina la necesidad de limpiar archivos temporales. Este patrón se usa ampliamente en los puntos finales de descarga de archivos ASP.NET Core donde el XLSX se genera a pedido. La sobrecarga SaveAs(Stream) escribe un archivo XLSX completo y válido en cualquier instancia de flujo escribible.

¿Cómo trabajar con varias hojas de trabajo en un libro convertido?

Un solo libro de trabajo XLSX puede contener varias hojas de trabajo. Después de convertir un archivo CSV, el libro de trabajo contiene una hoja de forma predeterminada. Se pueden crear hojas adicionales mediante programación para organizar datos relacionados.

using IronXL;

// Load primary CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Rename the default sheet created from the CSV
WorkSheet q1Sheet = workbook.DefaultWorkSheet;
q1Sheet.Name = "Q1 Data";

// Create additional worksheets for summary information
WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");

// Write summary headers and formulas
summarySheet["A1"].Value = "Total Records";
summarySheet["B1"].Formula = $"=COUNTA('{q1Sheet.Name}'!A:A)-1";

summarySheet["A2"].Value = "Data Sheet";
summarySheet["B2"].Value = q1Sheet.Name;

// Save the multi-sheet workbook
workbook.SaveAs("multi-sheet-report.xlsx");

using IronXL;

// Load primary CSV data
WorkBook workbook = WorkBook.LoadCSV("quarterly-data.csv",
    fileFormat: ExcelFileFormat.XLSX,
    ListDelimiter: ",");

// Rename the default sheet created from the CSV
WorkSheet q1Sheet = workbook.DefaultWorkSheet;
q1Sheet.Name = "Q1 Data";

// Create additional worksheets for summary information
WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");

// Write summary headers and formulas
summarySheet["A1"].Value = "Total Records";
summarySheet["B1"].Formula = $"=COUNTA('{q1Sheet.Name}'!A:A)-1";

summarySheet["A2"].Value = "Data Sheet";
summarySheet["B2"].Value = q1Sheet.Name;

// Save the multi-sheet workbook
workbook.SaveAs("multi-sheet-report.xlsx");

El método CreateWorkSheet agrega una nueva hoja vacía al libro de trabajo. Se puede acceder a las hojas por nombre o por índice a través de workbook.WorkSheets. Las referencias de fórmulas entre hojas utilizan la notación estándar de Excel 'SheetName'!CellRef. Para obtener más información sobre operaciones con varias hojas, consulte la guía de hojas de trabajo múltiples de IronXL .

¿Cuales son tus próximos pasos?

Convertir archivos CSV a XLSX en C# con IronXL requiere solo unas pocas líneas de código y produce un libro de Excel totalmente compatible sin ninguna dependencia de Microsoft Office. Los ejemplos anteriores cubren el flujo de trabajo completo, desde la carga y el guardado básicos de CSV hasta el manejo de codificación, el formato de celdas, la creación de gráficos, la integración de DataTable, la salida de secuencias y los libros de trabajo de varias hojas.

Capacidades clave cubiertas en esta guía:

• Conversión básica de CSV a XLSX con WorkBook.LoadCSV y SaveAs
• Especificación de codificación para conjuntos de caracteres internacionales
• Formato de celda y rango aplicado después de la conversión
• Creación de gráficos incrustados directamente en el archivo XLSX
• Viaje de ida y vuelta de DataTable para datos filtrados y transformados
• Salida de MemoryStream para la entrega de archivos del lado del servidor
• Construcción de libros de trabajo de varias hojas a partir de una única fuente CSV

IronXL es compatible con implementaciones de Windows, Linux, macOS, Docker y Azure en .NET Framework, .NET Core y .NET 5 a 10. Para explorar más capacidades, revise la documentación de IronXL , explore la referencia de objetos de la API de Excel o consulte las guías prácticas de IronXL para temas como leer archivos de Excel , combinar celdas y aplicar fórmulas . Descargue una prueba gratuita para probar todas las funciones en un entorno de desarrollo o compre una licencia para implementación en producción.

Empiece con IronXL ahora.

Comience gratis