Ícono de mensaje
Saltar al pie de página
  1. Iron Software
  2. Blog de IronXL
  3. Usando IronXL
  4. Leer el blog de Excel Streamreader
USANDO IRONXL

Cómo leer archivos de Excel en C# en lugar de usar StreamReader

Jordi Bardia
Jordi Bardia
Actualizado:

Muchos desarrolladores de C# encuentran un desafío frustrante al trabajar con archivos Excel: la clase StreamReader, que maneja archivos de texto de manera confiable, falla completamente cuando se usa en un documento de Excel. Si has intentado leer un archivo Excel usando StreamReader en C# solo para ver caracteres distorsionados, ruido binario o excepciones inesperadas, no estás solo. Esta guía explica exactamente por qué StreamReader no puede manejar archivos Excel y te muestra cómo resolver el problema correctamente usando IronXL, una biblioteca de Excel dedicada for .NET que no requiere instalación de Excel.

La confusión a menudo surge porque los archivos CSV, que Excel puede abrir y guardar, funcionan bien con StreamReader. Los archivos Excel verdaderos (XLSX, XLS, XLSM) requieren un enfoque fundamentalmente diferente. Entender esta distinción te ahorrará horas de depuración y te dirigirá a la herramienta adecuada para el trabajo.

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 1 - IronXL

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

StreamReader es un lector basado en texto. Lee datos de caracteres línea por línea usando una codificación especificada (UTF-8, ASCII, etc.) y no es consciente de estructuras binarias o archivos comprimidos. La documentación oficial de .NET StreamReader confirma que esta clase está diseñada exclusivamente para texto codificado en caracteres. Los archivos Excel, a pesar de parecer hojas de cálculo simples, son en realidad estructuras binarias complejas o XML comprimidas en ZIP que StreamReader no puede interpretar.

Cuando abres un archivo XLSX con StreamReader, estás esencialmente tratando de leer un archivo ZIP como texto plano. El resultado es una secuencia de ruido binario en lugar de tus datos de hoja de cálculo.

// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"
// This code will NOT work -- demonstrates the problem
using StreamReader reader = new StreamReader("ProductData.xlsx");
string content = reader.ReadLine();
Console.WriteLine(content); // Outputs garbled binary data like "PK♥♦"
$vbLabelText   $csharpLabel

Cuando ejecutas este fragmento, en lugar de ver las filas de tu hoja de cálculo, te encuentras con caracteres binarios como PK♥♦ o ruido similar. Esto sucede porque:

  • Los archivos XLSX son archivos ZIP que contienen múltiples archivos XML: hojas de trabajo, estilos, cadenas compartidas, relaciones. La documentación de Open XML SDK proporciona un desglose detallado de esta estructura.
  • Los archivos XLS utilizan un formato binario propietario (BIFF - Formato de Intercambio de Archivos Binarios)
  • StreamReader aplica una codificación de caracteres a cualquier byte que lee, produciendo resultados sin sentido para ambos formatos

Entrada de muestra

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 2 - Entrada de Excel

Salida Distorsionada al Usar StreamReader

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 3 - Salida de Consola

Por qué CSV Funciona Pero XLSX No

CSV (Valores Separados por Comas) es un formato de texto plano. Cada fila es una línea de texto, y cada columna está separada por una coma. StreamReader lee archivos CSV sin problema porque no contienen datos binarios ni archivos comprimidos. XLSX es fundamentalmente diferente: empaqueta múltiples documentos XML dentro de un contenedor ZIP con metadatos, temas y definiciones de estilo. No es posible una lectura simple línea por línea.

Esta distinción es importante al elegir tus herramientas. Para archivos CSV, StreamReader o File.ReadAllLines son perfectamente adecuados. Para libros de Excel reales, necesitas una biblioteca que entienda el formato a nivel estructural.

¿Cómo instalar IronXL en un proyecto .NET ?

IronXL es una biblioteca .NET que lee, escribe y crea archivos Excel sin requerir que Microsoft Excel esté instalado. Admite los formatos XLSX, XLS, XLSM, CSV y TSV, y funciona en Windows, Linux, macOS y contenedores Docker.

Para instalar IronXL, usa ya sea la Consola del Administrador de Paquetes NuGet o la CLI de .NET. El paquete está publicado en NuGet.org como IronXL:

Install-Package IronXL
dotnet add package IronXL
Install-Package IronXL
dotnet add package IronXL
SHELL

Después de la instalación, añade la directiva using IronXL; a tu archivo y estarás listo para trabajar con documentos Excel.

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 5 - Instalación

