Cómo importar un archivo de Excel en C#

¿Qué características clave hacen que IronXL sea esencial para la importación de Excel?

• Abra, lea archivos de Excel y busque datos de diferentes formatos de hojas de cálculo como archivos XLS/CSV/TSV/XLSX sin necesidad de instalar Excel
• Exportar hojas de cálculo de Excel a múltiples formatos, incluidos XLS/XLSX/CSV/TSV/JSON e incluso HTML
• Cifrado y descifrado de archivos XLSM/XLTX/XLSX con contraseñas para mayor seguridad
• Importar hojas de Excel como objetos System.Data.DataSet y System.Data.DataTable para una integración perfecta con la base de datos
• Las fórmulas de los archivos de Excel se recalculan automáticamente cada vez que se edita una hoja
• Configuración intuitiva de rangos de celdas con una sintaxis fácil WorkSheet["A1:B10"] para seleccionar rangos
• Ordenar rangos de celdas, columnas y filas con métodos integrados
• Estilo de celda integral que incluye personalización de fuentes , colores de fondo , bordes y alineación , y formatos de numeración.

¿Qué necesito antes de comenzar a importar a Excel?

Para usar IronXL en C# para leer archivos de Excel, asegúrese de que los siguientes componentes estén instalados en su computadora:

1. Visual Studio : este es el IDE oficial para desarrollar aplicaciones C# .NET. Visual Studio proporciona un excelente soporte IntelliSense y herramientas de depuración que facilitan el trabajo con archivos de Excel. Puedes descargar e instalar Visual Studio desde el sitio web de Microsoft. La edición comunitaria es gratuita y suficiente para la mayoría de las necesidades de desarrollo.

2. IronXL : esta es la biblioteca que le ayuda a trabajar con hojas de Excel en una ruta determinada en C#. Debe instalarse en su programa C# antes de usarlo. IronXL se puede descargar fácilmente desde el sitio web de NuGet o instalar directamente a través de la interfaz Administrar paquetes NuGet en las herramientas de Visual Studio. También puede descargar el archivo DLL de .NET Excel directamente si prefiere la instalación manual.

Para las implementaciones de producción, necesitará aplicar una clave de licencia para eliminar las marcas de agua y habilitar la funcionalidad completa. El desarrollo y las pruebas se pueden realizar con la versión de prueba.

¿Qué espacios de nombres debo agregar a mi código?

Una vez instalados Visual Studio e IronXL, haga referencia al ensamblado IronXL para usar IronXL en su código fuente. Agregue la siguiente línea de código en la parte superior del archivo dentro del nuevo proyecto donde se utilizarán las funciones de IronXL:

using IronXL;

using IronXL;

Esta importación de espacio de nombres único proporciona acceso a todas las funciones principales necesarias para las operaciones de Excel. Si está trabajando con funciones específicas de Excel, como gráficos o formato condicional , es posible que necesite importar espacios de nombres adicionales de la biblioteca IronXL.

¿Cómo cargo y abro un archivo de Excel?

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from a stream
using (var stream = File.OpenRead("test.xlsx"))
{
    WorkBook streamWorkbook = WorkBook.Load(stream);
}

// Or load CSV files with custom delimiters
WorkBook csvWorkbook = WorkBook.LoadCSV("data.csv", delimiter: ",");

// Supported Excel spreadsheet formats for reading include: XLSX, XLS, CSV, and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");

// You can also load from a stream
using (var stream = File.OpenRead("test.xlsx"))
{
    WorkBook streamWorkbook = WorkBook.Load(stream);
}

// Or load CSV files with custom delimiters
WorkBook csvWorkbook = WorkBook.LoadCSV("data.csv", delimiter: ",");

// Get the first worksheet
WorkSheet sheet = workbook.WorkSheets.First();

// Or access by worksheet name
WorkSheet namedSheet = workbook.GetWorkSheet("Sheet1");

// Or by index (zero-based)
WorkSheet indexedSheet = workbook.WorkSheets[0];

