O ExcelDataReader não consegue gravar arquivos do Excel: por que não consegue e como o IronXL resolve isso.

O ExcelDataReader pode escrever dados de livros do Excel?

Não. O ExcelDataReader é uma biblioteca somente leitura por design, e essa limitação é intencional. O repositório oficial do GitHub do ExcelDataReader descreve o projeto explicitamente como "uma biblioteca para leitura de arquivos Microsoft Excel" -- não há API de escrita, nenhum método de salvamento, e nenhum definir de valor de célula em qualquer superfície pública. Você pode verificar isso por conta própria navegando na página do pacote NuGet do ExcelDataReader, onde a descrição do pacote reforça o escopo de somente leitura.

O ExcelDataReader suporta os formatos XLS, XLSX, e CSV para leitura, e ele faz esse trabalho de forma eficiente. A biblioteca expõe um padrão de leitura em fluxo, só de avanço, semelhante ao IDataReader no ADO.NET. Essa arquitetura é bem adaptada para extrair grandes conjuntos de dados rapidamente, mas é fundamentalmente incompatível com o modelo de acesso aleatório e mutável que a escrita no Excel exige.

O código abaixo ilustra o limite que você alcança com o 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
}

Após chamar Read(), simplesmente não há equivalente Write() ou contraparte Save(). Quando sua aplicação precisa gerar relatórios, atualizar células de planilha, exportar dados para XLSX, aplicar fórmulas ou processar modelos, o ExcelDataReader deixa você com uma caixa de ferramentas vazia.

Isso não é um bug. É uma decisão deliberada de escopo. O ExcelDataReader faz uma coisa bem e para por aí. Qualquer fluxo de trabalho que envolve escrever dados de volta para o Excel requer uma biblioteca completamente diferente.

Como o IronXL Resolve o Problema de Escrita?

IronXL fornece uma API unificada para ler, criar, modificar e salvar arquivos Excel sem qualquer instalação do Microsoft Office. A biblioteca trata um livro do Excel como um gráfico de objetos totalmente mutável em memória. Você carrega ou cria uma planilha, navega para qualquer célula por referência, define valores ou fórmulas, aplica estilos, e então chama SaveAs() -- um fluxo de trabalho que espelha como um humano trabalharia no próprio Excel.

IronXL suporta os formatos XLSX, XLS, CSV, TSV e JSON tanto para entrada quanto para saída. Ele é executado em .NET 10, .NET Standard, e .NET Framework, tornando-o adequado para aplicações de console, APIs web ASP.NET Core, ferramentas de desktop e serviços de processamento em 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.");

Como você lê e escreve em um único fluxo de trabalho do IronXL?

Um requisito comum é ler um arquivo Excel existente, transformar seus dados e escrever os resultados de volta. O ExcelDataReader lida apenas com o primeiro passo, o que significa que você precisa introduzir uma segunda biblioteca -- uma complicação desnecessária que adiciona sobrecarga de gerenciamento de dependências e potenciais conflitos de versão.

IronXL cobre todo o fluxo de trabalho. O exemplo abaixo carrega um arquivo de origem, lê valores da coluna A, transforma-os, e salva o livro modificado como um novo arquivo:

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.Nãow.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.Nãow.ToString("yyyy-MM-dd");
sheet["C1"].Formula = "=LEN(A1)";

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

A chamada WorkBook.Load() lê o arquivo na memória como um objeto mutável. Você então navega pelas células usando referências no estilo do Excel, atualiza valores, define fórmulas e salva -- tudo em uma única biblioteca e um único padrão de API.

Quais recursos avançados de escrita o IronXL suporta?

Além da simples atribuição de células, o IronXL expõe toda a gama de capacidades do Excel que as aplicações empresariais normalmente exigem.

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");

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.");

Como você compara ExcelDataReader e IronXL lado a lado?

A tabela abaixo resume a diferença de capacidades entre as duas bibliotecas nos cenários de desenvolvimento de Excel mais comuns:

ExcelDataReader continua sendo uma escolha legítima quando a leitura é o único requisito e o tamanho binário é importante. Para qualquer cenário envolvendo saída, IronXL é a ferramenta apropriada.

Quando você deve usar IronXL?

IronXL torna-se a escolha certa sempre que sua aplicação precisa produzir ou modificar arquivos Excel. Os seguintes cenários são representativos de requisitos empresariais reais que o ExcelDataReader não pode abordar:

• Geração de Relatórios: Produzir relatórios em Excel a partir de consultas de banco de dados, respostas de API ou cálculos em memória. Veja o guia de criação de relatórios Excel para um passo a passo estruturado.
• Exportação de dados: Converter dados de aplicação -- coleções, DataTables, ou DataSets -- para XLSX para download ou arquivamento. O tutorial de DataTable para Excel mostra a API exata.
• Processamento de modelos: Carregar um modelo XLSX com células de espaço reservado, preenchê-las dinamicamente, e então salvar o resultado populado.
• Modificação em lote de arquivos: Iterar sobre um diretório de planilhas, aplicar mudanças programaticamente, e salvar cada arquivo. IronXL lida com múltiplas planilhas abertas independentemente.
• Geração de faturas e documentos financeiros: Criar documentos estruturados com fórmulas, formatação de número, células mescladas, e cabeçalhos estilizados.
• Conversão de CSV para XLSX: Aceitar uploads separados por vírgula, reformatá-los como planilhas estruturadas, e retornar downloads XLSX para os usuários.

Aplicações empresariais que anteriormente requeriam uma biblioteca de leitura e outra de escrita -- ou uma dependência de automação do Excel via COM -- podem ser consolidadas apenas no IronXL.

Para cenários avançados de saída, a documentação de formatação condicional e o guia de criação de gráficos cobrem toda a gama de capacidades de formatação e visualização. A página de licenciamento descreve as opções de implantação em produção, e a referência completa da API documenta todas as classes e métodos.

Como posso começar com um teste gratuito?

IronXL está disponível sob uma licença de desenvolvimento gratuita. Instale o pacote NuGet, execute os exemplos acima em seus próprios arquivos e verifique se a saída atende às suas necessidades antes de se comprometer com uma licença de produção.

O guia de início do IronXL aborda a instalação, padrões de primeiro uso e cenários comuns com código executável. A seção de tutoriais cobre os fluxos de leitura em detalhe, útil se sua aplicação precisar de operações de leitura e escrita.

Inicie o teste gratuito para acessar o conjunto completo de recursos, incluindo formatos de exportação, formatação avançada, avaliação de fórmulas e gestão de planilhas multi-sheet. Para equipes avaliando a biblioteca em escala, o pacote IronSuite inclui o IronXL juntamente com o IronPDF, IronOCR e outras bibliotecas de produtividade a um preço combinado reduzido.

O ExcelDataReader ainda vale a pena usar?

ExcelDataReader é uma biblioteca open-source bem mantida com um propósito claro. Se sua aplicação apenas lê arquivos Excel e nunca os escreve -- por exemplo, um pipeline de ingestão de dados que importa uploads XLSX para um banco de dados -- o ExcelDataReader é uma escolha razoável e leve. Seu modelo de streaming é eficiente em memória para arquivos muito grandes.

O problema surge quando os requisitos se expandem. Aplicações que começam como importadores apenas de leitura frequentemente evoluem para produzir exportações de confirmação, relatórios de erros, ou cópias modificadas dos arquivos originais. Nesse ponto, a limitação de escopo do ExcelDataReader se torna um impedimento, e migrar para uma biblioteca de leitura e escrita no meio do projeto é mais disruptivo do que começar com uma.

Escolher o IronXL desde o início cobre ambos os cenários. O tutorial de leitura do IronXL demonstra que ler com o IronXL é igualmente simples -- referências de célula, iteração de intervalo, exportação de DataSet, e acesso a valores com segurança de tipo funcionam através da mesma API familiar.

O que você deve fazer a seguir?

ExcelDataReader é uma biblioteca somente de leitura. Essa restrição é por design e não mudará. Se seu projeto requer escrever, modificar ou exportar arquivos Excel de qualquer forma, você precisa de uma biblioteca construída para acesso bidirecional ao Excel.

IronXL fornece essa capacidade sem dependências do Office, sem a complexidade do COM interop, e sem a combinação de múltiplos pacotes em uma pilha de múltiplas bibliotecas frágil. Instale-o do NuGet, substitua seu código de leitura existente pelos métodos equivalentes do IronXL, e adicione operações de escrita conforme necessário -- a API é consistente em ambas as direções.

Explore a documentação do IronXL para entender todo o escopo da biblioteca. Revise os guias de como fazer para tarefas específicas como escrever arquivos Excel, criar planilhas, e ler planilhas existentes. Quando estiver pronto para avaliar o licenciamento de produção, a página de preços e licenciamento lista todos os níveis disponíveis.