ExcelDataReader escribe archivos de Excel: Por qué no puede y cómo IronXL resuelve esto

¿Puede ExcelDataReader escribir datos del libro de Excel?

No. ExcelDataReader es una biblioteca de solo lectura por diseño, y esa limitación es intencionada. El repositorio oficial de ExcelDataReader en GitHub describe el proyecto explícitamente como "una biblioteca para leer archivos de Microsoft Excel": no hay ninguna API de escritura, ningún método de guardado ni ningún setter de valores de celda en ninguna parte de la interfaz pública. Puede comprobarlo usted mismo visitando la página del paquete NuGet de ExcelDataReader, donde la descripción del paquete refuerza el ámbito de solo lectura.

ExcelDataReader admite los formatos XLS, XLSX y CSV para la lectura, y realiza esa tarea de manera eficiente. La biblioteca expone un patrón de lector de flujo continuo y de avance único similar a IDataReader en ADO.NET. Esa arquitectura es muy adecuada para extraer grandes conjuntos de datos rápidamente, pero es fundamentalmente incompatible con el modelo mutable de acceso aleatorio que requiere la escritura en Excel.

El código siguiente ilustra el límite máximo que se alcanza con ExcelDataReader:

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

using ExcelDataReader;
using System.Text;

// Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance);

using var stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read);
using var reader = ExcelReaderFactory.CreateReader(stream);

while (reader.Read())
{
    string cellValue = reader.GetString(0); // Read a cell value
    Console.WriteLine(cellValue);
    // There is no Write(), Save(), or SetCellValue() method here
}

Imports ExcelDataReader
Imports System.Text
Imports System.IO

' Register the encoding provider required for .NET 5+
Encoding.RegisterProvider(CodePagesEncodingProvider.Instance)

Using stream = File.Open("source.xlsx", FileMode.Open, FileAccess.Read)
    Using reader = ExcelReaderFactory.CreateReader(stream)
        While reader.Read()
            Dim cellValue As String = reader.GetString(0) ' Read a cell value
            Console.WriteLine(cellValue)
            ' There is no Write(), Save(), or SetCellValue() method here
        End While
    End Using
End Using

Tras llamar a Read(), simplemente no existe un equivalente Write() o Save(). Cuando su aplicación necesita generar informes, actualizar celdas de hojas de cálculo, exportar datos a XLSX, aplicar fórmulas o procesar plantillas, ExcelDataReader le ofrece un amplio abanico de herramientas.

Esto no es un error. Se trata de una decisión deliberada sobre el alcance. ExcelDataReader hace una cosa bien y ahí se queda. Cualquier flujo de trabajo que implique volver a escribir datos en Excel requiere una biblioteca completamente diferente.

¿Cómo resuelve IronXL el problema de la escritura?

IronXL proporciona una API unificada para leer, crear, modificar y guardar archivos de Excel sin necesidad de instalar Microsoft Office. La biblioteca trata un libro de Excel como un grafo de objetos en memoria totalmente mutable. Cargas o creas un libro, navegas a cualquier celda por referencia, estableces valores o fórmulas, aplicas estilos y, a continuación, llamas a SaveAs() -- un flujo de trabajo que refleja cómo trabajaría una persona en el propio Excel.

IronXL admite los formatos XLSX, XLS, CSV, TSV y JSON tanto para la entrada como para la salida. Funciona en .NET 10, .NET Standard y .NET Framework, lo que lo hace adecuado tanto para aplicaciones de consola como para API web de ASP.NET Core, herramientas de escritorio y servicios de procesamiento en segundo plano.

Install-Package IronXL

Install-Package IronXL

dotnet add package IronXL

dotnet add package IronXL

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Report");

// Write header row
sheet["A1"].Value = "Product";
sheet["B1"].Value = "Quantity";
sheet["C1"].Value = "Unit Price";

// Write a data row
sheet["A2"].Value = "Widget";
sheet["B2"].Value = 150;
sheet["C2"].Value = 9.99;

workBook.SaveAs("report.xlsx");
Console.WriteLine("Workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Report")

' Write header row
sheet("A1").Value = "Product"
sheet("B1").Value = "Quantity"
sheet("C1").Value = "Unit Price"

' Write a data row
sheet("A2").Value = "Widget"
sheet("B2").Value = 150
sheet("C2").Value = 9.99

workBook.SaveAs("report.xlsx")
Console.WriteLine("Workbook saved.")

¿Cómo se lee y se escribe en un único flujo de trabajo de IronXL?

Un requisito habitual es leer un archivo Excel existente, transformar sus datos y volver a escribir los resultados. ExcelDataReader solo se encarga del primer paso, lo que significa que es necesario introducir una segunda biblioteca, una complicación innecesaria que añade una carga adicional a la gestión de dependencias y posibles conflictos de versiones.

