Como ler arquivos do OpenOffice Excel em C# sem o Excel instalado

Como instalar o IronXL em um projeto .NET?

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

Como Carregar um Arquivo OpenOffice ou Excel em C#?

IronXL trata arquivos ODS, XLS, XLSX e CSV de forma idêntica através do método WorkBook.Load. Você passa um caminho absoluto ou relativo do arquivo, e a biblioteca detecta o formato a partir do cabeçalho do arquivo – não apenas a extensão. Isso significa que um arquivo renomeado de .ods para .xlsx ainda é lido corretamente.

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

using IronXL;

// Load an OpenDocument Spreadsheet (.ods) produced by LibreOffice Calc or OpenOffice
WorkBook workbook = WorkBook.Load("quarterly_report.ods");

// Access the first worksheet by index
WorkSheet sheet = workbook.WorkSheets[0];

// Read a cell value
string companyName = sheet["A1"].StringValue;
int recordCount   = sheet["B1"].IntValue;

Console.WriteLine($"Company : {companyName}");
Console.WriteLine($"Records : {recordCount}");

A mesma chamada funciona para arquivos XLSX e XLS – basta mudar o caminho. WorkBook.Load retorna o mesmo objeto fortemente tipado, independentemente do formato de origem, para que o restante do seu código permaneça idêntico, seja o arquivo originário do Microsoft Excel, LibreOffice ou qualquer outro aplicativo compatível com ODF.

Como Ler Toda Linha e Célula em uma Planilha?

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

using IronXL;

WorkBook workbook  = WorkBook.Load("customers.xlsx");
WorkSheet worksheet = workbook.WorkSheets[0];

Console.WriteLine($"Total rows    : {worksheet.RowCount}");
Console.WriteLine($"Total columns : {worksheet.ColumnCount}");
Console.WriteLine();

foreach (var row in worksheet.Rows)
{
    foreach (var cell in row)
    {
        if (!cell.IsEmpty)
            Console.Write($"{cell.StringValue,-20}");
    }
    Console.WriteLine();
}

Como Extrair Valores Tipados das Células?

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

using IronXL;

WorkBook workbook = WorkBook.Load("inventory.xlsx");
WorkSheet sheet   = workbook.GetWorkSheet("Products");

// Typed accessors handle conversion automatically
string  productName = sheet["A2"].StringValue;
int     quantity    = sheet["B2"].IntValue;
decimal unitPrice   = sheet["C2"].DecimalValue;
bool    inStock     = sheet["D2"].BoolValue;
DateTime? lastAudit = sheet["E2"].DateTimeValue;

Console.WriteLine($"Product  : {productName}");
Console.WriteLine($"Qty      : {quantity}");
Console.WriteLine($"Price    : {unitPrice:C}");
Console.WriteLine($"In Stock : {inStock}");
Console.WriteLine($"Audited  : {lastAudit?.ToString("d") ?? "Never"}");

Como Trabalhar com Múltiplas Planilhas Nomeadas?

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

using IronXL;

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

// Option 1: access by name (throws if the sheet does not exist)
WorkSheet januarySheet = workbook.GetWorkSheet("January");

// Option 2: iterate all sheets in the workbook
foreach (WorkSheet ws in workbook.WorkSheets)
{
    Console.WriteLine($"Sheet: {ws.Name}  |  Rows: {ws.RowCount}");

    // Read the header row from each sheet
    string header = ws["A1"].StringValue;
    Console.WriteLine($"  Header: {header}");
}

// Option 3: access by zero-based index
WorkSheet lastSheet = workbook.WorkSheets[workbook.WorkSheets.Count - 1];
Console.WriteLine($"Last sheet: {lastSheet.Name}");

Como Lidar com Células Mescladas e Regiões Formataradas?

Relatórios e painéis frequentemente usam células mescladas para cabeçalhos, rótulos agrupados e linhas de resumo. IronXL lê o valor da célula no canto superior esquerdo de uma região mesclada, exatamente como o Excel exibe:

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

using IronXL;

WorkBook workbook = WorkBook.Load("report_with_merges.xlsx");
WorkSheet sheet   = workbook.DefaultWorkSheet;

// The merged region A1:D1 stores its value in cell A1
string reportTitle = sheet["A1"].StringValue;
Console.WriteLine($"Report title : {reportTitle}");

// Read cell formatting metadata
var titleCell = sheet["A1"];
Console.WriteLine($"Bold         : {titleCell.Style.Font.Bold}");
Console.WriteLine($"Font size    : {titleCell.Style.Font.Height}");

// Scan an entire column for non-empty section headers
foreach (var cell in sheet["A1:A100"])
{
    if (!cell.IsEmpty && cell.Style.Font.Bold)
        Console.WriteLine($"Section header at {cell.AddressString}: {cell.StringValue}");
}

