Cómo abrir archivos de Excel en C#

¿Cuáles son las características principales de IronXL?

• Abra, lea y busque datos en formatos XLS/XLSX/CSV/TSV utilizando LoadSpreadsheets .
• Exporte hojas de cálculo de Excel a múltiples formatos con Guardar y exportar .
• Cifrar y descifrar archivos con contraseñas utilizando funciones seguras .
• Trabaje con hojas de Excel como objetos DataSet y DataTable a través de la integración de DataSet .
• Las fórmulas de Excel se recalculan automáticamente y admiten funciones matemáticas .
• Edite datos de hojas de cálculo con una sintaxis de rango intuitiva como WorkSheet["A1:B10"] .
• Ordenar rangos de celdas , columnas y filas .
• Estilo de celdas con formatos de fuente , fondo , borde , alineación y número .

¿Qué necesito antes de empezar?

Para usar IronXL en aplicaciones C#, instala los siguientes componentes en tu computadora local:

1. Visual Studio : el IDE oficial para desarrollar aplicaciones C# .NET. Puedes descargar e instalar Visual Studio desde el sitio web de Microsoft. También puedes utilizar JetBrains ReSharper y Rider . Para obtener orientación adicional sobre la configuración, consulte la Descripción general de primeros pasos .
2. IronXL : la biblioteca de Excel que ayuda a trabajar con hojas de Excel en C#. Debe instalarse en su aplicación C# antes de usarla. Puede descargarlo desde el sitio web de NuGet o desde Administrar paquetes NuGet en Visual Studio. También puedes descargar directamente el archivo .NET Excel DLL. Para la implementación de la licencia, consulte Uso de claves de licencia .

¿Qué espacios de nombres debo importar?

Una vez que Visual Studio e IronXL estén instalados, agrega los espacios de nombres necesarios de IronXL incluyendo la siguiente línea en la parte superior de tu archivo C#:

// Add reference to the IronXL library
using IronXL;

// Add reference to the IronXL library
using IronXL;

Para trabajar con formatos específicos de Excel o funciones avanzadas, es posible que también necesite:

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

using IronXL.Formatting;  // For cell styling
using IronXL.Drawing;     // For images and charts
using System.Data;        // For DataSet/DataTable operations

¿Cómo cargo un archivo Excel existente?

Los archivos de Excel, también conocidos como libros de trabajo, consisten en múltiples hojas de trabajo, cada una con valores de celda. Para abrir y leer un archivo Excel , cárguelo utilizando el método Load de la clase WorkBook . La funcionalidad LoadSpreadsheets admite varios formatos.

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

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

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

// You can also load from streams for web applications
// using (var stream = File.OpenRead("test.xlsx"))
// {
//     WorkBook workbook = WorkBook.Load(stream);
// }

Esto inicializa el libro de trabajo como una instancia de WorkBook. Para abrir una WorkSheet específica, recupérela de la colección WorkSheets . La guía Administrar hojas de trabajo proporciona más detalles sobre las operaciones de las hojas de trabajo:

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

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

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

// Alternative ways to access worksheets
WorkSheet sheetByIndex = workbook.WorkSheets[0];  // By index
WorkSheet sheetByName = workbook.GetWorkSheet("Sheet1");  // By name

Esto accede a la primera hoja en el archivo de Excel, lista para lectura y escritura.

Hoja de cálculo de Excel que muestra los datos de los empleados con columnas para Nombre, Cargo y Salario de 5 empleados, con encabezados y bordes de celda formateados. Archivo de Excel

¿Cómo leo datos de las celdas de Excel?

Una vez abierto el archivo Excel, está listo para leer datos. Leer datos de archivos de Excel en C# usando IronXL es sencillo. Puede leer valores de celda especificando la referencia de celda mediante la funcionalidad Seleccionar rango .

El siguiente código recupera el valor de una celda:

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

// Select the cell using Excel notation and retrieve its integer value
int cellValue = sheet["C2"].IntValue;

// You can also retrieve values in different formats
string textValue = sheet["C2"].StringValue;
decimal decimalValue = sheet["C2"].DecimalValue;
DateTime dateValue = sheet["C2"].DateTimeValue;
bool boolValue = sheet["C2"].BoolValue;

// Display the value in the console
Console.WriteLine($"Cell C2 contains: {cellValue}");

// Check if cell is empty before reading
if (!sheet["C2"].IsEmpty)
{
    Console.WriteLine($"Cell value: {sheet["C2"].Value}");
}

El resultado es el siguiente:

Ventana de la consola de depuración de Microsoft Visual Studio que muestra la extracción exitosa del valor '100000' de la celda C2 de Excel con un mensaje de salida contextual. Leer Excel

Para leer datos de un rango de celdas, utilice un bucle para iterar a través del rango especificado. El ejemplo Seleccionar rango de Excel proporciona más patrones:

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

