Como criar planilhas do Excel em C# .NET Core usando IronXL

Como Você Instala o IronXL em um Projeto .NET Core?

Antes de criar planilhas, você precisa adicionar o IronXL ao seu projeto. Abra o Console do Gerenciador de Pacotes NuGet no Visual Studio e execute um destes comandos:

Install-Package IronXL
dotnet add package IronXL

Install-Package IronXL
dotnet add package IronXL

O primeiro comando funciona no Console do Gerenciador de Pacotes do Visual Studio. O segundo funciona em qualquer terminal usando a CLI do .NET. Ambos instalam o mesmo pacote NuGet e adicionam o IronXL às referências do seu projeto automaticamente.

Uma vez que a instalação é concluída, o IronXL está pronto para uso com uma única diretiva using. A biblioteca não requer nenhuma configuração adicional, dependências de runtime ou instalação do Microsoft Office. Funciona em qualquer plataforma onde .NET 10 roda – Windows, Linux, macOS ou qualquer ambiente de nuvem.

Para opções de instalação detalhadas, incluindo download manual de DLL, consulte o guia de instalação do IronXL. Desenvolvedores Linux também devem revisar a documentação de implantação Linux para orientações específicas da plataforma.

.NET Core Excel Spreadsheet: Criar Arquivos de Planilhas Excel Profissionais em C# Usando IronXL for .NET: Imagem 1 - Instalação

Como criar uma planilha Excel sem dependências do Office?

A automação tradicional do Microsoft Excel requer instalação do MS Office e usa o Office Interop, que não funciona no Linux ou em ambientes containerizados. Como discutido na documentação da Microsoft sobre o Office Interop, o Office Interop introduz complexidade de implantação e problemas de licenciamento. IronXL for .NET elimina essas limitações ao fornecer uma solução .NET pura que processa arquivos Excel nativamente com suporte total para capacidades modernas de planilhas.

A biblioteca suporta .NET 8, .NET 9 e .NET 10, juntamente com versões anteriores do .NET Core. Ela manipula formatos de planilha XLSX, XLS, CSV e outros sem dependências externas. Isso a torna particularmente valiosa para aplicações do lado do servidor, microsserviços e cenários onde instalar o Microsoft Office não é prático. A fácil integração via NuGet significa que você pode começar a escrever arquivos Excel em poucos minutos:

using IronXL;

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add an Excel worksheet with a custom name
WorkSheet sheet = workbook.CreateWorkSheet("SalesReport");
// Set a cell value
sheet["A1"].Value = "Product Sales Summary";
// Save the generated Excel file
workbook.SaveAs("SalesReport.xlsx");

using IronXL;

// Create a new workbook in XLSX format
WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
// Add an Excel worksheet with a custom name
WorkSheet sheet = workbook.CreateWorkSheet("SalesReport");
// Set a cell value
sheet["A1"].Value = "Product Sales Summary";
// Save the generated Excel file
workbook.SaveAs("SalesReport.xlsx");

O método WorkBook.Create() inicializa uma nova pasta de trabalho do Excel, aceitando um parâmetro ExcelFileFormat para especificar XLSX (formato moderno baseado em XML introduzido no Excel 2007) ou XLS (formato binário legado). XLSX é recomendado para a maioria dos cenários devido aos tamanhos menores de arquivos e melhor compatibilidade com ferramentas modernas. O método CreateWorkSheet() adiciona planilhas nomeadas onde os dados do Excel residem -- cada pasta de trabalho pode conter várias planilhas individuais para organizar dados relacionados.

Os valores das células são definidos usando notação de colchetes que espelha o sistema de endereçamento do Excel -- sheet["A1"] direciona diretamente a célula A1. Esta sintaxe suporta tanto células específicas quanto intervalos, tornando as operações em massa diretas para qualquer projeto de planilha.

Como adicionar planilhas e preencher dados programaticamente?

Planilhas Excel do mundo real contêm dados estruturados em várias planilhas. IronXL oferece métodos flexíveis para organizar informações e preencher células de forma eficiente, seja trabalhando com entrada manual de dados ou pipelines de dados automatizados em aplicações orientadas a dados.

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("MonthlySales");

// Set column names as headers
sheet["A1"].Value = "Month";
sheet["B1"].Value = "Revenue";
sheet["C1"].Value = "Units Sold";

// Populate Excel data using a loop (mock sales data)
string[] months = { "January", "February", "March", "April", "May", "June" };
decimal[] revenue = { 45000.50m, 52000.75m, 48500.25m, 61000.00m, 58750.50m, 67200.25m };
int[] units = { 150, 175, 160, 200, 190, 220 };

