Cómo leer archivos de Excel en C# usando IronXL

¿Cómo se instala IronXL para el procesamiento de Excel?

Abra la Consola del Administrador de Paquetes NuGet en Visual Studio y ejecute el siguiente comando para agregar IronXL a su proyecto. Alternativamente, si prefiere trabajar desde una terminal, use el comando .NET CLI mostrado en la segunda línea:

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

Install-Package IronXl.Excel
dotnet add package IronXl.Excel

El paquete se instala en segundos y agrega una referencia a un ensamblado gestionado único a su proyecto. No hay registro COM, ni Ensamblados Primarios de Interop de Office, ni depende de versiones específicas de Excel para gestionar.

Después de la instalación, agregue la directiva using en la parte superior de cada archivo que funcione con datos de hojas de cálculo:

using IronXL;

using IronXL;

Ese único espacio de nombres le da acceso a WorkBook, WorkSheet, rangos de celdas, propiedades de valor tipeadas, funciones agregadas y todos los demás tipos de IronXL. La página de la Galería NuGet para IronXl.Excel lista cada versión disponible y su árbol completo de dependencias.

¿Qué formatos de archivo de Excel soporta IronXL?

Comprender los formatos que su aplicación debe manejar influye en las llamadas a la API que realiza y en las decisiones de almacenamiento que adopta su proyecto.

XLSX, el formato predeterminado desde Excel 2007, es un archivo ZIP de archivos XML. Soporta más de un millón de filas, formato enriquecido, tablas dinámicas y rangos nombrados. La mayoría de las canalizaciones de datos modernas producen salida XLSX, por lo que este es el formato que encuentra con más frecuencia.

XLS es el formato binario heredado usado por Excel 2003 y versiones anteriores. Algunos sistemas empresariales todavía exportan XLS, por lo que un soporte confiable para este formato es importante al integrarse con infraestructuras más antiguas. IronXL lee archivos XLS sin ninguna configuración especial por su parte.

XLSM amplía XLSX con soporte para macros. IronXL lee los datos de la hoja de cálculo de los archivos XLSM incluso si no ejecuta el código VBA incrustado, que es el comportamiento correcto para la extracción de datos del lado del servidor.

CSV y TSV son formatos tabulares de texto plano ampliamente utilizados para el intercambio de datos entre sistemas. WorkBook.LoadCSV maneja archivos separados por comas, e IronXL devuelve el mismo objeto WorkBook que su código ya sabe cómo navegar, manteniendo su lógica de lectura de datos uniforme independientemente del formato de origen.

IronXL detecta el formato de archivo automáticamente a partir de la extensión del archivo cuando se llama a WorkBook.Load. No es necesario especificar el formato explícitamente en la mayoría de los casos, lo que simplifica el código que debe manejar entradas que llegan desde múltiples fuentes.

¿Cómo cargar y leer un libro de Excel?

El método WorkBook.Load es el punto de entrada para todas las operaciones basadas en archivos. Pase la ruta del archivo y IronXL devuelve un objeto de libro de trabajo completamente poblado que puede consultar inmediatamente:

using IronXL;

// Load the workbook; format is detected automatically
WorkBook workbook = WorkBook.Load("Employees.xlsx");

// Access the first worksheet
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a single cell by A1 address
string companyName = sheet["A1"].StringValue;
Console.WriteLine($"Company: {companyName}");

// Access sheets by name or by zero-based index
WorkSheet byName  = workbook.GetWorkSheet("Sales");
WorkSheet byIndex = workbook.WorkSheets[1];

// Load a password-protected file
WorkBook secured = WorkBook.Load("Confidential.xlsx", "p@ssw0rd");

using IronXL;

// Load the workbook; format is detected automatically
WorkBook workbook = WorkBook.Load("Employees.xlsx");

// Access the first worksheet
WorkSheet sheet = workbook.DefaultWorkSheet;

// Read a single cell by A1 address
string companyName = sheet["A1"].StringValue;
Console.WriteLine($"Company: {companyName}");

// Access sheets by name or by zero-based index
WorkSheet byName  = workbook.GetWorkSheet("Sales");
WorkSheet byIndex = workbook.WorkSheets[1];

// Load a password-protected file
WorkBook secured = WorkBook.Load("Confidential.xlsx", "p@ssw0rd");

La propiedad DefaultWorkSheet devuelve la primera hoja, cubriendo la mayoría de los archivos de una sola hoja. Cuando su archivo contiene múltiples hojas, GetWorkSheet recupera por nombre y WorkSheets[n] recupera por índice basado en cero. La referencia de la API de WorkBook documenta cada sobrecarga y propiedad del objeto de libro de trabajo.