Para pasos de instalación detallados y opciones de configuración de NuGet, consulta la guía de instalación NuGet de IronXL. Una licencia de prueba gratuita está disponible para que puedas evaluar IronXL en tu proyecto antes de comprar.

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 4 - Plataforma Cruzada

¿Cómo Lees Archivos Excel con IronXL?

IronXL proporciona una API intuitiva para leer archivos Excel en C#. A diferencia de StreamReader, IronXL entiende la estructura interna de Excel y te da acceso limpio a filas, columnas y valores de celdas. La documentación de IronXL proporciona referencias completas de la API para todas las operaciones admitidas.

Aquí tienes cómo leer un archivo Excel usando IronXL con declaraciones de nivel superior:

using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");
using IronXL;

// Load the Excel file from disk
WorkBook workbook = WorkBook.Load("ProductData.xlsx");
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Read a specific cell by address
string cellValue = worksheet["A1"].StringValue;
Console.WriteLine($"Cell A1 contains: {cellValue}");

// Iterate over a range of cells
foreach (var cell in worksheet["A1:C10"])
{
    Console.WriteLine($"{cell.AddressString}: {cell.Text}");
}

// Read a numeric value
decimal price = worksheet["B2"].DecimalValue;
Console.WriteLine($"Price: {price:C}");
$vbLabelText   $csharpLabel

El método WorkBook.Load detecta automáticamente el formato de archivo (XLSX, XLS, XLSM, CSV) y maneja todo el análisis complejo. Accedes a las celdas usando la notación estándar de Excel como "A1" o rangos como "A1:C10", lo que hace que el código sea inmediatamente legible para cualquier persona familiarizada con las hojas de cálculo.

Accediendo a Múltiples Hojas de Trabajo

Muchos libros contienen más de una hoja. IronXL te permite abrir y navegar por libros con enumeración completa de hojas de trabajo:

using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");
using IronXL;

WorkBook workbook = WorkBook.Load("MultiSheet.xlsx");

// List all worksheets
foreach (WorkSheet sheet in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {sheet.Name}, Rows: {sheet.RowCount}");
}

// Access a sheet by name
WorkSheet summary = workbook.GetWorkSheet("Summary");
string totalRevenue = summary["B20"].StringValue;
Console.WriteLine($"Total Revenue: {totalRevenue}");

// Access a sheet by index
WorkSheet firstSheet = workbook.WorkSheets[0];
int lastRow = firstSheet.RowCount;
Console.WriteLine($"Last row in first sheet: {lastRow}");
$vbLabelText   $csharpLabel

Este enfoque es mucho más limpio que cualquier intento de analizar Excel con StreamReader o manipulación de cadenas.

¿Cómo Lees Datos Excel desde un Flujo 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 de archivos desde formularios web, recuperar libros de una columna BLOB de base de datos o procesar archivos descargados desde almacenamiento en la nube (Azure Blob Storage, AWS S3). IronXL maneja estos escenarios mediante WorkBook.FromStream:

using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}
using IronXL;
using System.IO;

// Simulate reading file bytes (e.g., from a database or web upload)
byte[] fileBytes = File.ReadAllBytes("ProductData.xlsx");

using MemoryStream stream = new MemoryStream(fileBytes);
WorkBook workbook = WorkBook.FromStream(stream);
WorkSheet worksheet = workbook.DefaultWorkSheet;

// Get row and column counts
Console.WriteLine($"Rows: {worksheet.RowCount}, Columns: {worksheet.ColumnCount}");

// Convert to DataTable for database or grid binding
var dataTable = worksheet.ToDataTable(useHeaderRow: true);
Console.WriteLine($"Loaded {dataTable.Rows.Count} data rows");

foreach (System.Data.DataRow row in dataTable.Rows)
{
    string productName = row["ProductName"]?.ToString() ?? string.Empty;
    string sku = row["SKU"]?.ToString() ?? string.Empty;
    Console.WriteLine($"Product: {productName}, SKU: {sku}");
}
$vbLabelText   $csharpLabel

WorkBook.FromStream acepta cualquier Stream -- MemoryStream, FileStream, o un flujo de red. Esta flexibilidad significa que nunca tendrás que escribir archivos temporales en el disco solo para leer datos Excel. La conversión a DataTable también se integra directamente con SqlBulkCopy, controles de enlace de datos y marcos de informes.

Salida del Procesamiento de Flujo

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 6 - Leer Excel desde MemoriaStream Salida

¿Cuándo Usas la Lectura de Excel Basada en Eventos?

