Alternativa para ler arquivos Excel usando StreamReader em C# - IronXL

Por Que o StreamReader Não Pode Ler Arquivos Excel?

StreamReader é projetado para arquivos de texto simples, lendo dados de caracteres linha por linha usando uma codificação especificada. Arquivos do Excel, apesar de sua aparência de planilha, são na verdade estruturas binárias complexas ou XML compactadas em ZIP que StreamReader não pode 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
    }
}

Quando você executa este trecho de código da classe Programa, em vez de ver os dados da sua planilha, você encontrará dados desconhecidos em binário, como "PK♥♦" ou caracteres de sistema semelhantes. Isso acontece porque arquivos XLSX são arquivos ZIP contendo múltiplos arquivos XML, enquanto arquivos XLS usam um formato binário proprietário. StreamReader espera texto simples e tenta interpretar essas estruturas complexas como caracteres, resultando em uma saída sem sentido.

Como Ler Arquivos Excel com IronXL?

IronXL oferece uma solução simples para ler arquivos Excel em C#. Ao contrário de StreamReader, IronXL compreende a estrutura interna do Excel e fornece métodos intuitivos para acessar seus dados. A biblioteca suporta Windows, Linux, macOS e containers Docker, tornando-a ideal para aplicações modernas e multiplataforma.

Primeiro, instale IronXL via o Gerenciador de Pacotes NuGet:

Install-Package IronXl.Excel

Veja como ler um arquivo Excel corretamente:

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

Este código carrega com sucesso seu arquivo Excel e fornece acesso limpo aos valores das células. O método WorkBook.Load detecta automaticamente o formato do arquivo (XLSX, XLS, XLSM, CSV) e lida com toda a análise complexa internamente. Você pode acessar as células usando a notação familiar do Excel, como "A1" ou intervalos como "A1:C5", tornando o código intuitivo para qualquer pessoa familiarizada com o Excel.

Como Ler Excel a Partir de Fluxos de Memória?

Aplicações do mundo real frequentemente precisam processar arquivos Excel de fluxos ao invés de arquivos de disco. Cenários comuns incluem lidar com uploads web, recuperar arquivos de bancos de dados ou processar dados de armazenamento em nuvem. O IronXL lida com essas situações 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");
}

O método WorkBook.FromStream aceita qualquer tipo de fluxo, seja um MemoryStream, FileStream ou fluxo de rede. Essa flexibilidade permite que você processe arquivos Excel de várias fontes sem salvá-los no disco primeiro. O exemplo também demonstra converter dados da planilha para um DataTable, que se integra perfeitamente com bancos de dados e cenários de vinculação de dados.

Como Converter Entre Excel e CSV?

Enquanto StreamReader pode lidar com arquivos CSV, você muitas vezes precisa converter entre formatos Excel e CSV. O IronXL torna essa conversão simples:

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

Essas conversões preservam seus dados enquanto mudam o formato do arquivo. Ao converter Excel para CSV, o IronXL achata a primeira planilha por padrão, mas você pode especificar qual planilha exportar. Converter de CSV para Excel cria uma planilha devidamente formatada que preserva os tipos de dados e permite adições futuras de formatação e fórmulas.

Conclusão

A incapacidade de StreamReader de processar arquivos do Excel decorre da diferença fundamental entre texto simples e a estrutura complexa de arquivos do Excel. Enquanto StreamReader funciona perfeitamente para CSV e outros formatos de texto, arquivos verdadeiros do Excel exigem uma biblioteca especializada como IronXL que compreenda as estruturas binárias e XML internas.

O IronXL oferece uma solução elegante com sua API intuitiva, suporte abrangente a formatos e capacidades de processamento de stream integradas. Quer você esteja construindo aplicativos da web, software de desktop ou serviços em nuvem, IronXL lida com os arquivos Excel de forma confiável em todas as plataformas.

Pronto para começar a trabalhar adequadamente com arquivos Excel? Baixe a versão de teste gratuita do IronXL e experimente o processamento de Excel sem complicações em suas aplicações C#. Para implantações em produção, considere as opções de licenciamento do IronXL que melhor atendem às necessidades do seu projeto.