¿Cómo se leen valores de celdas de tipo específico desde Excel?

Cada celda en IronXL expone propiedades de tipo que devuelven valores en el tipo de datos exacto que necesita, sin necesidad de análisis o conversión manual. Las propiedades de tipo manejan la coerción desde la representación subyacente de la celda automáticamente:

using IronXL;

WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// Extract typed values from row 2
int      employeeId = sheet["A2"].IntValue;
string   name       = sheet["B2"].StringValue;
string   department = sheet["C2"].StringValue;
decimal  salary     = sheet["D2"].DecimalValue;
DateTime hireDate   = sheet["E2"].DateTimeValue;

Console.WriteLine($"ID:         {employeeId}");
Console.WriteLine($"Name:       {name}");
Console.WriteLine($"Department: {department}");
Console.WriteLine($"Salary:     {salary:C}");
Console.WriteLine($"Hired:      {hireDate:d}");

// Use the Text property for the formatted display value
string formattedSalary = sheet["D2"].Text;   // "$75,000.00"
string formattedDate   = sheet["E2"].Text;   // "28/02/2026"

// Guard against empty cells before reading
if (!sheet["B3"].IsEmpty)
{
    string value = sheet["B3"].StringValue;
}

using IronXL;

WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// Extract typed values from row 2
int      employeeId = sheet["A2"].IntValue;
string   name       = sheet["B2"].StringValue;
string   department = sheet["C2"].StringValue;
decimal  salary     = sheet["D2"].DecimalValue;
DateTime hireDate   = sheet["E2"].DateTimeValue;

Console.WriteLine($"ID:         {employeeId}");
Console.WriteLine($"Name:       {name}");
Console.WriteLine($"Department: {department}");
Console.WriteLine($"Salary:     {salary:C}");
Console.WriteLine($"Hired:      {hireDate:d}");

// Use the Text property for the formatted display value
string formattedSalary = sheet["D2"].Text;   // "$75,000.00"
string formattedDate   = sheet["E2"].Text;   // "28/02/2026"

// Guard against empty cells before reading
if (!sheet["B3"].IsEmpty)
{
    string value = sheet["B3"].StringValue;
}

La propiedad Text devuelve el valor de visualización exactamente como está formateado en Excel: útil cuando necesita la cadena de número formateado en lugar del número bruto. Para celdas que contienen fórmulas de Excel, IronXL evalúa la expresión y devuelve el resultado calculado a través de las mismas propiedades de tipo. Propiedades de valor adicionales -- BoolValue, DoubleValue, FloatValue -- aparecen en la referencia de valor de celda.

¿Cómo se iteran filas y columnas de Excel?

Procesar cada registro en un conjunto de datos requiere iterar a través de filas y columnas. La sintaxis de rango de IronXL se mapea directamente en la notación A1 de Excel, por lo que seleccionar un bloque de celdas es familiar para cualquiera que haya escrito fórmulas de hoja de cálculo:

using IronXL;

WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// Iterate a single column range
Console.WriteLine("Employee List:");
foreach (var cell in sheet["B2:B100"])
{
    if (!string.IsNullOrEmpty(cell.Text))
        Console.WriteLine($"  - {cell.Text}");
}

// Iterate all rows and all columns using the Rows property
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
        Console.Write(cell.Text.PadRight(15));
    Console.WriteLine();
}

using IronXL;

WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// Iterate a single column range
Console.WriteLine("Employee List:");
foreach (var cell in sheet["B2:B100"])
{
    if (!string.IsNullOrEmpty(cell.Text))
        Console.WriteLine($"  - {cell.Text}");
}

// Iterate all rows and all columns using the Rows property
foreach (var row in sheet.Rows)
{
    foreach (var cell in row)
        Console.Write(cell.Text.PadRight(15));
    Console.WriteLine();
}

El rango sheet["B2:B100"] devuelve una colección enumerable de objetos de celda. Verificar string.IsNullOrEmpty omite filas en blanco graciosamente. La propiedad Rows, documentada en la guía de rango de datos de la hoja de trabajo, recorre la hoja una fila a la vez y expone las celdas de cada fila sin requerir que conozca la cantidad de columnas de antemano.

¿Cómo se realizan cálculos agregados en datos de Excel?

IronXL incluye funciones agregadas integradas que calculan resultados directamente en rangos de celdas, sin necesidad de bucles de acumulación manual:

using IronXL;

WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// Built-in aggregate methods work on any named range
decimal total   = sheet["D2:D200"].Sum();
decimal highest = sheet["D2:D200"].Max();
decimal lowest  = sheet["D2:D200"].Min();
decimal average = sheet["D2:D200"].Avg();

Console.WriteLine($"Total Payroll:  {total:C}");
Console.WriteLine($"Highest Salary: {highest:C}");
Console.WriteLine($"Lowest Salary:  {lowest:C}");
Console.WriteLine($"Average Salary: {average:C}");

// Combine with LINQ for filtered aggregation
decimal itTotal = sheet["D2:D200"]
    .Where(c => sheet[$"C{c.RowIndex}"].StringValue == "IT")
    .Sum(c => c.DecimalValue);
Console.WriteLine($"IT Department Total: {itTotal:C}");

using IronXL;

WorkBook workbook = WorkBook.Load("Employees.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// Built-in aggregate methods work on any named range
decimal total   = sheet["D2:D200"].Sum();
decimal highest = sheet["D2:D200"].Max();
decimal lowest  = sheet["D2:D200"].Min();
decimal average = sheet["D2:D200"].Avg();

Console.WriteLine($"Total Payroll:  {total:C}");
Console.WriteLine($"Highest Salary: {highest:C}");
Console.WriteLine($"Lowest Salary:  {lowest:C}");
Console.WriteLine($"Average Salary: {average:C}");

// Combine with LINQ for filtered aggregation
decimal itTotal = sheet["D2:D200"]
    .Where(c => sheet[$"C{c.RowIndex}"].StringValue == "IT")
    .Sum(c => c.DecimalValue);
Console.WriteLine($"IT Department Total: {itTotal:C}");

Sum, Min, Max, y Avg omiten automáticamente las celdas vacías y manejan la conversión numérica detrás de escena. Encadenar consultas LINQ en el rango le proporciona agregados filtrados: subtotales por departamento, sumas de rangos de fechas y conteos condicionales, todo sin salir de la API de IronXL.

¿Cómo se construye un lector completo de datos de empleados?

El siguiente ejemplo reúne todo lo cubierto hasta ahora en una aplicación de consola lista para producción que carga una hoja de cálculo de empleados, formatea cada registro, acumula los totales de salario, maneja la escritura, y captura errores de manera oportuna:

using IronXL;

try
{
    WorkBook workbook = WorkBook.Load("Employees.xlsx");
    WorkSheet sheet   = workbook.DefaultWorkSheet;

    Console.WriteLine("=== Employee Data Report ===\n");

    int     rowNumber     = 2;
    decimal totalSalary   = 0m;
    int     employeeCount = 0;

    while (!string.IsNullOrEmpty(sheet[$"A{rowNumber}"].StringValue))
    {
        int      id         = sheet[$"A{rowNumber}"].IntValue;
        string   name       = sheet[$"B{rowNumber}"].StringValue;
        string   department = sheet[$"C{rowNumber}"].StringValue;
        decimal  salary     = sheet[$"D{rowNumber}"].DecimalValue;

        Console.WriteLine($"{id,4}  {name,-20}  {department,-15}  {salary,10:C}");

        totalSalary   += salary;
        employeeCount += 1;
        rowNumber     += 1;
    }

    Console.WriteLine($"\nTotal Employees: {employeeCount}");
    Console.WriteLine($"Total Payroll:   {totalSalary:C}");

    // Write a new record back to the sheet and save
    sheet["A10"].Value = 1010;
    sheet["B10"].Value = "Jane Doe";
    sheet["C10"].Value = "Finance";
    sheet["D10"].Value = 75000;
    workbook.SaveAs("Employees-Updated.xlsx");
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

using IronXL;

try
{
    WorkBook workbook = WorkBook.Load("Employees.xlsx");
    WorkSheet sheet   = workbook.DefaultWorkSheet;

    Console.WriteLine("=== Employee Data Report ===\n");

    int     rowNumber     = 2;
    decimal totalSalary   = 0m;
    int     employeeCount = 0;

    while (!string.IsNullOrEmpty(sheet[$"A{rowNumber}"].StringValue))
    {
        int      id         = sheet[$"A{rowNumber}"].IntValue;
        string   name       = sheet[$"B{rowNumber}"].StringValue;
        string   department = sheet[$"C{rowNumber}"].StringValue;
        decimal  salary     = sheet[$"D{rowNumber}"].DecimalValue;

        Console.WriteLine($"{id,4}  {name,-20}  {department,-15}  {salary,10:C}");

        totalSalary   += salary;
        employeeCount += 1;
        rowNumber     += 1;
    }

    Console.WriteLine($"\nTotal Employees: {employeeCount}");
    Console.WriteLine($"Total Payroll:   {totalSalary:C}");

    // Write a new record back to the sheet and save
    sheet["A10"].Value = 1010;
    sheet["B10"].Value = "Jane Doe";
    sheet["C10"].Value = "Finance";
    sheet["D10"].Value = 75000;
    workbook.SaveAs("Employees-Updated.xlsx");
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

El bucle while termina cuando la columna A queda vacía, haciendo que el lector se adapte a hojas de cálculo de cualquier longitud sin requerir un conteo de filas codificado. La escritura de valores sigue la misma sintaxis de dirección de celda que la lectura, y SaveAs persiste los cambios en un nuevo archivo para que el original permanezca intacto. El bloque try/catch maneja archivos faltantes, libros de trabajo bloqueados y datos corruptos: todos los escenarios que ocurren en entornos de producción donde los archivos de entrada llegan desde fuentes externas.

¿Cómo se manejan escenarios avanzados de lectura?

Varios escenarios menos comunes pero importantes surgen en proyectos reales. Los rangos nombrados, el descubrimiento de hojas de trabajo y la carga de CSV tienen cada uno soporte dedicado en la API.

Rangos nombrados le permiten referirse a los datos por una etiqueta lógica en lugar de una dirección de celda. Si el autor del libro de trabajo definió un rango nombrado llamado SalaryTable, lo accede directamente a través de GetRangeByName:

var range = workbook.GetRangeByName("SalaryTable");
decimal total = range.Sum();
Console.WriteLine($"Named range total: {total:C}");

var range = workbook.GetRangeByName("SalaryTable");
decimal total = range.Sum();
Console.WriteLine($"Named range total: {total:C}");

El descubrimiento de hojas de trabajo enumera cada hoja en el libro de trabajo, lo cual es útil al procesar archivos con un número variable de pestañas:

foreach (WorkSheet ws in workbook.WorkSheets)
    Console.WriteLine($"Sheet: {ws.Name}, Rows: {ws.RowCount}");

foreach (WorkSheet ws in workbook.WorkSheets)
    Console.WriteLine($"Sheet: {ws.Name}, Rows: {ws.RowCount}");

La carga de CSV utiliza un método dedicado optimizado para archivos de texto plano, devolviendo un WorkSheet que navega con la misma API de rango:

WorkBook csv    = WorkBook.LoadCSV("data.csv");
WorkSheet first = csv.DefaultWorkSheet;
Console.WriteLine(first["A1"].StringValue);

WorkBook csv    = WorkBook.LoadCSV("data.csv");
WorkSheet first = csv.DefaultWorkSheet;
Console.WriteLine(first["A1"].StringValue);

Estos patrones cubren los escenarios avanzados de lectura que aparecen en proyectos de migración de datos, canalizaciones ETL y sistemas de informes automatizados. Para la superficie completa de la API, consulte la referencia de objetos de IronXL.

Referencias autorizadas adicionales:

• Inicio de la documentación de IronXL
• Cómo editar fórmulas de Excel
• Cómo trabajar con funciones matemáticas
• Cómo seleccionar rangos
• Especificación Open XML ECMA-376: el estándar autoritativo que define el formato XLSX
• Documentación de Microsoft Open XML SDK: material de referencia para la estructura subyacente del archivo
• Galería NuGet - IronXl.Excel: página del paquete con historial de versiones y estadísticas de descargas

¿Cuales son tus próximos pasos?

IronXL transforma la lectura de archivos de Excel de un desafío de Interop lleno de dependencias a unas pocas líneas de código C# directo. Cargar libros de trabajo, extraer valores de tipo, iterar fila por fila, ejecutar cálculos agregados y manejar casos extremos siguen el mismo patrón API consistente, sin que Microsoft Office esté instalado en ningún lugar de su entorno de implementación.

Para pasar de tutorial a producción:

1. Inicie una prueba gratuita para desbloquear todo el conjunto de características de IronXL y validarlo contra sus propios archivos Excel antes de comprometerse con una licencia.
2. Explore la documentación completa de IronXL para guías sobre escritura, formato, estilo y conversión de hojas de cálculo.
3. Explore la referencia de objetos y API completa para descubrir cada clase, método y propiedad disponible en la biblioteca.
4. Revise la guía para crear hojas de cálculo cuando su flujo de trabajo requiera generar archivos de salida así como leer archivos de entrada.
5. Consulte el índice de publicaciones del blog de IronXL para tutoriales adicionales que cubren escenarios del mundo real, como la generación de informes, validación de datos y consolidación de múltiples hojas.