Cómo crear hojas de cálculo de Excel en C# .NET Core con IronXL

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

Antes de crear hojas de cálculo, debe agregar IronXL a su proyecto. Abra la consola del Administrador de paquetes NuGet en Visual Studio y ejecute uno de estos comandos:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

El primer comando funciona en la consola del Administrador de paquetes de Visual Studio. El segundo funciona en cualquier terminal que utilice la CLI .NET . Ambos instalan el mismo paquete NuGet y agregan IronXL a las referencias de su proyecto automáticamente.

Una vez completada la instalación, IronXL está listo para usar con una sola directiva using. La biblioteca no requiere configuración adicional, dependencias de ejecución ni instalación de Microsoft Office. Funciona en cualquier plataforma donde se ejecute .NET 10: Windows, Linux, macOS o cualquier entorno de nube.

Para conocer las opciones de instalación detalladas, incluida la descarga manual de DLL, consulte la guía de instalación de IronXL . Los desarrolladores de Linux también deben revisar la documentación de implementación de Linux para obtener orientación específica de la plataforma.

¿Cómo crear una hoja de cálculo de Excel sin dependencias de Office?

La automatización tradicional de Microsoft Excel requiere la instalación de MS Office y utiliza Office Interop, que no funciona en Linux ni en entornos de contenedores. Como se analiza en la documentación de Microsoft sobre Office Interop , Office Interop presenta complejidad de implementación y problemas de licencia. IronXL for .NET elimina estas limitaciones al proporcionar una solución .NET pura que procesa archivos de Excel de forma nativa con total compatibilidad con las capacidades de las hojas de cálculo modernas.

La biblioteca es compatible con .NET 8, .NET 9 y .NET 10, así como con las versiones anteriores de .NET Core. Maneja XLSX, XLS, CSV y otros formatos de hoja de cálculo sin dependencias externas. Esto lo hace particularmente valioso para aplicaciones del lado del servidor, microservicios y escenarios donde instalar Microsoft Office no es práctico. La fácil integración a través de NuGet significa que puede comenzar a escribir archivos de Excel en cuestión de minutos:

using IronXL;

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add an Excel worksheet with a custom name
WorkSheet sheet = workbook.CreateWorkSheet("SalesReport");
// Set a cell value
sheet["A1"].Value = "Product Sales Summary";
// Save the generated Excel file
workbook.SaveAs("SalesReport.xlsx");

using IronXL;

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add an Excel worksheet with a custom name
WorkSheet sheet = workbook.CreateWorkSheet("SalesReport");
// Set a cell value
sheet["A1"].Value = "Product Sales Summary";
// Save the generated Excel file
workbook.SaveAs("SalesReport.xlsx");

El método WorkBook.Create() inicializa un nuevo libro de Excel y acepta un parámetro ExcelFileFormat para especificar XLSX (formato moderno basado en XML introducido en Excel 2007) o XLS (formato binario heredado). Se recomienda XLSX para la mayoría de los casos debido al menor tamaño de los archivos y a la mayor compatibilidad con las herramientas modernas. El método CreateWorkSheet() agrega hojas de trabajo con nombre donde se encuentran los datos de Excel: cada libro puede contener varias hojas individuales para organizar datos relacionados.

Los valores de las celdas se establecen utilizando una notación de corchetes que refleja el sistema de direccionamiento de Excel: sheet["A1"] apunta directamente a la celda A1. Esta sintaxis admite tanto celdas como rangos específicos, lo que hace que las operaciones masivas sean sencillas para cualquier proyecto de hoja de cálculo.

¿Cómo agregar hojas de trabajo y completar datos mediante programación?

Las hojas de cálculo Excel del mundo real contienen datos estructurados en varias hojas de cálculo. IronXL proporciona métodos flexibles para organizar la información y rellenar las celdas de forma eficiente, tanto si se trabaja con la introducción manual de datos como con canalizaciones de datos automatizadas en aplicaciones basadas en datos.

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("MonthlySales");

// Set column names as headers
sheet["A1"].Value = "Month";
sheet["B1"].Value = "Revenue";
sheet["C1"].Value = "Units Sold";

// Populate Excel data using a loop (mock sales data)
string[] months = { "January", "February", "March", "April", "May", "June" };
decimal[] revenue = { 45000.50m, 52000.75m, 48500.25m, 61000.00m, 58750.50m, 67200.25m };
int[] units = { 150, 175, 160, 200, 190, 220 };

for (int i = 0; i < months.Length; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = months[i];
    sheet[$"B{row}"].Value = revenue[i];
    sheet[$"C{row}"].Value = units[i];
}

