Instalación

El paquete se puede instalar usando NuGet:

dotnet add package DotNet.ExporterToolkit

También está disponible en el Visual Studio Package Manager:

Install-Package DotNet.ExporterToolkit

Requisitos

• .NET Core 3.1 o superior
• Visual Studio 2019 o superior

Uso Básico

Exportación a CSV

var data = new List<MyClass> {
    new MyClass { Id = 1, Name = "John", CreatedDate = DateTime.Now },
    new MyClass { Id = 2, Name = "Jane", CreatedDate = DateTime.Now }
};

data.ExportToCsv("archivo.csv");

Exportación a Excel

data.ExportToExcel("archivo.txt", includeHeaders: true);

Exportación a JSON

data.ExportToJson("archivo.json");

Exportación a XML

data.ExportToXml("archivo.xml");

Configuración Avanzada

Formateo Personalizado

// Formateo de fechas personalizado
var data = new List<MyClass> {
    new MyClass { Id = 1, Name = "John", CreatedDate = DateTime.Now }
};

data.ExportToCsv("archivo.csv", includeHeaders: true)
    .WithDateFormat("dd/MM/yyyy HH:mm:ss")
    .WithNumberFormat("N2");

Manejo de Errores

try
{
    data.ExportToCsv("archivo.csv");
}
catch (ExportException ex)
{
    // Manejo de errores específicos
    ExtensionsLogger.LogError(ex, "Error durante la exportación");
}

Mejores Prácticas

1. Seguridad de Datos

   • Validar datos antes de exportar
   • Escapar caracteres especiales
   • Manejar nulls correctamente
   • Usar formateo consistente

2. Rendimiento

   • Usar exportación asíncrona para grandes volúmenes
   • Implementar buffering cuando sea necesario
   • Manejar memoria eficientemente
   • Usar paginación para conjuntos de datos grandes

3. Logging

   • Registrar inicio y fin de exportación
   • Registrar errores específicos
   • Registrar estadísticas de exportación
   • Implementar logging configurable

4. Manejo de Archivos

   • Validar permisos de escritura
   • Manejar archivos temporales
   • Limpiar recursos correctamente
   • Usar rutas seguras

Ejemplos Avanzados

Exportación Asíncrona

await data.ExportToCsvAsync("archivo.csv");

Exportación con Filtrado

var filteredData = data.Where(x => x.IsActive)
    .ExportToCsv("archivo_filtrado.csv");

Exportación con Transformación

var transformedData = data.Select(x => new {
    x.Id,
    x.Name,
    FormattedDate = x.CreatedDate.ToString("dd/MM/yyyy")
});

transformedData.ExportToCsv("archivo_transformado.csv");

Soporte y Contribución

Para reportar errores o solicitar características, por favor abre un issue en el repositorio de GitHub.

Licencia

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