IronXL cubre todo el proceso. El ejemplo siguiente carga un archivo de origen, lee los valores de la columna A, los transforma y guarda el libro modificado como un nuevo archivo:

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

using IronXL;

WorkBook workBook = WorkBook.Load("source.xlsx");
WorkSheet sheet = workBook.DefaultWorkSheet;

// Read existing data
string originalValue = sheet["A1"].StringValue;
Console.WriteLine($"Original: {originalValue}");

// Modify existing data
sheet["A1"].Value = originalValue.ToUpper();

// Add new data alongside existing content
sheet["B1"].Value = DateTime.Now.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

workBook.SaveAs("modified.xlsx");
Console.WriteLine("Modified workbook saved.");

Imports IronXL

Dim workBook As WorkBook = WorkBook.Load("source.xlsx")
Dim sheet As WorkSheet = workBook.DefaultWorkSheet

' Read existing data
Dim originalValue As String = sheet("A1").StringValue
Console.WriteLine($"Original: {originalValue}")

' Modify existing data
sheet("A1").Value = originalValue.ToUpper()

' Add new data alongside existing content
sheet("B1").Value = DateTime.Now.ToString("yyyy-MM-dd")
sheet("C1").Formula = "=LEN(A1)"

workBook.SaveAs("modified.xlsx")
Console.WriteLine("Modified workbook saved.")

La llamada WorkBook.Load() lee el archivo en memoria como un objeto mutable. A continuación, se navega por las celdas utilizando referencias al estilo de Excel, se actualizan los valores, se establecen fórmulas y se ahorra, todo ello dentro de una única biblioteca y un único patrón de API.

¿Qué funciones avanzadas de escritura admite IronXL?

Más allá de la simple asignación de celdas, IronXL ofrece toda la gama de capacidades de Excel que suelen requerir las aplicaciones empresariales.

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

using IronXL;
using IronXl.Styles;

WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workBook.CreateWorkSheet("Analytics");

// Write labels
sheet["A1"].Value = "Revenue";
sheet["B1"].Value = "Cost";
sheet["C1"].Value = "Margin";

// Write data
sheet["A2"].Value = 50000;
sheet["B2"].Value = 32000;

// Write a calculated formula
sheet["C2"].Formula = "=A2-B2";

// Apply bold formatting to the header row
sheet["A1:C1"].Style.Font.Bold = true;

// Highlight the margin cell
sheet["C2"].Style.BackgroundColor = "#D4EDDA";
sheet["C2"].Style.Font.Bold = true;

workBook.SaveAs("analytics.xlsx");

Imports IronXL
Imports IronXl.Styles

Dim workBook As WorkBook = WorkBook.Create(ExcelFileFormat.XLSX)
Dim sheet As WorkSheet = workBook.CreateWorkSheet("Analytics")

' Write labels
sheet("A1").Value = "Revenue"
sheet("B1").Value = "Cost"
sheet("C1").Value = "Margin"

' Write data
sheet("A2").Value = 50000
sheet("B2").Value = 32000

' Write a calculated formula
sheet("C2").Formula = "=A2-B2"

' Apply bold formatting to the header row
sheet("A1:C1").Style.Font.Bold = True

' Highlight the margin cell
sheet("C2").Style.BackgroundColor = "#D4EDDA"
sheet("C2").Style.Font.Bold = True

workBook.SaveAs("analytics.xlsx")

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

using IronXL;

// Load a CSV file as if it were a workbook
WorkBook csvWorkBook = WorkBook.LoadCSV("data.csv", fileFormat: ExcelFileFormat.CSV);
WorkSheet csvSheet = csvWorkBook.DefaultWorkSheet;

// Apply a bold header style to the first row
csvSheet["A1:Z1"].Style.Font.Bold = true;

// Save as XLSX
csvWorkBook.SaveAs("converted.xlsx");
Console.WriteLine("CSV converted to XLSX.");

Imports IronXL

' Load a CSV file as if it were a workbook
Dim csvWorkBook As WorkBook = WorkBook.LoadCSV("data.csv", fileFormat:=ExcelFileFormat.CSV)
Dim csvSheet As WorkSheet = csvWorkBook.DefaultWorkSheet

' Apply a bold header style to the first row
csvSheet("A1:Z1").Style.Font.Bold = True

' Save as XLSX
csvWorkBook.SaveAs("converted.xlsx")
Console.WriteLine("CSV converted to XLSX.")

¿Cómo se comparan ExcelDataReader e IronXL?

La tabla siguiente resume las diferencias de funcionalidad entre las dos bibliotecas en los escenarios de desarrollo de Excel más comunes:

ExcelDataReader sigue siendo una opción válida cuando la lectura es el único requisito y el tamaño del archivo binario es importante. Para cualquier escenario que implique la generación de resultados, IronXL es la herramienta adecuada.

¿Cuándo deberías utilizar IronXL?