A árvore de propriedades Style espelha a estrutura da especificação OOXML SpreadsheetML, então os nomes das propriedades parecerão familiares se você já trabalhou com o SDK Open XML. No entanto, IronXL envolve toda essa complexidade em uma API limpa que não requer nenhuma manipulação de XML da sua parte.

Como Importar Arquivos CSV com a Mesma API?

Arquivos CSV produzidos por exportações de bancos de dados, sistemas CRM e aplicativos legados podem ser lidos através da mesma chamada WorkBook.Load. IronXL infere o delimitador a partir do conteúdo do arquivo:

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

using IronXL;

// Load a comma-separated values file -- same method, same API
WorkBook csvWorkbook  = WorkBook.Load("export.csv");
WorkSheet csvSheet    = csvWorkbook.DefaultWorkSheet;

Console.WriteLine($"CSV rows loaded: {csvSheet.RowCount}");

// Process rows exactly like any other worksheet
foreach (var row in csvSheet.Rows)
{
    string id   = row[0].StringValue;
    string name = row[1].StringValue;
    Console.WriteLine($"{id,-10} {name}");
}

Após o carregamento, você pode salvar os dados como XLSX usando csvWorkbook.SaveAs("output.xlsx"). Este é um padrão comum para pipelines de conversão CSV-para-Excel -- receber um arquivo CSV, enriquecê-lo com colunas calculadas ou formatação, e retornar um relatório XLSX formatado ao usuário.

Para arquivos separados por tabulações ou delimitadores personalizados, use WorkBook.LoadCSV("file.tsv", fileFormatar: ExcelFileFormatar.TSV) para especificar explicitamente o formato.

Como o IronXL se Compara ao Microsoft.Office.Interop.Excel?

Como Implementar o Processamento de Excel no Linux e Docker?

Implementações de servidor são onde a independência do IronXL em relação ao Excel se torna mais valiosa. O mesmo código que você escreve no Windows roda inalterado no Ubuntu, Alpine Linux ou macOS. Para implementações em contêiner, seu Dockerfile não requer configuração especial:

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

# Standard .NET runtime image -- no Office packages needed
FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY --from=build /app/publish .
ENTRYPOINT ["dotnet", "ExcelProcessor.dll"]

Para Azure Functions e AWS Lambda, IronXL funciona dentro do runtime gerido sem qualquer configuração adicional. O overhead de inicialização a frio é mínimo porque não há etapa de inicialização do COM.

A segurança de thread é integrada: vários threads podem abrir instâncias diferentes de WorkBook simultaneamente sem coordenação. Se você precisar processar milhares de arquivos em paralelo -- por exemplo, em um trabalho em segundo plano que ingere planilhas enviadas pelo usuário -- você pode usar Parallel.ForEach ou Task.WhenAll em um pool de instâncias WorkBook sem risco de corrupção.

O uso de memória permanece previsível porque o IronXL carrega apenas a planilha solicitada na memória, não todo o livro na inicialização. Para arquivos muito grandes, essa distinção é importante: um livro com dez folhas de 50MB não requer 500MB de RAM apenas para ler uma única folha. A documentação de desempenho do IronXL cobre estratégias adicionais para lidar com cenários de processamento de arquivos em grande volume.

Quais são os seus próximos passos?

A maneira mais rápida de validar o IronXL no seu projeto é instalar o pacote NuGet e executar os exemplos deste guia contra um arquivo real do seu ambiente. Uma licença de teste gratuita desbloqueia todos os recursos sem a necessidade de alteração no código quando você estiver pronto para a produção.

Explore capacidades relacionadas do IronXL que complementam a leitura de arquivos:

• Escrever e criar arquivos Excel em C# -- criar relatórios e exportações de dados programaticamente
• Formatarar células, linhas e colunas -- aplicar cores, fontes e bordas no código
• Trabalhar com fórmulas do Excel em C# -- ler e escrever células de fórmula
• Converter Excel para PDF no .NET -- gerar relatórios em PDF a partir de dados de planilhas
• Documentação da API do IronXL -- referência completa para todas as classes e métodos
• Licenciamento e preços do IronXL -- opções para desenvolvedores individuais e equipes empresariais
• Página do NuGet do IronXL -- instruções de instalação para todos os tipos de projeto
• Tutoriais do IronXL -- guias passo a passo para casos de uso comuns
• Comparar IronXL com EPPlus -- comparação lado a lado de recursos e licenciamento
• Página inicial do produto IronXL -- visão geral dos recursos e recursos para iniciar

Para dúvidas sobre licenciamento, suporte multiplataforma ou requisitos de formato de arquivo específico, a equipe de suporte do IronXL está disponível via chat ao vivo e email.

!{--010011000100100101000010010100100100000101010010010110010101111101000111010001010101010100010111110101001101010100010000010101001001010100010001010100010001011111010101110100100 101010100010010000101111101010000010100100111101000100010101010100001101010100010111110101010001010010010010010010010100000101001100010111110100001001001100010011110100001101001011--}