for (int i = 0; i < months.Length; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = months[i];
    sheet[$"B{row}"].Value = revenue[i];
    sheet[$"C{row}"].Value = units[i];
}

// Set a range of cells to the same value across columns
sheet["D2:D7"].Value = "Active";
workbook.SaveAs("MonthlySales.xlsx");

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("MonthlySales");

// Set column names as headers
sheet["A1"].Value = "Month";
sheet["B1"].Value = "Revenue";
sheet["C1"].Value = "Units Sold";

// Populate Excel data using a loop (mock sales data)
string[] months = { "January", "February", "March", "April", "May", "June" };
decimal[] revenue = { 45000.50m, 52000.75m, 48500.25m, 61000.00m, 58750.50m, 67200.25m };
int[] units = { 150, 175, 160, 200, 190, 220 };

for (int i = 0; i < months.Length; i++)
{
    int row = i + 2;
    sheet[$"A{row}"].Value = months[i];
    sheet[$"B{row}"].Value = revenue[i];
    sheet[$"C{row}"].Value = units[i];
}

// Set a range of cells to the same value across columns
sheet["D2:D7"].Value = "Active";
workbook.SaveAs("MonthlySales.xlsx");

A interpolação de strings ($"A{row}") permite o endereçamento dinâmico de células dentro de laços, facilitando o preenchimento de linhas programaticamente a partir de qualquer fonte de dados. A sintaxe de intervalo sheet["D2:D7"] aplica valores a várias células simultaneamente -- útil para colunas de status, valores padrão ou inicialização de regiões de dados. IronXL lida automaticamente com a conversão de tipos de dados, armazenando decimais como valores numéricos e conteúdo de strings como texto, preservando os tipos de dados apropriados do Excel para o arquivo gerado.

WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");
WorkSheet detailSheet = workbook.CreateWorkSheet("Details");
WorkSheet archiveSheet = workbook.CreateWorkSheet("Archive");

WorkSheet summarySheet = workbook.CreateWorkSheet("Summary");
WorkSheet detailSheet = workbook.CreateWorkSheet("Details");
WorkSheet archiveSheet = workbook.CreateWorkSheet("Archive");

Como Aplicar Formatação e Estilo Profissionais?

Dados brutos tornam-se significativos quando formatados adequadamente. IronXL oferece suporte a cores de fundo, fontes, bordas e formatos de número -- capacidades de formatação essenciais que transformam planilhas Excel em relatórios refinados adequados para apresentações executivas ou entregas a clientes.

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("FormattedReport");

// Create headers with styling
sheet["A1"].Value = "Category";
sheet["B1"].Value = "Amount";
sheet["C1"].Value = "Date";

// Apply header formatting to the Excel sheet
sheet["A1:C1"].Style.SetBackgroundColor("#2E86AB");
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.Font.SetColor("#FFFFFF");

// Add sample data to specific cells
sheet["A2"].Value = "Software License";
sheet["B2"].Value = 1299.99m;
sheet["C2"].Value = DateTime.Nãow;

// Format currency and date columns
sheet["B2"].FormatString = "$#,##0.00";
sheet["C2"].FormatString = "yyyy-MM-dd";

// Add borders around the data range
var dataRange = sheet["A1:C2"];
dataRange.Style.BottomBorder.SetColor("#000000");
dataRange.Style.BottomBorder.Type = IronXl.Styles.BorderType.Thin;
workbook.SaveAs("FormattedReport.xlsx");

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("FormattedReport");

// Create headers with styling
sheet["A1"].Value = "Category";
sheet["B1"].Value = "Amount";
sheet["C1"].Value = "Date";

// Apply header formatting to the Excel sheet
sheet["A1:C1"].Style.SetBackgroundColor("#2E86AB");
sheet["A1:C1"].Style.Font.Bold = true;
sheet["A1:C1"].Style.Font.SetColor("#FFFFFF");

// Add sample data to specific cells
sheet["A2"].Value = "Software License";
sheet["B2"].Value = 1299.99m;
sheet["C2"].Value = DateTime.Nãow;

// Format currency and date columns
sheet["B2"].FormatString = "$#,##0.00";
sheet["C2"].FormatString = "yyyy-MM-dd";

// Add borders around the data range
var dataRange = sheet["A1:C2"];
dataRange.Style.BottomBorder.SetColor("#000000");
dataRange.Style.BottomBorder.Type = IronXl.Styles.BorderType.Thin;
workbook.SaveAs("FormattedReport.xlsx");