En arquitecturas dirigidas por eventos, por ejemplo, un botón de carga de archivos en Windows Forms o una acción de controlador ASP.NET, la firma del método a menudo incluye parámetros object sender y EventArgs e. La lógica de procesamiento de Excel sigue usando la misma API de IronXL, pero se llama desde dentro del controlador de eventos en lugar de una declaración de nivel superior. IronXL se integra limpiamente en cualquier flujo de trabajo orientado a eventos o asíncrono porque no tiene dependencia de un hilo de interfaz de usuario.

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 7 - Características

¿Cómo Conviertes Entre Formatos Excel y CSV?

Si bien StreamReader puede manejar archivos CSV, las aplicaciones de producción a menudo necesitan mover datos entre Excel y CSV. IronXL hace que la conversión de formatos sea sencilla. Puedes exportar datos Excel a CSV o importar datos CSV a un libro de trabajo en solo unas pocas líneas:

using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");
using IronXL;

// Load an Excel file and save as CSV
WorkBook workbook = WorkBook.Load("SalesData.xlsx");
workbook.SaveAsCsv("output.csv");

// Load a CSV file and save as Excel
WorkBook csvWorkbook = WorkBook.LoadCSV("legacy-report.csv");
csvWorkbook.SaveAs("converted.xlsx");

// Export a specific worksheet to CSV
WorkSheet worksheet = workbook.WorkSheets[0];
worksheet.SaveAsCsv("sheet1-export.csv");
$vbLabelText   $csharpLabel

Estas conversiones preservan tus datos mientras cambian el formato del contenedor. Al convertir Excel a CSV, IronXL exporta la primera hoja de trabajo por defecto; puedes especificar cualquier hoja que elijas. Convertir CSV a Excel crea un libro de trabajo correctamente estructurado al que luego puedes dar formato, añadir fórmulas y escribir datos adicionales.

¿Cuáles Son las Diferencias de Soporte de Formatos?

Comparación de StreamReader e IronXL para leer diferentes formatos de archivo
Formato de Archivo StreamReader IronXL Notas
CSV (.csv) Sí Sí Texto plano; StreamReader funciona bien
XLSX (.xlsx) No Sí XML comprimido en ZIP; requiere biblioteca
XLS (.xls) No Sí Formato binario BIFF; requiere biblioteca
XLSM (.xlsm) No Sí Libro de trabajo habilitado para macros
TSV (.tsv) Sí Sí Texto plano separado por tabulaciones

¿Cómo Creas y Formateas Archivos Excel con IronXL?

Leer datos Excel es solo parte del flujo de trabajo. Muchas aplicaciones también necesitan crear nuevos archivos Excel y aplicar formatos. IronXL soporta formateo de celdas incluyendo fuentes, colores, bordes, formatos numéricos y unión de celdas:

using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");
using IronXL;

// Create a new workbook and worksheet
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("Report");

// Write headers with formatting
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Units Sold";
sheet["C1"].Value = "Revenue";

// Apply bold formatting to header row
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.SetBackgroundColor("#4472C4");
sheet["A1:C1"].Style.Font.Color = "#FFFFFF";

// Write data rows
string[] products = { "Widget A", "Widget B", "Widget C" };
int[] units = { 120, 85, 210 };
decimal[] revenues = { 2400.00m, 1700.00m, 4200.00m };

for (int i = 0; i < products.Length; i++)
{
    sheet[$"A{i + 2}"].Value = products[i];
    sheet[$"B{i + 2}"].Value = units[i];
    sheet[$"C{i + 2}"].Value = revenues[i];
    sheet[$"C{i + 2}"].FormatString = "$#,##0.00";
}

// Save the workbook
workbook.SaveAs("FormattedReport.xlsx");
Console.WriteLine("Report created successfully.");
$vbLabelText   $csharpLabel

Esta capacidad de leer libros de trabajo existentes y crear nuevos archivos formateados hace de IronXL una solución completa de Excel para aplicaciones .NET. Revisa la página de características de IronXL para un desglose detallado de las operaciones soportadas.

Exportación de Datos a Otros Formatos

IronXL también soporta la exportación de datos de libro de trabajo a objetos DataSet, lo cual es particularmente útil al cargar múltiples hojas de trabajo en memoria para cálculos entre hojas o operaciones de inserción masiva en bases de datos. El método ToDataSet devuelve un DataSet donde cada hoja de trabajo se convierte en un DataTable.

Alternativa para Leer Archivo Excel Usando StreamReader en C# - IronXL: Imagen 8 - Licenciamiento