// Iterate through a range of cells and display their address and text content
foreach (var cell in sheet["A2:A6"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Read an entire column
foreach (var cell in sheet.GetColumn(0))  // Column A
{
    if (!cell.IsEmpty)
    {
        Console.WriteLine($"Column A value: {cell.Text}");
    }
}

// Read an entire row
foreach (var cell in sheet.GetRow(1))  // Row 2
{
    Console.WriteLine($"Row 2 value: {cell.Text}");
}

Cada valor en el rango de celdas A2:A6 se accede y se imprime en la consola.

Consola de depuración de Microsoft Visual Studio con resaltado de sintaxis que muestra el resultado de la lectura del rango de Excel A2:A6 y los nombres de los empleados John, Sara, Peter, Method y Katherine. Leer rango de celdas

Para obtener ejemplos de lectura y escritura más detallados, consulte el tutorial de lectura de Excel en C# . También puede convertir datos de Excel a DataTables para una manipulación más sencilla:

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

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

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

// Access data using DataTable methods
foreach (DataRow row in dataTable.Rows)
{
    Console.WriteLine($"Employee: {row["Name"]}, Salary: {row["Salary"]}");
}

¿Cómo puedo crear un nuevo archivo de Excel?

IronXL también facilita la creación de nuevos libros de trabajo para guardar y recuperar datos. La guía Crear hojas de cálculo proporciona ejemplos completos.

Puedes crear un nuevo archivo de Excel con una sola línea de código:

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

// Create a new workbook with the XLSX format
WorkBook workBook = new WorkBook(ExcelFileFormat.XLSX);

// Alternative: Create with XLS format for compatibility
WorkBook xlsWorkBook = new WorkBook(ExcelFileFormat.XLS);

// Set workbook metadata
workBook.Metadata.Title = "Employee Data";
workBook.Metadata.Author = "Your Name";
workBook.Metadata.Keywords = "employees, salary, data";

A continuación, crea una hoja de trabajo y añade datos a ella. Para obtener patrones de creación más avanzados, consulte Crear un nuevo archivo de Excel .

¿Cómo agrego hojas de trabajo a un libro de trabajo?

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

// Create a worksheet named "GDPByCountry" in the workbook
WorkSheet workSheet = workBook.CreateWorkSheet("GDPByCountry");

// Create multiple worksheets at once
WorkSheet sheet2 = workBook.CreateWorkSheet("PopulationData");
WorkSheet sheet3 = workBook.CreateWorkSheet("Summary");

// Copy an existing worksheet
WorkSheet copiedSheet = workSheet.CopySheet("GDPByCountryCopy");

Este código añade una hoja de trabajo llamada "GDPByCountry" al libro de trabajo, permitiéndote añadir valores a celdas. Obtenga más información sobre cómo administrar hojas de trabajo y copiar hojas de trabajo .

Para establecer un valor para una celda específica, utiliza el siguiente código:

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

// Set the value of cell A1 to "Example"
workSheet["A1"].Value = "Example";

// Add different types of data
workSheet["A2"].Value = 12345;  // Integer
workSheet["A3"].Value = 99.99m;  // Decimal
workSheet["A4"].Value = DateTime.Now;  // Date
workSheet["A5"].Value = true;  // Boolean

// Add formulas
workSheet["B1"].Formula = "=SUM(A2:A3)";

// Set multiple cells at once using a range
workSheet["C1:C5"].Value = "Bulk Value";

// Save the workbook
workBook.SaveAs("output.xlsx");

El resultado final es:

Hoja de cálculo de Excel que muestra la celda A1 rellena con el texto "Ejemplo" agregado programáticamente con C#, con la pestaña GDPByCountry visible y la celda resaltada para mostrar el valor agregado. Añadir Valor a la Celda

Trabajar con diferentes formatos de Excel

IronXL admite múltiples formatos de Excel. A continuación se explica cómo manejar diferentes tipos de archivos:

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

// Convert between formats
WorkBook workbook = WorkBook.Load("data.csv");
workbook.SaveAs("data.xlsx");  // Convert CSV to XLSX

// Export to different formats
workbook.SaveAsCsv("output.csv", ";");  // CSV with semicolon delimiter
workbook.SaveAsJson("output.json");     // Export as JSON
workbook.SaveAsXml("output.xml");       // Export as XML

Obtenga más información sobre la conversión de tipos de archivos de hojas de cálculo y la conversión de XLSX a CSV, JSON, XML .

Manejo de errores y buenas prácticas

Al trabajar con archivos de Excel, implemente un manejo de errores adecuado:

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

try
{
    WorkBook workbook = WorkBook.Load("test.xlsx");
    WorkSheet sheet = workbook.GetWorkSheet("Sheet1");

    // Check if sheet exists
    if (sheet == null)
    {
        Console.WriteLine("Worksheet not found!");
        return;
    }

    // Process data
    var value = sheet["A1"].Value;
}
catch (Exception ex)
{
    Console.WriteLine($"Error reading Excel file: {ex.Message}");
}

Para aplicaciones de producción, considere configurar el registro e implementar patrones adecuados de manejo de errores .