Leer XLSX del Banco de España y SII con IronXL en C# (alternativa StreamReader)

¿Por qué StreamReader no puede leer archivos de Excel?

StreamReader está diseñado para archivos de texto sin formato, leyendo datos de caracteres línea por línea utilizando una codificación especificada. Los archivos Excel, a pesar de su apariencia de hoja de cálculo, son en realidad estructuras XML binarias o comprimidas en ZIP complejas que StreamReader no puede interpretar.

static void Main(string[] args)
{
    // This code will NOT work - demonstrates the problem
    using (StreamReader reader = new StreamReader("ProductData.xlsx"))
    {
        string content = reader.ReadLine(); // read data
        Console.WriteLine(content); // Outputs garbled binary data
    }
}

static void Main(string[] args)
{
    // This code will NOT work - demonstrates the problem
    using (StreamReader reader = new StreamReader("ProductData.xlsx"))
    {
        string content = reader.ReadLine(); // read data
        Console.WriteLine(content); // Outputs garbled binary data
    }
}

Option Strict On



Imports System.IO

Module Program
    Sub Main(args As String())
        ' This code will NOT work - demonstrates the problem
        Using reader As New StreamReader("ProductData.xlsx")
            Dim content As String = reader.ReadLine() ' read data
            Console.WriteLine(content) ' Outputs garbled binary data
        End Using
    End Sub
End Module

Cuando ejecutas este fragmento de código de la clase Program, en lugar de ver tus datos de la hoja de cálculo, te encontrarás con datos binarios desconocidos, como "PK♥♦" o caracteres similares del sistema. Esto sucede porque los archivos XLSX son archivos ZIP que contienen múltiples archivos XML, mientras que los archivos XLS utilizan un formato binario propietario. StreamReader espera texto sin formato e intenta interpretar estas estructuras complejas como caracteres, lo que da lugar a un resultado sin sentido.

¿Cómo leer archivos de Excel con IronXL?

IronXL ofrece una solución sencilla para leer archivos de Excel en C#. A diferencia de StreamReader, IronXL comprende la estructura interna de Excel y ofrece métodos intuitivos para acceder a tus datos. La biblioteca es compatible con Windows, Linux, macOS y contenedores Docker, lo que la hace ideal para aplicaciones modernas multiplataforma.

Primero, instala IronXL a través del Administrador de Paquetes NuGet:

Install-Package IronXL.Excel

Aquí tienes cómo leer un archivo de Excel correctamente:

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