// Get the first worksheet
WorkSheet sheet = workbook.WorkSheets.First();

// Or access by worksheet name
WorkSheet namedSheet = workbook.GetWorkSheet("Sheet1");

// Or by index (zero-based)
WorkSheet indexedSheet = workbook.WorkSheets[0];

¿Cómo puedo leer valores de celda específicos después de la importación?

Una vez importado el archivo Excel, está listo para leer datos. Leer datos de archivos de Excel en C# usando IronXL es muy simple y fácil. Puede leer los valores de las celdas de Excel simplemente mencionando el número de referencia de la celda en la notación estándar de Excel (como "A1", "B2", etc.). La biblioteca proporciona múltiples formas de acceder a los valores de las celdas según el tipo de datos esperado.

El código a continuación recupera el valor de una celda con número de referencia "C2":

// Select cells easily in Excel-notation and return the value
int cellValue = sheet["C2"].IntValue;

// Display the value
Console.WriteLine(cellValue);

// You can also access different data types
string textValue = sheet["A2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
double doubleValue = sheet["C2"].DoubleValue;
DateTime dateValue = sheet["D2"].DateTimeValue;
bool boolValue = sheet["E2"].BoolValue;

// Check if cell is empty
bool isEmpty = sheet["F2"].IsEmpty;

// Select cells easily in Excel-notation and return the value
int cellValue = sheet["C2"].IntValue;

// Display the value
Console.WriteLine(cellValue);

// You can also access different data types
string textValue = sheet["A2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
double doubleValue = sheet["C2"].DoubleValue;
DateTime dateValue = sheet["D2"].DateTimeValue;
bool boolValue = sheet["E2"].BoolValue;

// Check if cell is empty
bool isEmpty = sheet["F2"].IsEmpty;

El resultado es el siguiente:

Ventana de la consola de depuración de Microsoft Visual Studio que muestra el resultado de una operación de lectura de un archivo de Excel, la ruta del archivo y un mensaje de finalización. La salida de la consola de depuración después de leer con éxito un archivo de Excel en C#. El programa ha completado la ejecución y está esperando la entrada del usuario para cerrar.

Ahora, leamos los datos de un rango de celdas en el archivo de Excel abierto. IronXL facilita el trabajo con rangos de celdas mediante la notación habitual de Excel. El código es el siguiente:

// Read from a range of cells elegantly.
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// You can also work with entire rows or columns
var row = sheet.GetRow(2); // Get row 3 (0-indexed)
foreach (var cell in row)
{
    Console.WriteLine($"Row cell value: {cell.Value}");
}

// Or get a column
var column = sheet.GetColumn(0); // Get column A
foreach (var cell in column)
{
    Console.WriteLine($"Column A value: {cell.Value}");
}

// Read from a range of cells elegantly.
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// You can also work with entire rows or columns
var row = sheet.GetRow(2); // Get row 3 (0-indexed)
foreach (var cell in row)
{
    Console.WriteLine($"Row cell value: {cell.Value}");
}

// Or get a column
var column = sheet.GetColumn(0); // Get column A
foreach (var cell in column)
{
    Console.WriteLine($"Column A value: {cell.Value}");
}

El código es muy simple, limpio y claro. El rango de celdas puede ser referenciado con una sintaxis simple como se muestra en un bucle foreach: sheet["A2:A6"] y cada celda puede ser iterada para obtener su valor. Aquí verás los nombres en la columna A desde la fila 2 a la fila 6 en la salida de la consola:

Consola de depuración de Microsoft Visual Studio que muestra el resultado de la lectura de las celdas A2 a A6 de Excel, mostrando los nombres: John, Sara, Peter, Mathew y Katherine Salida de consola que demuestra la lectura exitosa de un rango de celdas de Excel (A2:A6) que contienen nombres usando C#

Para obtener más detalles sobre la lectura y escritura de valores de celda, consulte este tutorial sobre cómo leer archivos de Excel en un ejemplo de C# . También puede explorar funciones avanzadas como aplicar fórmulas o trabajar con rangos con nombre .

¿Cómo importo hojas de trabajo enteras a la vez?

WorkBook workbook = WorkBook.Load("test.xlsx");
WorkSheet sheet = workbook.WorkSheets.First();

// Traverse all rows of Excel WorkSheet
for (int i = 0; i < sheet.Rows.Count(); i++)
{
    // Traverse all columns of specific Row
    for (int j = 0; j < sheet.Columns.Count(); j++)
    {
        // Get the values
        string val = sheet.Rows[i].Columns[j].Value.ToString();
        Console.Write("{0}\t", val);
    }
    Console.WriteLine();
}

// Alternative method using LINQ for more efficient processing
var allData = sheet.Rows.SelectMany(row => 
    row.Columns.Select(col => col.Value?.ToString() ?? "")).ToList();

WorkBook workbook = WorkBook.Load("test.xlsx");
WorkSheet sheet = workbook.WorkSheets.First();

// Traverse all rows of Excel WorkSheet
for (int i = 0; i < sheet.Rows.Count(); i++)
{
    // Traverse all columns of specific Row
    for (int j = 0; j < sheet.Columns.Count(); j++)
    {
        // Get the values
        string val = sheet.Rows[i].Columns[j].Value.ToString();
        Console.Write("{0}\t", val);
    }
    Console.WriteLine();
}

// Alternative method using LINQ for more efficient processing
var allData = sheet.Rows.SelectMany(row => 
    row.Columns.Select(col => col.Value?.ToString() ?? "")).ToList();

// Convert worksheet to DataTable for easier manipulation
DataTable dataTable = sheet.ToDataTable(true); // true = first row contains headers

// Process data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

// Convert worksheet to DataTable for easier manipulation
DataTable dataTable = sheet.ToDataTable(true); // true = first row contains headers

// Process data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    foreach (var item in row.ItemArray)
    {
        Console.Write($"{item}\t");
    }
    Console.WriteLine();
}

¿Cuáles son los siguientes pasos después de importar archivos de Excel?

Este artículo demostró cómo importar y leer un archivo Excel en C# sin tener Microsoft Excel instalado. Abarcó múltiples formas de leer datos de una hoja de cálculo de Excel, desde celdas individuales hasta hojas de trabajo completas. IronXL también le ayuda a crear archivos Excel en C# sin necesidad de instalar Excel.

Después de importar con éxito los datos de Excel, es posible que desee explorar funciones adicionales:

• Procesamiento de datos : ordenar rangos de celdas , aplicar filtros o agrupar filas y columnas
• Validación de datos : Implementar reglas de validación de datos para garantizar la integridad de los datos.
• Formato : aplicar estilo de celda , formato condicional o formatos de número
• Gráficos y elementos visuales : cree gráficos o agregue imágenes para mejorar la presentación de datos
• Seguridad : proteja con contraseña libros de trabajo u hojas de trabajo individuales

IronXL proporciona una solución integral para todas las tareas relacionadas con documentos de Microsoft Excel que se implementan programáticamente. Puede realizar cálculos con fórmulas , ordenar cadenas o números, recortar y agregar, buscar y reemplazar, fusionar y separar celdas , guardar archivos y mucho más. Puede editar valores de celdas y también establecer formatos de datos de celdas junto con validar datos de hojas de cálculo. También admite archivos CSV y le ayuda a trabajar con datos de Excel sin problemas.

Para aplicaciones empresariales, considere explorar opciones de implementación para varias plataformas, incluidos contenedores Docker , Azure Functions y AWS Lambda .

IronXL está disponible para una prueba gratuita y se puede obtener una licencia para uso comercial con su paquete Lite a partir de $799 únicamente. La biblioteca ofrece excelente documentación , tutoriales y ejemplos de código para ayudarlo a comenzar rápidamente con las operaciones con archivos de Excel en sus aplicaciones C#.