C# Leer archivo XLSX

¿Por qué utilizar el método WorkBook.Load()?

En el código anterior, la función WorkBook.Load() carga sample.xlsx en workBook. Se puede realizar cualquier tipo de función en workBook accediendo a la WorkSheet específica de un archivo Excel. El método WorkBook.Load detecta automáticamente el formato del archivo, ya sea XLS, XLSX, XLSM, XLTX o CSV. Para escenarios de carga más avanzados, consulte la guía detallada sobre carga de hojas de cálculo.

¿Cuáles son las distintas formas de acceder a una hoja de cálculo?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-worksheet.cs

using IronXL;

// Access sheet by name
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

IRON VB CONVERTER ERROR developers@ironsoftware.com

workBook es el WorkBook que se declara en la parte anterior.

O

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-worksheet-index.cs

using IronXL;

// Access sheet by index
WorkSheet workSheet = workBook.WorkSheets[0];

IRON VB CONVERTER ERROR developers@ironsoftware.com

O

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-default-worksheet.cs

using IronXL;

// Access the default worksheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

IRON VB CONVERTER ERROR developers@ironsoftware.com

O

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-worksheet.cs

using IronXL;
using System.Linq;

// Access the first worksheet
WorkSheet workSheet = workBook.WorkSheets.First();

IRON VB CONVERTER ERROR developers@ironsoftware.com

O

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-first-or-default-worksheet.cs

using IronXL;
using System.Linq;

// Access the first or default worksheet
WorkSheet workSheet = workBook.WorkSheets.FirstOrDefault();

IRON VB CONVERTER ERROR developers@ironsoftware.com

¿Cuándo debo utilizar cada método de acceso a la hoja de cálculo?

Cada método tiene su caso de uso ideal:

• GetWorkSheet("nombre"): Cuando se conoce el nombre exacto de la hoja
• Hojas de trabajo[index]: Para iterar a través de las hojas mediante programación
• Hoja de trabajo predeterminada: Acceso rápido cuando se trabaja con archivos de una sola hoja
• First() o FirstOrDefault(): opciones seguras cuando los nombres de las hojas pueden cambiar

Después de obtener ExcelSheet workSheet, puede obtener cualquier tipo de datos de él y realizar todas las funciones de Excel en él. Para operaciones más complejas con hojas de cálculo, consulte la guía sobre apertura de hojas de cálculo de Excel en C#.

¿Qué tipos de datos puedo leer de las celdas?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-get-data.cs

using IronXL;

// Accessing data as a string
string dataString = workSheet["A1"].ToString();

// Accessing data as an integer
int dataInt = workSheet["B1"].Int32Value;

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronXL proporciona varios accesores de valor para diferentes tipos de datos:

• StringValue: Para datos de texto
• Int32Value: Para números enteros
• DoubleValue: Para decimales
• DateTimeValue: Para fechas
• BoolValue: Para valores verdadero/falso

¿Cómo puedo leer varias celdas a la vez?

También puede obtener datos de varias celdas de una columna específica:

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

For Each cell In workSheet("A2:A10")
	Console.WriteLine("Value is: {0}", cell.Text)
Next cell

Esto muestra los valores de la celda A2 a A10. Para conocer técnicas más avanzadas de selección de rangos, visite el tutorial de selección de rangos.

¿Cómo es una implementación completa?

Aquí se proporciona un ejemplo de código completo de las especificaciones anteriores:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-log-data.cs

using IronXL;
using System;