¿Cómo Licencias e Implementas IronXL en Producción?

IronXL es gratuito para desarrollo y pruebas. Para aplicaciones de producción, se requiere una licencia. Puedes explorar opciones de licenciamiento de IronXL en la página del producto, que cubre los niveles de Desarrollador, Equipo y Organización, dependiendo de tus requisitos de implementación.

Después de comprar, aplica tu clave de licencia en el código antes de cualquier llamada de IronXL:

IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";
IronXl.License.LicenseKey = "YOUR-LICENSE-KEY-HERE";
$vbLabelText   $csharpLabel

Alternativamente, configura la variable de entorno IRONXL_LICENSE_KEY en tu entorno de implementación y IronXL la recogerá automáticamente. Este es el enfoque preferido para implementaciones en contenedores (Docker, Kubernetes) y entornos en la nube donde no es aceptable codificar claves de forma rígida.

Para fines de evaluación, una licencia de prueba gratuita proporciona funcionalidad completa para que puedas validar IronXL contra tus cargas de trabajo específicas antes de comprometerte a una compra. La prueba está disponible sin tarjeta de crédito y se activa de inmediato.

Comparado con alternativas como Microsoft.Office.Interop.Excel, IronXL tiene varias ventajas de implementación:

  • No se requiere que Microsoft Excel esté instalado en el servidor
  • Compatible con Linux y Docker, crítico para aplicaciones nativas de la nube
  • Sin gestión del ciclo de vida de objetos COM ni problemas de subprocesos de apartamento
  • Inicio más rápido y menor uso de memoria en contextos de servidor
  • Comportamiento consistente en todas las plataformas soportadas

Estas cualidades hacen de IronXL una opción práctica para cualquier aplicación .NET que necesite procesar archivos Excel en producción, ya sea en las instalaciones o en la nube.

Preguntas Frecuentes

¿Por qué StreamReader no puede manejar archivos Excel directamente?

StreamReader está diseñado para leer archivos de texto y no puede analizar los formatos de datos binarios o de estructura compleja que se utilizan en los archivos de Excel. Esta limitación provoca caracteres ilegibles o excepciones al intentar leer archivos de Excel directamente con StreamReader.

¿Cuál es la solución recomendada para leer archivos Excel en C#?

La solución recomendada es usar IronXL, una potente biblioteca que permite leer, editar y crear archivos de Excel en C# sin necesidad de interoperabilidad con Excel. IronXL gestiona la compleja estructura de los archivos de Excel de forma eficiente.

¿Qué ventajas ofrece IronXL sobre Excel Interop?

IronXL ofrece varias ventajas sobre Excel Interop, incluido un mejor rendimiento, no depende de que Excel esté instalado en el servidor o en la máquina cliente, una implementación más sencilla y la capacidad de trabajar con archivos de Excel en entornos web y en la nube.

¿ IronXL es capaz de manejar formatos de archivos .xls y .xlsx?

Sí, IronXL es capaz de manejar formatos de archivos Excel .xls y .xlsx, lo que proporciona flexibilidad a los desarrolladores que trabajan con diferentes tipos de documentos Excel.

¿Puede IronXL ser utilizado en aplicaciones web?

Sí, IronXL está diseñado para ser utilizado en varios tipos de aplicaciones, incluidas las aplicaciones web, gracias a su naturaleza liviana y compatibilidad con .NET Core y .NET Framework.

¿ IronXL requiere que esté instalado Microsoft Excel?

No, IronXL no requiere que Microsoft Excel esté instalado en el servidor o en la máquina cliente, lo que lo hace ideal para aplicaciones del lado del servidor y entornos de nube.

¿Cuáles son algunos casos de uso típicos de IronXL?

Los casos de uso típicos de IronXL incluyen la extracción y el análisis de datos de archivos de Excel, la generación de informes, la automatización de la creación y modificación de archivos de Excel y la integración de datos de Excel en otras aplicaciones.

Jordi Bardia
Jordi Bardia
  Chatea con el equipo de ingeniería ahora
Ingeniero de Software
Jordi es más competente en Python, C# y C++. Cuando no está aprovechando sus habilidades en Iron Software, está programando juegos. Compartiendo responsabilidades para pruebas de productos, desarrollo de productos e investigación, Jordi agrega un valor inmenso a la mejora continua del producto. La experiencia variada lo mantiene ...
Leer más

Artículos Relacionados

Prueba de 30 días → Producto completo. Sin límites. Sin tarjeta. Prueba gratis

Iron Support Team

We're online 24 hours, 5 days a week.
Chat
Email
Call Me