using IronXL;
// Load the Excel file
WorkBook workbook = WorkBook.Load("sample.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;
// Read specific cell values
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");
// Read a range of cells
foreach (var cell in worksheet["A1:C5"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

Imports IronXL

' Load the Excel file
Dim workbook As WorkBook = WorkBook.Load("sample.xlsx")
Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
' Read specific cell values
Dim cellValue As String = worksheet("A1").StringValue
Console.WriteLine($"Cell A1 contains: {cellValue}")
' Read a range of cells
For Each cell In worksheet("A1:C5")
    Console.WriteLine($"{cell.AddressString}: {cell.Text}")
Next

Este código carga con éxito tu archivo de Excel y proporciona acceso limpio a los valores de las celdas. El método WorkBook.Load detecta automáticamente el formato de archivo (XLSX, XLS, XLSM, CSV) y gestiona internamente todo el análisis sintáctico complejo. Puedes acceder a las celdas usando la notación familiar de Excel como "A1" o rangos como "A1:C5", haciendo que el código sea intuitivo para cualquiera familiarizado con Excel.

¿Cómo leer Excel desde flujos de memoria?

Las aplicaciones del mundo real a menudo necesitan procesar archivos de Excel desde flujos en lugar de archivos de disco. Los escenarios comunes incluyen manejar cargas web, recuperar archivos de bases de datos o procesar datos desde almacenamiento en la nube. IronXL maneja estas situaciones elegantemente:

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

using IronXL;
using System.IO;
// Read Excel from a memory stream
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");
using (MemoryStream stream = new MemoryStream(fileBytes))
{
    WorkBook workbook = WorkBook.FromStream(stream);
    WorkSheet worksheet = workbook.DefaultWorkSheet;
    // Process the data
    int rowCount = worksheet.RowCount;
    Console.WriteLine($"The worksheet has {rowCount} rows");
    // Read all data into a new DataTable, return dt
    var dataTable = worksheet.ToDataTable(false);
    // Return DataTable row count
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");
}

Imports IronXL
Imports System.IO

' Read Excel from a memory stream
Dim fileBytes As Byte() = File.ReadAllBytes("ProductData.xlsx")
Using stream As New MemoryStream(fileBytes)
    Dim workbook As WorkBook = WorkBook.FromStream(stream)
    Dim worksheet As WorkSheet = workbook.DefaultWorkSheet
    ' Process the data
    Dim rowCount As Integer = worksheet.RowCount
    Console.WriteLine($"The worksheet has {rowCount} rows")
    ' Read all data into a new DataTable, return dt
    Dim dataTable = worksheet.ToDataTable(False)
    ' Return DataTable row count
    Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows")
End Using

El método WorkBook.FromStream acepta cualquier tipo de flujo, ya sea un MemoryStream, un FileStream o un flujo de red. Esta flexibilidad te permite procesar archivos de Excel desde varias fuentes sin guardarlos primero en el disco. El ejemplo también demuestra convertir datos de hojas de trabajo a un DataTable, lo cual se integra perfectamente con bases de datos y escenarios de vinculación de datos.

using IronXL;
using System.IO;
using System.Net.Http;

// Descargar el fichero XLSX del Banco de España directamente a memoria
using var httpClient = new HttpClient();
byte[] xlsxBytes = await httpClient.GetByteArrayAsync(
    "https://www.bde.es/f/webbde/SES/Secciones/Publicaciones/datos_estadisticos.xlsx");

using MemoryStream bdeStream = new MemoryStream(xlsxBytes);
WorkBook bdeWorkbook = WorkBook.FromStream(bdeStream);
WorkSheet bdeSheet = bdeWorkbook.DefaultWorkSheet;

Console.WriteLine($"Filas de datos BdE: {bdeSheet.RowCount}");

// Procesar y transformar datos para el sistema interno
var bdeDataTable = bdeSheet.ToDataTable(useHeaderRow: true);
// ... pipeline de transformación y carga

using IronXL;
using System.IO;
using System.Net.Http;

// Descargar el fichero XLSX del Banco de España directamente a memoria
using var httpClient = new HttpClient();
byte[] xlsxBytes = await httpClient.GetByteArrayAsync(
    "https://www.bde.es/f/webbde/SES/Secciones/Publicaciones/datos_estadisticos.xlsx");

using MemoryStream bdeStream = new MemoryStream(xlsxBytes);
WorkBook bdeWorkbook = WorkBook.FromStream(bdeStream);
WorkSheet bdeSheet = bdeWorkbook.DefaultWorkSheet;

Console.WriteLine($"Filas de datos BdE: {bdeSheet.RowCount}");

// Procesar y transformar datos para el sistema interno
var bdeDataTable = bdeSheet.ToDataTable(useHeaderRow: true);
// ... pipeline de transformación y carga

Imports IronXL
Imports System.IO
Imports System.Net.Http

' Descargar el fichero XLSX del Banco de España directamente a memoria
Dim httpClient As New HttpClient()
Dim xlsxBytes As Byte() = Await httpClient.GetByteArrayAsync("https://www.bde.es/f/webbde/SES/Secciones/Publicaciones/datos_estadisticos.xlsx")

Using bdeStream As New MemoryStream(xlsxBytes)
    Dim bdeWorkbook As WorkBook = WorkBook.FromStream(bdeStream)
    Dim bdeSheet As WorkSheet = bdeWorkbook.DefaultWorkSheet

    Console.WriteLine($"Filas de datos BdE: {bdeSheet.RowCount}")

    ' Procesar y transformar datos para el sistema interno
    Dim bdeDataTable = bdeSheet.ToDataTable(useHeaderRow:=True)
    ' ... pipeline de transformación y carga
End Using

¿Cómo convertir entre Excel y CSV?

Aunque StreamReader puede gestionar archivos CSV, a menudo es necesario convertir entre los formatos Excel y CSV. IronXL hace que esta conversión sea sencilla:

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

using IronXL;
// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("data.xlsx");
workbook.SaveAsCsv("output.csv");
// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("input.csv");
csvWorkbook.SaveAs("output.xlsx");
// Export specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("worksheet1.csv");

Imports IronXL

' Load an Excel file and save as CSV
Dim workbook As WorkBook = WorkBook.Load("data.xlsx")
workbook.SaveAsCsv("output.csv")

' Load a CSV file and save as Excel
Dim csvWorkbook As WorkBook = WorkBook.LoadCSV("input.csv")
csvWorkbook.SaveAs("output.xlsx")

' Export specific worksheet to CSV
Dim worksheet As WorkSheet = workbook.WorkSheets(0)
worksheet.SaveAsCsv("worksheet1.csv")

Estas conversiones preservan tus datos mientras cambian el formato de archivo. Al convertir Excel a CSV, IronXL aplana la primera hoja de trabajo por defecto, pero puedes especificar qué hoja de trabajo exportar. Convertir de CSV a Excel crea una hoja de cálculo correctamente formateada que preserva los tipos de datos y permite futuras adiciones de formato y fórmulas.

Conclusión

La incapacidad de StreamReader para procesar archivos de Excel se debe a la diferencia fundamental entre el texto sin formato y la compleja estructura de archivos de Excel. Aunque StreamReader funciona perfectamente con CSV y otros formatos de texto, los archivos Excel auténticos requieren una biblioteca especializada como IronXL que comprenda las estructuras binarias y XML que contienen.

IronXL proporciona una solución elegante con su API intuitiva, soporte completo de formatos y capacidades de procesamiento de flujos sin problemas. Ya sea que estés construyendo aplicaciones web, software de escritorio o servicios en la nube, IronXL maneja los archivos de Excel de manera confiable en todas las plataformas.

Para los equipos de desarrollo que trabajan en España con ficheros regulatorios del Banco de España, la CNMV, la AEAT o los sistemas SII y TicketBAI, IronXL ofrece la solución más directa para la ingesta de XLSX mediante streaming sin instalación de Microsoft Office. La compatibilidad con la LOPDGDD se facilita al no requerir persistencia de datos en disco durante el procesamiento de streaming, y la solidez de la biblioteca ante ficheros XLSX de gran tamaño la hace adecuada para los volúmenes de datos habituales en los informes regulatorios españoles.

¿Listo para empezar a trabajar con archivos de Excel correctamente? Descargue la versión de prueba gratuita de IronXL y experimente el procesamiento de Excel sin complicaciones en sus aplicaciones de C#. Para implementaciones de producción, considere las opciones de licencia de IronXL que mejor se adapten a las necesidades de su proyecto.