// Load an Excel file
WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Specify the range
foreach (var cell in workSheet["B2:B10"])
{
    Console.WriteLine("Value is: {0}", cell.Text);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Muestra el siguiente resultado:

Con el archivo Excel Sample.xlsx:

Estas metodologías muestran lo fácil que es utilizar datos de archivos Excel en tu proyecto. Para ver ejemplos prácticos de lectura de archivos de Excel sin Interop, explore la lectura de ejemplos de Excel.

¿Qué funciones agregadas están disponibles?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-aggregate-function.cs

using IronXL;

// Apply aggregate functions
decimal sum = workSheet["G2:G10"].Sum(); // Sum of cells from G2 to G10
decimal min = workSheet["G2:G10"].Min(); // Minimum value in cells from G2 to G10
decimal max = workSheet["G2:G10"].Max(); // Maximum value in cells from G2 to G10

IRON VB CONVERTER ERROR developers@ironsoftware.com

IronXL admite numerosas funciones matemáticas, entre las que se incluyen:

• Promedio(): Calcular el valor medio
• Count(): Cuenta las celdas no vacías
• CountIf(): Cuenta las celdas que cumplen los criterios
• Mediana(): Encontrar el valor medio
• StdDev(): Calcular la desviación estándar

¿Cómo puedo implementar varias funciones a la vez?

Para más detalles, consulte nuestro tutorial en profundidad sobre Cómo Escribir archivos de Excel en C# con información específica sobre funciones agregadas. También puedes explorar la lista completa de funciones matemáticas disponibles en IronXL.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-min-max.cs

using IronXL;
using System;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Calculate sum, minimum, and maximum for a range of cells
decimal sum = workSheet["G2:G10"].Sum();
decimal min = workSheet["G2:G10"].Min();
decimal max = workSheet["G2:G10"].Max();

// Output results
Console.WriteLine("Sum is: {0}", sum);
Console.WriteLine("Min is: {0}", min);
Console.WriteLine("Max is: {0}", max);

IRON VB CONVERTER ERROR developers@ironsoftware.com

Este código muestra la siguiente salida:

Y este es el aspecto del archivo Excel Sample.xlsx:

¿Cuál es el método básico de conversión?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable.cs

using IronXL;
using System.Data;

// Convert worksheet to DataTable
DataTable dt = workSheet.ToDataTable();

IRON VB CONVERTER ERROR developers@ironsoftware.com

¿Cómo utilizo la primera fila como encabezado de columna?

Para utilizar la primera fila de ExcelSheet como DataTable ColumnName:

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-datatable-header.cs

using IronXL;
using System.Data;

// Convert worksheet to DataTable with the first row as column names
DataTable dt = workSheet.ToDataTable(true);

IRON VB CONVERTER ERROR developers@ironsoftware.com

El parámetro booleano de ToDataTable() establece la primera fila como los nombres de columna de su DataTable. Por defecto, su valor es False. Esto es especialmente útil cuando se trabaja con datos estructurados que incluyen cabeceras.

¿Cómo itero a través de DataTable?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-print-datatable.cs

using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Get the specified WorkSheet
WorkSheet workSheet = workBook.GetWorkSheet("Sheet1");

// Convert WorkSheet to DataTable
DataTable dt = workSheet.ToDataTable(true); // Use first row as column names

// Iterate through rows and columns and display data
foreach (DataRow row in dt.Rows) // Access rows
{
    for (int i = 0; i < dt.Columns.Count; i++) // Access columns of corresponding row
    {
        Console.Write(row[i] + " ");
    }
    Console.WriteLine();
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

Utilizando el código anterior, se puede acceder a cada valor de celda de la WorkSheet y utilizarlo según sea necesario. Para operaciones más avanzadas con DataTable, consulte la guía sobre importación y exportación como DataSet.

¿Cómo convierto un libro de trabajo en DataSet?

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-file-excel-to-dataset.cs

using IronXL;
using System;
using System.Data;

// Load the Excel workbook
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Convert the WorkBook to a DataSet
DataSet ds = workBook.ToDataSet();

// Iterate through tables in the DataSet and display table names
foreach (DataTable dt in ds.Tables)
{
    Console.WriteLine(dt.TableName);
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

El resultado del código anterior es el siguiente:

Y el archivo Excel Sample.xlsx tiene este aspecto:

¿Cómo puedo acceder al valor de cada celda en todas las hojas de cálculo?

En el ejemplo anterior, podemos convertir fácilmente un archivo Excel en un DataSet y trabajar con cada WorkSheet de un archivo Excel como una DataTable. Profundice en cómo parse Excel as a DataSet aquí con ejemplos de código.

Veamos otro ejemplo de cómo acceder a cada valor de celda de todas las ExcelSheets. Aquí, podemos acceder al valor de cada celda de cada WorkSheet de un archivo Excel.

:path=/static-assets/excel/content-code-examples/how-to/c-sharp-read-xlsx-all-excel-sheets.cs

// ¡ESTE FRAGMENTO DE CÓDIGO NO ESTÁ DISPONIBLE!

' ¡ESTE FRAGMENTO DE CÓDIGO NO ESTÁ DISPONIBLE!

Utilizando el ejemplo anterior, es conveniente acceder a cada valor de celda de cada WorkSheet de un archivo Excel. Este enfoque es especialmente útil cuando se trata de libros de varias hojas de trabajo en los que los datos están distribuidos en diferentes pestañas.

Para más información sobre cómo Leer archivos Excel sin Interop consulta el código aquí. La documentación de referencia de la API proporciona detalles completos sobre todos los métodos y propiedades disponibles en IronXL API Reference.

Tutorial de acceso rápido

Referencia API para IronXL

Lea más sobre las características, clases, campos de métodos, espacios de nombres y enumeraciones de IronXL en la documentación.

Referencia API para IronXL