// Set a range of cells to the same value across columns
sheet["D2:D7"].Value = "Active";
workbook.SaveAs("MonthlySales.xlsx");

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("MonthlySales");

// Set column names as headers
sheet["A1"].Value = "Month";
sheet["B1"].Value = "Revenue";
sheet["C1"].Value = "Units Sold";

// Populate Excel data using a loop (mock sales data)
string[] months = { "January", "February", "March", "April", "May", "June" };
decimal[] revenue = { 45000.50m, 52000.75m, 48500.25m, 61000.00m, 58750.50m, 67200.25m };
int[] units = { 150, 175, 160, 200, 190, 220 };

for (int i = 0; i < months.Length; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = months[i];
    sheet[$"B{row}"].Value = revenue[i];
    sheet[$"C{row}"].Value = units[i];
}

// Set a range of cells to the same value across columns
sheet["D2:D7"].Value = "Active";
workbook.SaveAs("MonthlySales.xlsx");

La interpolación de cadenas ($"A{row}") permite el direccionamiento dinámico de celdas dentro de bucles, lo que hace que sea sencillo completar filas mediante programación desde cualquier fuente de datos. La sintaxis de rango sheet["D2:D7"] aplica valores a múltiples celdas simultáneamente, lo que resulta útil para columnas de estado, valores predeterminados o para inicializar regiones de datos. IronXL maneja automáticamente la conversión de tipos de datos, almacenando decimales como valores numéricos y el contenido de cadenas como texto mientras conserva los tipos de datos de Excel apropiados para el archivo generado.

WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");
WorkSheet detailSheet = workbook.CreateWorkSheet("Details");
WorkSheet archiveSheet = workbook.CreateWorkSheet("Archive");

WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");
WorkSheet detailSheet = workbook.CreateWorkSheet("Details");
WorkSheet archiveSheet = workbook.CreateWorkSheet("Archive");

¿Cómo aplicar formato y estilo profesionales?

Los datos en bruto adquieren sentido cuando se formatean correctamente. IronXL admite colores de fondo, fuentes, bordes y formatos de números: capacidades de formato esenciales que transforman las hojas de cálculo de Excel en informes pulidos adecuados para presentaciones ejecutivas o entregas a clientes.

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("FormattedReport");

// Create headers with styling
sheet["A1"].Value = "Category";
sheet["B1"].Value = "Amount";
sheet["C1"].Value = "Date";

// Apply header formatting to the Excel sheet
sheet["A1:C1"].Style.SetBackgroundColor("#2E86AB");
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.Font.SetColor("#FFFFFF");

// Add sample data to specific cells
sheet["A2"].Value = "Software License";
sheet["B2"].Value = 1299.99m;
sheet["C2"].Value = DateTime.Now;

// Format currency and date columns
sheet["B2"].FormatString = "$#,##0.00";
sheet["C2"].FormatString = "yyyy-MM-dd";

// Add borders around the data range
var dataRange = sheet["A1:C2"];
dataRange.Style.BottomBorder.SetColor("#000000");
dataRange.Style.BottomBorder.Type = IronXl.Styles.BorderType.Thin;
workbook.SaveAs("FormattedReport.xlsx");

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("FormattedReport");

// Create headers with styling
sheet["A1"].Value = "Category";
sheet["B1"].Value = "Amount";
sheet["C1"].Value = "Date";

// Apply header formatting to the Excel sheet
sheet["A1:C1"].Style.SetBackgroundColor("#2E86AB");
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.Font.SetColor("#FFFFFF");

// Add sample data to specific cells
sheet["A2"].Value = "Software License";
sheet["B2"].Value = 1299.99m;
sheet["C2"].Value = DateTime.Now;

// Format currency and date columns
sheet["B2"].FormatString = "$#,##0.00";
sheet["C2"].FormatString = "yyyy-MM-dd";

// Add borders around the data range
var dataRange = sheet["A1:C2"];
dataRange.Style.BottomBorder.SetColor("#000000");
dataRange.Style.BottomBorder.Type = IronXl.Styles.BorderType.Thin;
workbook.SaveAs("FormattedReport.xlsx");