A propriedade Style expõe opções de formatação que correspondem às capacidades do Microsoft Excel. Cores de fundo aceitam códigos hex (com ou sem o prefixo #), enquanto FormatString aplica formatos numéricos idênticos à sintaxe de formatação personalizada do Excel -- os mesmos padrões funcionam em ambos os ambientes. O estilo das bordas oferece suporte aos tipos Fino, Médio, Grosso e Duplo, permitindo controle preciso sobre os limites das células na sua planilha Excel.

Como Utilizar Fórmulas do Excel para Cálculos Automáticos?

O motor de cálculos do Excel automatiza a análise de dados, e IronXL oferece suporte total a fórmulas. Defina fórmulas como strings usando a sintaxe padrão do Excel, e IronXL calcula os resultados automaticamente quando solicitado -- essencial para relatórios e análises financeiras.

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("BudgetCalculations");

// Add expense data to the Excel workbook
sheet["A1"].Value = "Expense";
sheet["B1"].Value = "Amount";
sheet["A2"].Value = "Rent";
sheet["B2"].Value = 2500;
sheet["A3"].Value = "Utilities";
sheet["B3"].Value = 350;
sheet["A4"].Value = "Supplies";
sheet["B4"].Value = 875;
sheet["A5"].Value = "Marketing";
sheet["B5"].Value = 1200;

// Add formulas for calculations
sheet["A7"].Value = "Total:";
sheet["B7"].Formula = "=SUM(B2:B5)";
sheet["A8"].Value = "Average:";
sheet["B8"].Formula = "=AVERAGE(B2:B5)";
sheet["A9"].Value = "Maximum:";
sheet["B9"].Formula = "=MAX(B2:B5)";
sheet["A10"].Value = "Count:";
sheet["B10"].Formula = "=COUNT(B2:B5)";

// Calculate all formulas
workbook.EvaluateAll();

// Access calculated values programmatically
decimal total = sheet["B7"].DecimalValue;
Console.WriteLine($"Calculated total: {total}");
workbook.SaveAs("BudgetCalculations.xlsx");

using IronXL;

WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
WorkSheet sheet = workbook.CreateWorkSheet("BudgetCalculations");

// Add expense data to the Excel workbook
sheet["A1"].Value = "Expense";
sheet["B1"].Value = "Amount";
sheet["A2"].Value = "Rent";
sheet["B2"].Value = 2500;
sheet["A3"].Value = "Utilities";
sheet["B3"].Value = 350;
sheet["A4"].Value = "Supplies";
sheet["B4"].Value = 875;
sheet["A5"].Value = "Marketing";
sheet["B5"].Value = 1200;

// Add formulas for calculations
sheet["A7"].Value = "Total:";
sheet["B7"].Formula = "=SUM(B2:B5)";
sheet["A8"].Value = "Average:";
sheet["B8"].Formula = "=AVERAGE(B2:B5)";
sheet["A9"].Value = "Maximum:";
sheet["B9"].Formula = "=MAX(B2:B5)";
sheet["A10"].Value = "Count:";
sheet["B10"].Formula = "=COUNT(B2:B5)";

// Calculate all formulas
workbook.EvaluateAll();

// Access calculated values programmatically
decimal total = sheet["B7"].DecimalValue;
Console.WriteLine($"Calculated total: {total}");
workbook.SaveAs("BudgetCalculations.xlsx");

A propriedade Formula aceita a sintaxe padrão de fórmulas do Excel -- as mesmas fórmulas que funcionam no Microsoft Excel funcionam aqui. Após definir fórmulas, chame EvaluateAll() para calcular os resultados. Esta etapa garante que os valores calculados estejam disponíveis imediatamente através de propriedades tipadas como DecimalValue, IntValue, ou StringValue. Sem chamar EvaluateAll(), fórmulas ainda são salvas corretamente e calculadas quando abertas no Excel, mas o acesso programático aos resultados requer avaliação primeiro.

decimal sum = sheet["B2:B5"].Sum();
decimal avg = sheet["B2:B5"].Avg();
decimal max = sheet["B2:B5"].Max();

decimal sum = sheet["B2:B5"].Sum();
decimal avg = sheet["B2:B5"].Avg();
decimal max = sheet["B2:B5"].Max();

Como Exportar Arquivos Excel e Servi-los para Download?

IronXL suporta múltiplos formatos de exportação para atender diferentes requisitos de integração. Além dos formatos padrão do Excel, planilhas podem ser exportadas para CSV para intercâmbio de dados, JSON para aplicações web, ou TSV para compatibilidade com sistemas legados. Essa flexibilidade facilita a integração da geração de Excel em qualquer fluxo de trabalho.

using IronXL;

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

// Export to different formats
workbook.SaveAs("output.xlsx");      // Modern Excel (Office 2007+)
workbook.SaveAs("output.xls");       // Legacy Excel (97-2003)
workbook.SaveAsCsv("output.csv");    // CSV for data import/export
workbook.SaveAsJson("output.json");  // JSON for web APIs

using IronXL;

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

// Export to different formats
workbook.SaveAs("output.xlsx");      // Modern Excel (Office 2007+)
workbook.SaveAs("output.xls");       // Legacy Excel (97-2003)
workbook.SaveAsCsv("output.csv");    // CSV for data import/export
workbook.SaveAsJson("output.json");  // JSON for web APIs

Cada formato atende a casos de uso específicos. XLSX funciona melhor para preservar formatação e fórmulas ao compartilhar com usuários de Excel. CSV oferece compatibilidade máxima para importação em bancos de dados, ferramentas de análise ou outras aplicações de planilhas. JSON se integra naturalmente com frontends JavaScript e APIs REST.

[HttpGet("download-report")]
public IActionResult DownloadReport()
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workbook.CreateWorkSheet("Report");
    sheet["A1"].Value = "Generated Report";
    sheet["A2"].Value = DateTime.Nãow;

    var stream = workbook.ToStream();
    return File(
        stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "Report.xlsx"
    );
}