IronXL es la elección adecuada siempre que su aplicación necesite crear o modificar archivos de Excel. Los siguientes escenarios son representativos de requisitos empresariales reales que ExcelDataReader no puede abordar:

• Generación de informes: Crea informes en Excel a partir de consultas a bases de datos, respuestas de API o cálculos en memoria. Consulte la guía de creación de informes de Excel para obtener una explicación detallada.
• Exportación de datos: Convierte los datos de la aplicación (colecciones, DataTables o DataSets) a XLSX para su descarga o archivo. El tutorial de DataTable a Excel muestra la API exacta.
• Procesamiento de plantillas: Cargar una plantilla XLSX con celdas de marcador de posición, rellenarlas dinámicamente y, a continuación, guardar el resultado rellenado.
• Modificación de archivos por lotes: Recorre un directorio de libros de trabajo, aplica los cambios mediante programación y guarda cada archivo. IronXL gestiona varios libros de trabajo abiertos de forma independiente.
• Generación de facturas y documentos financieros: Crea documentos estructurados con fórmulas, formato de números, celdas combinadas y encabezados con estilo.
• Conversión de CSV a XLSX: Acepta archivos de carga separados por comas, los reformatea como libros de trabajo estructurados y devuelve descargas en formato XLSX a los usuarios.

Las aplicaciones empresariales que antes requerían una biblioteca de lectura y otra de escritura —o dependían de la automatización de Excel a través de COM— pueden consolidarse únicamente en IronXL.

Para escenarios de salida avanzados, la documentación sobre formato condicional y la guía de creación de gráficos cubren toda la gama de capacidades de formato y visualización. La página de licencias describe las opciones de implementación en producción, y la referencia completa de la API documenta todas las clases y métodos.

¿Cómo empezar con una prueba gratuita?

IronXL está disponible bajo una licencia de desarrollo gratuita. Instala el paquete NuGet, ejecuta los ejemplos anteriores con tus propios archivos y comprueba que el resultado cumple tus requisitos antes de adquirir una licencia de producción.

La guía de introducción a IronXL explica paso a paso la instalación, los patrones de primer uso y los escenarios habituales con código ejecutable. La sección de tutoriales trata en detalle los flujos de trabajo de lectura, lo cual resulta útil si su aplicación necesita operaciones tanto de lectura como de escritura.

Inicie la prueba gratuita para acceder al conjunto completo de funciones, incluidos los formatos de exportación, el formato avanzado, la evaluación de fórmulas y la gestión de libros de trabajo con varias hojas. Para los equipos que evalúan la biblioteca a gran escala, el paquete IronSuite incluye IronXL junto con IronPDF, IronOCR y otras bibliotecas de productividad a un precio combinado reducido.

¿Sigue mereciendo la pena utilizar ExcelDataReader?

ExcelDataReader es una biblioteca de código abierto bien mantenida con un propósito claro. Si su aplicación solo lee archivos Excel y nunca los escribe —por ejemplo, un canal de ingestión de datos que importa archivos XLSX cargados a una base de datos—, ExcelDataReader es una opción razonable y ligera. Su modelo de streaming es eficiente en cuanto a memoria para archivos muy grandes.

El problema surge cuando los requisitos se amplían. Las aplicaciones que comienzan como importadores de solo lectura suelen evolucionar para generar exportaciones de confirmación, informes de errores o copias modificadas de los archivos originales. En ese punto, los límites del ámbito de ExcelDataReader se convierten en un obstáculo, y migrar a una biblioteca de lectura y escritura a mitad del proyecto resulta más disruptivo que empezar con una desde el principio.

Elegir IronXL desde el principio cubre ambos escenarios. El tutorial de lectura de IronXL demuestra que leer con IronXL es igual de sencillo: las referencias de celda, la iteración de rangos, la exportación de DataSet y el acceso a valores con seguridad de tipos funcionan a través de la misma API familiar.

¿Qué debe hacer a continuación?

ExcelDataReader es una biblioteca de solo lectura. Esa restricción es intencionada y no cambiará. Si su proyecto requiere escribir, modificar o exportar archivos de Excel en cualquier formato, necesita una biblioteca diseñada para el acceso bidireccional a Excel.

IronXL ofrece esa capacidad sin dependencias de Office, sin la complejidad de la interoperabilidad COM y sin combinar múltiples paquetes en una frágil pila de bibliotecas. Instálalo desde NuGet, sustituye tu código de lectura existente por los métodos equivalentes de IronXL y añade operaciones de escritura donde sea necesario: la API es coherente en ambas direcciones.

Explora la documentación de IronXL para comprender todo el alcance de la biblioteca IronXL. Consulte las guías prácticas para tareas específicas, como escribir archivos de Excel, crear hojas de cálculo y leer libros de trabajo existentes. Cuando esté listo para evaluar las licencias de producción, la página de precios y licencias enumera todos los niveles disponibles.