La propiedad Style expone opciones de formato que coinciden con las capacidades de Microsoft Excel. Los colores de fondo aceptan códigos hexadecimales (con o sin el prefijo #), mientras que FormatString aplica formatos numéricos idénticos a la sintaxis de formato personalizado de Excel: los mismos patrones funcionan en ambos entornos. El estilo de borde admite los tipos Fino, Medio, Grueso y Doble, lo que permite un control preciso sobre los límites de las celdas en su hoja de cálculo de Excel.

¿Cómo utilizar las fórmulas de Excel para cálculos automáticos?

El motor de cálculo de Excel automatiza el análisis de datos y IronXL proporciona soporte completo para fórmulas. Establezca fórmulas como cadenas utilizando la sintaxis estándar de Excel y IronXL calculará los resultados automáticamente cuando se le solicite, lo cual es esencial para informes y análisis financieros.

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("BudgetCalculations");

// Add expense data to the Excel workbook
sheet["A1"].Value = "Expense";
sheet["B1"].Value = "Amount";
sheet["A2"].Value = "Rent";
sheet["B2"].Value = 2500;
sheet["A3"].Value = "Utilities";
sheet["B3"].Value = 350;
sheet["A4"].Value = "Supplies";
sheet["B4"].Value = 875;
sheet["A5"].Value = "Marketing";
sheet["B5"].Value = 1200;

// Add formulas for calculations
sheet["A7"].Value = "Total:";
sheet["B7"].Formula = "=SUM(B2:B5)";
sheet["A8"].Value = "Average:";
sheet["B8"].Formula = "=AVERAGE(B2:B5)";
sheet["A9"].Value = "Maximum:";
sheet["B9"].Formula = "=MAX(B2:B5)";
sheet["A10"].Value = "Count:";
sheet["B10"].Formula = "=COUNT(B2:B5)";

// Calculate all formulas
workbook.EvaluateAll();

// Access calculated values programmatically
decimal total = sheet["B7"].DecimalValue;
Console.WriteLine($"Calculated total: {total}");
workbook.SaveAs("BudgetCalculations.xlsx");

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("BudgetCalculations");

// Add expense data to the Excel workbook
sheet["A1"].Value = "Expense";
sheet["B1"].Value = "Amount";
sheet["A2"].Value = "Rent";
sheet["B2"].Value = 2500;
sheet["A3"].Value = "Utilities";
sheet["B3"].Value = 350;
sheet["A4"].Value = "Supplies";
sheet["B4"].Value = 875;
sheet["A5"].Value = "Marketing";
sheet["B5"].Value = 1200;

// Add formulas for calculations
sheet["A7"].Value = "Total:";
sheet["B7"].Formula = "=SUM(B2:B5)";
sheet["A8"].Value = "Average:";
sheet["B8"].Formula = "=AVERAGE(B2:B5)";
sheet["A9"].Value = "Maximum:";
sheet["B9"].Formula = "=MAX(B2:B5)";
sheet["A10"].Value = "Count:";
sheet["B10"].Formula = "=COUNT(B2:B5)";

// Calculate all formulas
workbook.EvaluateAll();

// Access calculated values programmatically
decimal total = sheet["B7"].DecimalValue;
Console.WriteLine($"Calculated total: {total}");
workbook.SaveAs("BudgetCalculations.xlsx");

La propiedad Formula acepta la sintaxis de fórmula estándar de Excel: las mismas fórmulas que funcionan en Microsoft Excel funcionan aquí. Después de configurar las fórmulas, llame a EvaluateAll() para calcular los resultados. Este paso garantiza que los valores calculados estén disponibles inmediatamente a través de propiedades tipificadas como DecimalValue, IntValue o StringValue. Sin llamar a EvaluateAll(), las fórmulas aún se guardan correctamente y se calculan cuando se abren en Excel, pero el acceso programático a los resultados requiere una evaluación previa.

decimal sum = sheet["B2:B5"].Sum();
decimal avg = sheet["B2:B5"].Avg();
decimal max = sheet["B2:B5"].Max();

decimal sum = sheet["B2:B5"].Sum();
decimal avg = sheet["B2:B5"].Avg();
decimal max = sheet["B2:B5"].Max();

¿Cómo exportar archivos de Excel y servirlos para su descarga?

IronXL admite varios formatos de exportación para satisfacer diferentes requisitos de integración. Además de los formatos estándar de Excel, las hojas de cálculo pueden exportarse a CSV para el intercambio de datos, JSON para aplicaciones web o TSV para la compatibilidad con sistemas heredados. Esta flexibilidad facilita la integración de la generación de Excel en cualquier flujo de trabajo.

using IronXL;

WorkBook workbook = WorkBook.Load("BudgetCalculations.xlsx");

// Export to different formats
workbook.SaveAs("output.xlsx");      // Modern Excel (Office 2007+)
workbook.SaveAs("output.xls");       // Legacy Excel (97-2003)
workbook.SaveAsCsv("output.csv");    // CSV for data import/export
workbook.SaveAsJson("output.json");  // JSON for web APIs

using IronXL;

WorkBook workbook = WorkBook.Load("BudgetCalculations.xlsx");

// Export to different formats
workbook.SaveAs("output.xlsx");      // Modern Excel (Office 2007+)
workbook.SaveAs("output.xls");       // Legacy Excel (97-2003)
workbook.SaveAsCsv("output.csv");    // CSV for data import/export
workbook.SaveAsJson("output.json");  // JSON for web APIs

Cada formato sirve para casos de uso específicos. XLSX funciona mejor para conservar el formato y las fórmulas cuando se comparte con usuarios de Excel. El formato CSV ofrece la máxima compatibilidad para la importación a bases de datos, herramientas de análisis u otras aplicaciones de hoja de cálculo. JSON se integra naturalmente con los frontends de JavaScript y las API REST.

[HttpGet("download-report")]
public IActionResult DownloadReport()
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workbook.CreateWorkSheet("Report");
    sheet["A1"].Value = "Generated Report";
    sheet["A2"].Value = DateTime.Now;

    var stream = workbook.ToStream();
    return File(
        stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "Report.xlsx"
    );
}

