CoreExcelPackage 2025.7.13

ExecutionEngine.Excel

Una biblioteca moderna y eficiente para el manejo de archivos Excel (.xls y .xlsx) en aplicaciones .NET, diseñada para ofrecer un rendimiento óptimo y una API intuitiva tanto para operaciones síncronas como asíncronas.

Características Principales

• Soporte multiplataforma: Compatible con .NET Standard 2.0+ y .NET 6.0+
• Rendimiento optimizado: Lectura y escritura eficiente de archivos Excel
• Soporte asíncrono: Todas las operaciones principales tienen versiones asíncronas
• Tipado fuerte: Conversión automática a tipos fuertemente tipados
• Soporte para:
  • Formatos .xls y .xlsx
  • Múltiples hojas de cálculo
  • Operaciones con DataTable
  • Streams para procesamiento sin almacenamiento en disco
  • Inyección de dependencias

Instalación

Instala el paquete NuGet en tu proyecto:

dotnet add package ExecutionEngine.Excel

O a través del Administrador de paquetes NuGet en Visual Studio:

Install-Package ExecutionEngine.Excel

Uso Básico

Configuración de Inyección de Dependencias

// En tu Startup.cs o configuración de servicios
services.AddExcelPackage();

Ejemplos de Código

Lectura de datos

using ExecutionEngine.Excel.Implementations;

// Crear una instancia
var excelPackage = new ExcelPackage();

// Cargar archivo
await excelPackage.SetDatabaseLogonAsync("ruta/al/archivo.xlsx");

// Obtener nombres de hojas
var sheetNames = excelPackage.GetSheetNames();

// Leer datos como DataTable
var dataTable = await excelPackage.GetTableAsync("Hoja1");

// Leer datos como lista fuertemente tipada
var items = await excelPackage.GetItemsAsync<MiModelo>("Hoja1");

// Liberar recursos
excelPackage.Dispose();

Escritura de datos

using var excelPackage = new ExcelPackage();

// Crear una nueva hoja con datos
var data = new List<MiModelo> 
{ 
    new MiModelo { Id = 1, Nombre = "Ejemplo" } 
};

await excelPackage.CreateSheetAsync("MiHoja", data);

// Guardar a archivo
await excelPackage.SaveAsAsync("ruta/guardado.xlsx");

Uso con Streams

using var stream = new MemoryStream();
using var excelPackage = new ExcelPackage();

// Cargar desde stream
await excelPackage.SetDatabaseLogonAsync(stream);

// Procesar datos...

// Guardar a otro stream
using var outputStream = new MemoryStream();
await excelPackage.SaveAsAsync(outputStream);

Modelado de Datos

Puedes mapear tus clases a las hojas de Excel usando atributos:

public class Producto
{
    [ExcelColumn("ID", 1)]
    public int Id { get; set; }
    
    [ExcelColumn("NOMBRE", 2)]
    public string Nombre { get; set; }
    
    [ExcelColumn("PRECIO", 3, Format = "C2")]
    public decimal Precio { get; set; }
    
    [ExcelColumn("FECHA_REGISTRO", 4, Format = "dd/MM/yyyy")]
    public DateTime FechaRegistro { get; set; }
}

Manejo de Errores

Todas las operaciones lanzan excepciones específicas que puedes capturar:

try
{
    await excelPackage.SetDatabaseLogonAsync("archivo_inexistente.xlsx");
}
catch (ExcelFileNotFoundException ex)
{
    Console.WriteLine($"Error: {ex.Message}");
}
catch (ExcelException ex)
{
    Console.WriteLine($"Error de Excel: {ex.Message}");
}

Rendimiento

Para archivos grandes, se recomienda:

1. Usar los métodos asíncronos
2. Procesar los datos en lotes
3. Utilizar streams en lugar de operaciones de archivo directas
4. Liberar recursos con using o llamando a Dispose()

Contribución

Las contribuciones son bienvenidas. Por favor, lee las pautas de contribución antes de enviar un pull request.

Licencia

Este proyecto está licenciado bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.