[HttpGet("download-report")]
public IActionResult DownloadReport()
{
    WorkBook workbook = WorkBook.Create(ExcelFileFormat.XLSX);
    WorkSheet sheet = workbook.CreateWorkSheet("Report");
    sheet["A1"].Value = "Generated Report";
    sheet["A2"].Value = DateTime.Nãow;

    var stream = workbook.ToStream();
    return File(
        stream,
        "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
        "Report.xlsx"
    );
}

Como o IronXL se Compara a Outras Bibliotecas Excel for .NET?

Existem várias bibliotecas para manipulação de Excel em .NET, cada uma com diferentes pontos fortes. A tabela abaixo mostra como eles se comparam nos critérios que mais importam para aplicações de produção:

IronXL se destaca em cenários empresariais que exigem suporte técnico confiável, documentação e atualizações consistentes. A biblioteca lida com casos extremos com elegância -- arquivos corrompidos, fórmulas complexas e grandes conjuntos de dados -- onde alternativas de código aberto podem ter dificuldades. Para equipes que priorizam a velocidade de desenvolvimento e a confiabilidade de produção, o suporte comercial da IronXL proporciona tranquilidade.

De acordo com discussões no Stack Overflow, os desenvolvedores frequentemente citam a simplicidade da API e a qualidade da documentação como fatores decisivos ao escolher bibliotecas Excel para seus projetos .NET Core. A .NET Foundation também enfatiza a implantação multiplataforma como uma prioridade para o desenvolvimento moderno em .NET, tornando bibliotecas independentes do Office essenciais para soluções sustentáveis.

Para equipes preocupadas com segurança: IronXL opera independentemente do Microsoft Office e evita o Office Interop, o que minimiza o risco de vulnerabilidades externas. O suporte embutido para criptografia e proteção por senha permite que você proteja arquivos Excel gerados, garantindo que apenas usuários autorizados possam acessar ou editar planilhas e dados críticos. Revise as opções de licenciamento do IronXL para encontrar o plano que se adapta à sua equipe.

Como você lida com o desempenho em escala?

Quando seu aplicativo gera arquivos Excel para muitos usuários simultâneos ou processa grandes conjuntos de dados, o planejamento de desempenho se torna crítico. IronXL lida com grandes pastas de trabalho de forma eficiente porque opera inteiramente na memória sem gerar processos do Office ou objetos COM. Essa arquitetura mantém o uso de CPU e memória previsíveis.

Quais são os seus próximos passos?

Criar planilhas Excel .NET Core com IronXL transforma o que antes era uma tarefa com muitas dependências em uma operação .NET simples. Desde a manipulação básica de células até cálculos de fórmulas e formatação profissional, a biblioteca oferece um kit completo para automação de planilhas que roda em qualquer lugar onde o .NET 10 for executado -- servidores Windows, contêineres Linux ou plataformas na nuvem.

A arquitetura multiplataforma garante comportamento idêntico entre maquinas de desenvolvimento e ambientes de produção, eliminando problemas do tipo "funciona na minha máquina" comuns com soluções de Interop do Office. Comece com o comando de instalação do NuGet, crie sua primeira pasta de trabalho e progrida com base nos padrões mostrados ao longo deste guia.

Baixe uma avaliação gratuita de 30 dias para explorar todos os recursos sem limitações, ou veja as opções de licenciamento para a implantação em produção. Navegue nos exemplos de código do IronXL para ver cenários adicionais em ação, e consulte o hub de documentação do IronXL para a referência completa da API e guias de configuração avançados.