[HttpGet("download-report")]
public IActionResult DownloadReport()
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workbook.CreateWorkSheet("Report");
    sheet["A1"].Value = "Generated Report";
    sheet["A2"].Value = DateTime.Now;

    var stream = workbook.ToStream();
    return File(
        stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "Report.xlsx"
    );
}

¿Cómo se compara IronXL con otras bibliotecas .NET Excel?

Existen varias bibliotecas para la manipulación de Excel en .NET, cada una con diferentes puntos fuertes. La siguiente tabla muestra cómo se comparan según los criterios que más importan para las aplicaciones de producción:

IronXL se destaca en escenarios empresariales que requieren soporte técnico confiable, documentación y actualizaciones consistentes. La biblioteca maneja con elegancia casos extremos (archivos corruptos, fórmulas complejas y grandes conjuntos de datos) donde las alternativas de código abierto pueden tener dificultades. Para los equipos que priorizan la velocidad del desarrollo y la confiabilidad de la producción, el respaldo comercial de IronXL brinda tranquilidad.

Según los debates en Stack Overflow, los desarrolladores citan con frecuencia la simplicidad de la API y la calidad de la documentación como factores decisivos a la hora de elegir bibliotecas Excel para sus proyectos .NET Core. La Fundación .NET también enfatiza la implementación multiplataforma como una prioridad para el desarrollo moderno de .NET , lo que hace que las bibliotecas independientes de Office sean esenciales para soluciones mantenibles.

Para equipos preocupados por la seguridad: IronXL funciona independientemente de Microsoft Office y evita Office Interop, lo que minimiza el riesgo de vulnerabilidades externas. El soporte integrado para cifrado y protección con contraseña le permite proteger los archivos Excel generados, garantizando que solo los usuarios autorizados puedan acceder o editar hojas de trabajo y datos críticos. Revise las opciones de licencia de IronXL para encontrar el plan que se adapte a su equipo.

¿Cómo gestionar el rendimiento a gran escala?

Cuando su aplicación genera archivos Excel para muchos usuarios simultáneos o procesa grandes conjuntos de datos, la planificación del rendimiento se vuelve fundamental. IronXL maneja libros de trabajo grandes de manera eficiente porque opera completamente en memoria sin generar procesos de Office ni objetos COM. Esta arquitectura mantiene la sobrecarga de la CPU y la memoria predecibles.

¿Cuales son tus próximos pasos?

La creación de hojas de cálculo de Excel .NET Core con IronXL convierte lo que antes era una tarea con muchas dependencias en una operación .NET sencilla. Desde la manipulación básica de celdas hasta cálculos de fórmulas y formato profesional, la biblioteca proporciona un conjunto de herramientas completo para la automatización de hojas de cálculo que se ejecuta en cualquier lugar donde se ejecute .NET 10: servidores Windows, contenedores Linux o plataformas en la nube.

La arquitectura multiplataforma garantiza un comportamiento idéntico en máquinas de desarrollo y entornos de producción, eliminando los problemas de "funciona en mi máquina" habituales en las soluciones Office Interop. Comience con el comando de instalación de NuGet , cree su primer libro de trabajo y desarrolle desde allí utilizando los patrones que se muestran a lo largo de esta guía.

Descargue una prueba gratuita de 30 días para explorar todas las funciones sin limitaciones o ver las opciones de licencia para la implementación de producción. Explore los ejemplos de código de IronXL para ver escenarios adicionales en acción y consulte el centro de documentación de IronXL para obtener la referencia completa de API y guías de configuración avanzadas.